Skip to content

Commit dc5277d

Browse files
edschofieldedschofield
committed
Update docs for futurize
1 parent 5a19fa8 commit dc5277d

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

‎docs/source/automatic_conversion.rst‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,3 +98,26 @@ Please report bugs on `GitHub
9898

9999
Contributions to ``futurize`` are particularly welcome! Please see :ref:`contributing`.
100100

101+
102+
.. _futurize-limitations
103+
104+
Known limitations of ``futurize``
105+
---------------------------------
106+
107+
``futurize`` doesn't currently make any of these changes automatically::
108+
109+
1. A source encoding declaration line like::
110+
111+
# -*- coding:utf-8 -*-
112+
113+
is not kept at the top of a file. It must be moved manually back to line 1 to take effect.
114+
115+
1. Strings containing ``\U`` produce a ``SyntaxError`` on Python 3. An example is::
116+
117+
s = 'C:\Users'.
118+
119+
Python 2 expands this to ``s = 'C:\\Users'``, but Python 3 requires a raw
120+
prefix (``r'...'``). This also applies to multi-line strings (including
121+
multi-line docstrings).
122+
123+

0 commit comments

Comments
 (0)