summaryrefslogtreecommitdiffstats
path: root/Misc/python.man
diff options
context:
space:
mode:
authorCheryl Sabella <cheryl.sabella@gmail.com>2018-02-25 03:04:40 (GMT)
committerTerry Jan Reedy <tjreedy@udel.edu>2018-02-25 03:04:40 (GMT)
commit186b606d8a2ea4fd51b7286813302c8e8c7006cc (patch)
tree0ddf940b844971caa235adf62bc162a931394a51 /Misc/python.man
parent6cdb7954b0a578d899e4b78b868ea59eef08480a (diff)
downloadcpython-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 'Misc/python.man')
-rw-r--r--Misc/python.man7
1 files changed, 5 insertions, 2 deletions
diff --git a/Misc/python.man b/Misc/python.man
index 0f38c5b..a0084f8 100644
--- a/Misc/python.man
+++ b/Misc/python.man
@@ -164,10 +164,13 @@ for the named module and runs the corresponding
file as a script.
.TP
.B \-O
-Turn on basic optimizations. Given twice, causes docstrings to be discarded.
+Remove assert statements and any code conditional on the value of
+__debug__; augment the filename for compiled (bytecode) files by
+adding .opt-1 before the .pyc extension.
.TP
.B \-OO
-Discard docstrings in addition to the \fB-O\fP optimizations.
+Do \fB-O\fP and also discard docstrings; change the filename for
+compiled (bytecode) files by adding .opt-2 before the .pyc extension.
.TP
.B \-q
Do not print the version and copyright messages. These messages are