]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
gh-107607: Update comment about utf-8 BOM being ignored (#107858)
authorSunghyun Kim <sh@sunghyun.io>
Tue, 19 Mar 2024 15:51:12 +0000 (11:51 -0400)
committerGitHub <noreply@github.com>
Tue, 19 Mar 2024 15:51:12 +0000 (11:51 -0400)
---------
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Doc/reference/lexical_analysis.rst

index f0b3d0a7458cbeb6e3e30d7619bf80dcd53255dd..41ea89fd234122f7ee6ec0509a9a65bbec74f845 100644 (file)
@@ -96,10 +96,9 @@ which is recognized also by GNU Emacs, and ::
 
 which is recognized by Bram Moolenaar's VIM.
 
-If no encoding declaration is found, the default encoding is UTF-8.  In
-addition, if the first bytes of the file are the UTF-8 byte-order mark
-(``b'\xef\xbb\xbf'``), the declared file encoding is UTF-8 (this is supported,
-among others, by Microsoft's :program:`notepad`).
+If no encoding declaration is found, the default encoding is UTF-8.  If the
+implicit or explicit encoding of a file is UTF-8, an initial UTF-8 byte-order
+mark (b'\xef\xbb\xbf') is ignored rather than being a syntax error.
 
 If an encoding is declared, the encoding name must be recognized by Python
 (see :ref:`standard-encodings`). The