Skip to content

Commit 99d3342

Browse files
author
H. Peter Anvin
committed
doc: make it clearer than -O0 and -O1 are almost never useful
-Ox is the default, and the preferred mode for almost all users. Signed-off-by: H. Peter Anvin <[email protected]>
1 parent 6f44296 commit 99d3342

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

doc/nasmdoc.src

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -823,7 +823,10 @@ e.g. \c{-Oxv}.
823823
actually executed.
824824

825825
The \c{-Ox} mode is recommended for most uses, and is the default
826-
since NASM 2.09.
826+
since NASM 2.09. \e{Any other mode will generate worse quality
827+
output.} Use \c{-O0} or \c{-O1} only if you need the finer
828+
programmer-level control of output and \c{strict} is not suitable for
829+
your use case.
827830

828831
Note that this is a capital \c{O}, and is different from a small \c{o}, which
829832
is used to specify the output file name. See \k{opt-o}.

0 commit comments

Comments
 (0)