aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCheryl Sabella <cheryl.sabella@gmail.com>2018-02-24 22:04:40 -0500
committerTerry Jan Reedy <tjreedy@udel.edu>2018-02-24 22:04:40 -0500
commit186b606d8a2ea4fd51b7286813302c8e8c7006cc (patch)
tree0ddf940b844971caa235adf62bc162a931394a51 /Misc/python.man
parentbpo-30622: Improve NPN support detection (#5859) (diff)
downloadcpython-186b606d8a2ea4fd51b7286813302c8e8c7006cc.tar.gz
cpython-186b606d8a2ea4fd51b7286813302c8e8c7006cc.tar.bz2
cpython-186b606d8a2ea4fd51b7286813302c8e8c7006cc.zip
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 0f38c5b12ce..a0084f84d04 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