diff -r 6fd63f0a0026 Doc/reference/lexical_analysis.rst --- a/Doc/reference/lexical_analysis.rst Fri Jul 03 15:13:48 2015 -0700 +++ b/Doc/reference/lexical_analysis.rst Fri Jul 03 19:25:18 2015 -0400 @@ -81,7 +81,9 @@ If a comment in the first or second line of the Python script matches the regular expression ``coding[=:]\s*([-\w.]+)``, this comment is processed as an encoding declaration; the first group of this expression names the encoding of -the source code file. The recommended forms of this expression are :: +the source code file. The encoding declaration must appear on a line of its +own. If it is the second line, the first line must also be a comment-only line. +The recommended forms of an encoding expression are :: # -*- coding: -*- @@ -98,7 +100,7 @@ If an encoding is declared, the encoding name must be recognized by Python. The encoding is used for all lexical analysis, including string literals, comments -and identifiers. The encoding declaration must appear on a line of its own. +and identifiers. .. XXX there should be a list of supported encodings.