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-36722: Style and grammar edits for ABI entry #12979

Merged
merged 1 commit into from Apr 27, 2019

Conversation

pganssle
Copy link
Member

@pganssle pganssle commented Apr 27, 2019

@vstinner expedited the merge for this ABI entry to make sure it's in before the alpha4 release. This is a cleanup PR with my copy edits.

The one thing I wasn't sure about is that I changed the word "define" to "macro" in a few places, referring to preprocessor directives like Py_TRACE_REFS. Macro sounds more right to me than "define", though I did always think there was a qualitative difference between expansion macros and macros you define for #ifdef guards. Anyway, man gcc says "[-Dmacro[=defn]...] [-Umacro], so I think "macro" is correct.

CC: @elprans

https://bugs.python.org/issue36722

Copy link
Member

@vstinner vstinner left a comment

Choose a reason for hiding this comment

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

Oh, I am using the "define" term whereas you are right: I should use the "macro" term.

Would you mind to check if Misc/SpecialBuilds.txt uses the right term?

And maybe also update the NEWS entries of the 3 issues?

@pganssle
Copy link
Member Author

@vstinner Updated. I went with "preprocessor directives" in the SpecialBuilds.txt, since it already said "preprocessor" and I think "preprocessor directive" is the broadest term for these. If you want I can change it to macro.

@vstinner vstinner merged commit 5c403b2 into python:master Apr 27, 2019
@vstinner
Copy link
Member

Thanks Paul!

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.

None yet

4 participants