[Python-checkins] bpo-33766: Document that end of file or string is a newline (GH-7383)
Terry Jan Reedy
webhook-mailer at python.org
Sat Jun 9 19:49:43 EDT 2018
https://github.com/python/cpython/commit/0aa17ee6a76df0946d42e7657a501f1862065a22
commit: 0aa17ee6a76df0946d42e7657a501f1862065a22
branch: master
author: Ammar Askar <ammar_askar at hotmail.com>
committer: Terry Jan Reedy <tjreedy at udel.edu>
date: 2018-06-09T19:49:39-04:00
summary:
bpo-33766: Document that end of file or string is a newline (GH-7383)
files:
M Doc/reference/lexical_analysis.rst
diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst
index 1fe1a51a9c7b..84e8c783838b 100644
--- a/Doc/reference/lexical_analysis.rst
+++ b/Doc/reference/lexical_analysis.rst
@@ -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,
More information about the Python-checkins
mailing list