diff options
| author | Cheryl Sabella <cheryl.sabella@gmail.com> | 2018-02-25 03:04:40 (GMT) |
|---|---|---|
| committer | Terry Jan Reedy <tjreedy@udel.edu> | 2018-02-25 03:04:40 (GMT) |
| commit | 186b606d8a2ea4fd51b7286813302c8e8c7006cc (patch) | |
| tree | 0ddf940b844971caa235adf62bc162a931394a51 /Doc | |
| parent | 6cdb7954b0a578d899e4b78b868ea59eef08480a (diff) | |
| download | cpython-186b606d8a2ea4fd51b7286813302c8e8c7006cc.zip cpython-186b606d8a2ea4fd51b7286813302c8e8c7006cc.tar.gz cpython-186b606d8a2ea4fd51b7286813302c8e8c7006cc.tar.bz2 | |
bpo-17232: Clarify docs for -O and -OO command line options (#5839)
The 'optimization' is for space in the executable file, not for run time.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/using/cmdline.rst | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index 1e9ed6e..21ba0b5 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -260,12 +260,23 @@ Miscellaneous options .. cmdoption:: -O - Turn on basic optimizations. See also :envvar:`PYTHONOPTIMIZE`. + Remove assert statements and any code conditional on the value of + :const:`__debug__`. Augment the filename for compiled + (:term:`bytecode`) files by adding ``.opt-1`` before the ``.pyc`` + extension (see :pep:`488`). See also :envvar:`PYTHONOPTIMIZE`. + + .. versionchanged:: 3.5 + Modify ``.pyc`` filenames according to :pep:`488`. .. cmdoption:: -OO - Discard docstrings in addition to the :option:`-O` optimizations. + Do :option:`-O` and also discard docstrings. Augment the filename + for compiled (:term:`bytecode`) files by adding ``.opt-2`` before the + ``.pyc`` extension (see :pep:`488`). + + .. versionchanged:: 3.5 + Modify ``.pyc`` filenames according to :pep:`488`. .. cmdoption:: -q |