[Python-checkins] cpython: Basic documentation for PEP 414

Sun Mar 4 13:35:11 CET 2012

http://hg.python.org/cpython/rev/042e7481c7b4
changeset: 75382:042e7481c7b4
user: Armin Ronacher <armin.ronacher at active-4.com>
date: Sun Mar 04 12:33:51 2012 +0000
summary:
 Basic documentation for PEP 414
files:
 Doc/reference/lexical_analysis.rst | 10 +++++++++-
 1 files changed, 9 insertions(+), 1 deletions(-)

diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst
--- a/Doc/reference/lexical_analysis.rst
+++ b/Doc/reference/lexical_analysis.rst
@@ -401,7 +401,7 @@
 
 .. productionlist::
 stringliteral: [`stringprefix`](`shortstring` | `longstring`)
- stringprefix: "r" | "R"
+ stringprefix: "r" | "u" | "ur" | "R" | "U" | "UR" | "Ur" | "uR"
 shortstring: "'" `shortstringitem`* "'" | '"' `shortstringitem`* '"'
 longstring: "'''" `longstringitem`* "'''" | '"""' `longstringitem`* '"""'
 shortstringitem: `shortstringchar` | `stringescapeseq`
@@ -441,6 +441,9 @@
 may only contain ASCII characters; bytes with a numeric value of 128 or greater
 must be expressed with escapes.
 
+As of Python 3.3 it is possible again to prefix unicode strings with a
+``u`` prefix to simplify maintenance of dual 2.x and 3.x codebases.
+
 Both string and bytes literals may optionally be prefixed with a letter ``'r'``
 or ``'R'``; such strings are called :dfn:`raw strings` and treat backslashes as
 literal characters. As a result, in string literals, ``'\U'`` and ``'\u'``
@@ -450,6 +453,11 @@
 The ``'rb'`` prefix of raw bytes literals has been added as a synonym
 of ``'br'``.
 
+ .. versionadded:: 3.3
+ Support for the unicode legacy literal (``u'value'``) and other
+ versions were reintroduced to simplify the maintenance of dual
+ Python 2.x and 3.x codebases. See :pep:`414` for more information.
+
 In triple-quoted strings, unescaped newlines and quotes are allowed (and are
 retained), except that three unescaped quotes in a row terminate the string. (A
 "quote" is the character used to open the string, i.e. either ``'`` or ``"``.)
-- 
Repository URL: http://hg.python.org/cpython
