summaryrefslogtreecommitdiffstats
path: root/Doc/library/compileall.rst
diff options
context:
space:
mode:
authorBenjamin Peterson <benjamin@python.org>2014-08-19 21:13:26 (GMT)
committerBenjamin Peterson <benjamin@python.org>2014-08-19 21:13:26 (GMT)
commit344ff4ab2b68dee327fb36ee4fe01124466e49d6 (patch)
treeb7f5bedd0568b5eef6812cac94d0d56ecc2c1258 /Doc/library/compileall.rst
parent54b3b3fb2cb54e25901710b98b8d7b13d5f3b01e (diff)
downloadcpython-344ff4ab2b68dee327fb36ee4fe01124466e49d6.zip
cpython-344ff4ab2b68dee327fb36ee4fe01124466e49d6.tar.gz
cpython-344ff4ab2b68dee327fb36ee4fe01124466e49d6.tar.bz2
allow recursion depth to be specified (closes #19628)
Patch from Claudiu Popa.
Diffstat (limited to 'Doc/library/compileall.rst')
-rw-r--r--Doc/library/compileall.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/Doc/library/compileall.rst b/Doc/library/compileall.rst
index 41e9e1b..104f33a 100644
--- a/Doc/library/compileall.rst
+++ b/Doc/library/compileall.rst
@@ -66,9 +66,20 @@ compile Python sources.
is to write files to their :pep:`3147` locations and names, which allows
byte-code files from multiple versions of Python to coexist.
+.. cmdoption:: -r
+
+ Control the maximum recursion level for subdirectories.
+ If this is given, then ``-l`` option will not be taken into account.
+ :program:`python -m compileall <directory> -r 0` is equivalent to
+ :program:`python -m compileall <directory> -l`.
+
+
.. versionchanged:: 3.2
Added the ``-i``, ``-b`` and ``-h`` options.
+.. versionchanged:: 3.5
+ Added the ``-r`` option.
+
There is no command-line option to control the optimization level used by the
:func:`compile` function, because the Python interpreter itself already
provides the option: :program:`python -O -m compileall`.