Miscellaneous fixes and formatting enhancements. #238
Conversation
pep-0261.txt
Outdated
| @@ -74,26 +74,26 @@ user, Python 2.2 will allow the 4-byte implementation as a | |||
| build-time option. Users can choose whether they care about | |||
| wide characters or prefer to preserve memory. | |||
|
|
|||
| The 4-byte option is called ``wide Py_UNICODE``. The 2-byte option | |||
| is called ``narrow Py_UNICODE``. | |||
| The 4-byte option is called "wide ``Py_UNICODE``"". The 2-byte option | |||
There was a problem hiding this comment.
Typo: a double closing quote.
| @@ -102,7 +102,7 @@ belongs, and does not require code to be duplicated. | |||
| Syntax | |||
| ====== | |||
|
|
|||
| The syntax of the while statement:: | |||
| The syntax of the while statement :: | |||
There was a problem hiding this comment.
Does the added space do anything?
There was a problem hiding this comment.
Yes, it removes a colon from rendered text (but still makes following indented text a code block). The original text/plain version didn't have a colon, and this looks correct to me. "The syntax of the while statement ... is extended as follows: ..." (where "..." are code blocks) is a single sentence, and it shouldn't have a colon after "statement".
There was a problem hiding this comment.
Ah, I'm used to seeing that done by putting the :: on its own line.
| @@ -69,7 +69,7 @@ Examples | |||
| ======== | |||
|
|
|||
| Here is an example of an interactive session exhibiting the | |||
| expected behaviour of this feature:: | |||
| expected behaviour of this feature. :: | |||
There was a problem hiding this comment.
No, since there is a space between . and ::, colon not rendered.
But I prefer put :: in own line, as @brettcannon's comment.
There was a problem hiding this comment.
Ah, I see, thanks for clearing that up.
A dot instead of a comma seems like a good replacement. The comma version, at least for me, not so much. I think it would out of place before a code block (while : seems natural).
|
Thank you for your review @brettcannon. |
No description provided.