Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

bpo-35716: CLOCK_MONOTONIC_RAW available on macOS #11517

Merged
merged 2 commits into from
Jan 11, 2019

Conversation

nanjekyejoannah
Copy link
Contributor

@nanjekyejoannah nanjekyejoannah commented Jan 11, 2019

Add macOS among supported versions for the CLOCK_MONOTONIC_RAW identifier in the description because it is already available since 10.12.

Co-authored-by: Ricardo Fraile rfraile@rfraile.eu

https://bugs.python.org/issue35716

@@ -772,7 +772,7 @@ These constants are used as parameters for :func:`clock_getres` and
Similar to :data:`CLOCK_MONOTONIC`, but provides access to a raw
hardware-based time that is not subject to NTP adjustments.

Availability: Linux 2.6.28 or later.
Availability: Availability: Linux 2.6.28 or later, macOS 10.12 and newer.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Availability: Availability:" hum, it's written twice :-) While we are here, a new ".. availability::" markup has been added recently.

Can you please replace "Availability:" with ".. availability::"?

I'm not a native english speaker. What's the best: " or later" or " and newer"? os.rst uses "or newer" 3 times, but "and later" is not used. Maybe replace also "Linux 2.6.28 or later" with "Linux 2.6.28 and newer". Ah, os.rst uses "or newer" and "and newer" :-)

-- Victor the nitpicker

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please replace "Availability:" with ".. availability::"?

All "Availability:" in this file, not only this one, please ;-)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vstinner I have seen the use of both "or newer" and "and newer" in the docs. Is this based on semantics or it is just based on preference?

@miss-islington
Copy link
Contributor

Thanks @nanjekyejoannah for the PR, and @vstinner for merging it 🌮🎉.. I'm working now to backport this PR to: 3.7.
🐍🍒⛏🤖

@bedevere-bot
Copy link

GH-11518 is a backport of this pull request to the 3.7 branch.

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Jan 11, 2019
Document that the time.CLOCK_MONOTONIC_RAW constant
is now also available on macOS 10.12.

Co-authored-by: Ricardo Fraile <rfraile@rfraile.eu>
(cherry picked from commit fd7d539)

Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com>
miss-islington added a commit that referenced this pull request Jan 11, 2019
Document that the time.CLOCK_MONOTONIC_RAW constant
is now also available on macOS 10.12.

Co-authored-by: Ricardo Fraile <rfraile@rfraile.eu>
(cherry picked from commit fd7d539)

Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir skip news
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants