Skip to content

bpo-36722: Style and grammar edits for ABI entry#12979

Merged
vstinner merged 1 commit intopython:masterfrom
pganssle:cleanup-abi-whatsnew
Apr 27, 2019
Merged

bpo-36722: Style and grammar edits for ABI entry#12979
vstinner merged 1 commit intopython:masterfrom
pganssle:cleanup-abi-whatsnew

Conversation

@pganssle
Copy link
Copy Markdown
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
Copy Markdown
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 pganssle force-pushed the cleanup-abi-whatsnew branch from f729a0c to e63b60e Compare April 27, 2019 16:49
@pganssle
Copy link
Copy Markdown
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
Copy Markdown
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.

4 participants