Add macOS to CLOCK_MONOTONIC_RAW description because it is already available since 10.12.

Ronald, Ned: What is the macOS version used to build Python binaries distributed on python.org? Do we get the constant on macOS 10.12 if binaries are built on macOS 10.11 for example?

I guess that people building Python from source like hombrew will get the constant.

Joannah: Can you please convert attached patch into a pull request? Please mention Ricardo Fraile as co-author of the change (mention his name in the commit message). Such change doesn't need to be mentioned in the changelog (no NEWS entry needed).

@vstinner I have created the PR for this.

@Ricardo: Can you please give you email address? It's to credit you in the commit message. (You don't have to, it's up to you to share it or not :-))

@vstinner here you have rfraile@rfraile.eu :)

@Ricardo, Thanks, commit message updated.

New changeset fd7d539be3ce1cc098a4f104b7a7816ca00add16 by Victor Stinner (Joannah Nanjekye) in branch 'master':
bpo-35716: Update time.CLOCK_MONOTONIC_RAW doc (GH-11517)
https://github.com/python/cpython/commit/fd7d539be3ce1cc098a4f104b7a7816ca00add16

New changeset 8a5b1aa98f97923c39734b508aead152a5a1c911 by Miss Islington (bot) in branch '3.7':
bpo-35716: Update time.CLOCK_MONOTONIC_RAW doc (GH-11517)
https://github.com/python/cpython/commit/8a5b1aa98f97923c39734b508aead152a5a1c911

Thanks Joannah Nanjekye for the PR. I rewrote the commit message to format properly the co-authored-by tag. The doc has been updated in 3.7 and master.

Ricardo Fraile: *Please*. Don't use this clock :-) It must not be used except if you really understand well what you are doing :-)

https://www.python.org/dev/peps/pep-0418/#clock-monotonic-clock-monotonic-raw-clock-boottime

Victor, the binaries are build on the macOS version mentioned in the download. That is, the modern 64-bit installers are build on macOS 10.9 with the 10.9 SDK, the older 32/64-bit intel installers are build on macOS 10.6 with the 10.6 SDK.

With some work it should be possible to build the 64-bit installer on newer macOS releases, but that requires some work to ensure the code deals well with weakly linked symbols.  I've added such support in the past for older macOS releases, so this is definitely doable.  I'd love to work on this, but don't know when I'll have time to do so.

BTW. I'm pretty sure there's an issue about this, but cannot find it at the moment.