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

document how to disable fixers

Browse source
This commit is contained in:
Benjamin Peterson 2008-10-13 21:51:40 +00:00
parent eba774b486
commit 0ecbccad2d
1 changed files with 10 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

16
Doc/library/2to3.rst
View file

@ -53,13 +53,17 @@ After transformation, :file:`example.py` looks like this::
Comments and and exact indentation are preserved throughout the translation Comments and and exact indentation are preserved throughout the translation
process. process.
By default, 2to3 runs a set of predefined fixers. The :option:`-l` flag By default, 2to3 runs a set of predefined fixers. The :option:`-l` flag lists
lists all avaible fixers. An explicit set of fixers to run can be given by use all avaible fixers. An explicit set of fixers to run can be given with
of the :option:`-f` flag. The following example runs only the ``imports`` and :option:`-f`. Likewise the :option:`-x` explicitly disables a fixer. The
``has_key`` fixers:: following example runs only the ``imports`` and ``has_key`` fixers::
$ 2to3 -f imports -f has_key example.py $ 2to3 -f imports -f has_key example.py
This command runs every fixer except the ``apply`` fixer::
$ 2to3 -x apply example.py
Some fixers are *explicit*, meaning they aren't run be default and must be Some fixers are *explicit*, meaning they aren't run be default and must be
listed on the command line to be run. Here, in addition to the default fixers, listed on the command line to be run. Here, in addition to the default fixers,
the ``idioms`` fixer is run:: the ``idioms`` fixer is run::
@ -78,8 +82,8 @@ flag. Note that *only* doctests will be refactored. This also doesn't require
the module to be valid Python. For example, doctest like examples in a reST the module to be valid Python. For example, doctest like examples in a reST
document could also be refactored with this option. document could also be refactored with this option.
The :option:`-v` option enables the output of more information on the The :option:`-v` option enables output of more information on the translation
translation process. process.
When the :option:`-p` is passed, 2to3 treats ``print`` as a function instead of When the :option:`-p` is passed, 2to3 treats ``print`` as a function instead of
a statement. This is useful when ``from __future__ import print_function`` is a statement. This is useful when ``from __future__ import print_function`` is