mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-25 21:11:09 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

Resolve bug 7847 by including documentation for -J, -U, and -X under "Options

Browse source 
you shouldn't use".
This commit is contained in:
Barry Warsaw 2010-02-05 18:45:25 +00:00
parent bb445a1f22
commit b1e66ee651
2 changed files with 28 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

28
Doc/using/cmdline.rst
View file

@ -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: