bpo-33766: Document that end of file or string is a newline (GH-7383)

This commit is contained in:
Ammar Askar 2018-06-09 16:49:39 -07:00 committed by Terry Jan Reedy
parent 7e0d882a98
commit 0aa17ee6a7
1 changed files with 6 additions and 5 deletions

View File

@ -47,11 +47,12 @@ Physical lines
--------------
A physical line is a sequence of characters terminated by an end-of-line
sequence. In source files, any of the standard platform line termination
sequences can be used - the Unix form using ASCII LF (linefeed), the Windows
form using the ASCII sequence CR LF (return followed by linefeed), or the old
Macintosh form using the ASCII CR (return) character. All of these forms can be
used equally, regardless of platform.
sequence. In source files and strings, any of the standard platform line
termination sequences can be used - the Unix form using ASCII LF (linefeed),
the Windows form using the ASCII sequence CR LF (return followed by linefeed),
or the old Macintosh form using the ASCII CR (return) character. All of these
forms can be used equally, regardless of platform. The end of input also serves
as an implicit terminator for the final physical line.
When embedding Python, source code strings should be passed to Python APIs using
the standard C conventions for newline characters (the ``\n`` character,