diff options
author | Barry Warsaw <barry@python.org> | 2010-02-05 18:45:25 (GMT) |
---|---|---|
committer | Barry Warsaw <barry@python.org> | 2010-02-05 18:45:25 (GMT) |
commit | b1e66ee6510b939ddf8e3f474eabc6284cc27e9d (patch) | |
tree | eba471e406c386cbb0fb5932750f49e540e74d28 /Doc | |
parent | bb445a1f22835b97673f96da8f9edc75b69f5f2c (diff) | |
download | cpython-b1e66ee6510b939ddf8e3f474eabc6284cc27e9d.zip cpython-b1e66ee6510b939ddf8e3f474eabc6284cc27e9d.tar.gz cpython-b1e66ee6510b939ddf8e3f474eabc6284cc27e9d.tar.bz2 |
Resolve bug 7847 by including documentation for -J, -U, and -X under "Options
you shouldn't use".
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/using/cmdline.rst | 28 |
1 files changed, 23 insertions, 5 deletions
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index 03163ce..cd5b8b5 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -285,8 +285,6 @@ Miscellaneous options See also :envvar:`PYTHONUNBUFFERED`. -.. XXX should the -U option be documented? - .. cmdoption:: -v Print a message each time a module is initialized, showing the place @@ -362,9 +360,6 @@ Miscellaneous options .. note:: The line numbers in error messages will be off by one. -.. XXX document -X? - - .. cmdoption:: -3 Warn about Python 3.x incompatibilities which cannot be fixed trivially by @@ -382,7 +377,30 @@ Miscellaneous options .. versionadded:: 2.6 +Options you shouldn't use +~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. cmdoption:: -J + + Reserved for use by Jython_. + +.. _Jython: http://jython.org + +.. cmdoption:: -U + + Turns all string literals into unicodes globally. Do not be tempted to use + this option as it will probably break your world. It also produces + ``.pyc`` files with a different magic number than normal. Instead, you can + enable unicode literals on a per-module basis by using:: + + from __future__ import unicode_literals + + at the top of the file. See :mod:`__future__` for details. + +.. cmdoption:: -X + Reserved for alternative implementations of Python to use for their own + purposes. .. _using-on-envvars: |