Commit 0ecbccad authored by Benjamin Peterson's avatar Benjamin Peterson

document how to disable fixers

parent eba774b4
...@@ -53,13 +53,17 @@ After transformation, :file:`example.py` looks like this:: ...@@ -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 ...@@ -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
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment