[nasm:nasm-2.16.xx] doc: make it clearer than -O0 and -O1 are almost never useful

[nasm-bot for H. Peter Anvin]

Commit-ID:  99d3342033823588447b8ecc4dfc7776a7740c4b
Gitweb:     http://repo.or.cz/w/nasm.git?a=commitdiff;h=99d3342033823588447b8ecc4dfc7776a7740c4b
Author:     H. Peter Anvin <hpa at zytor.com>
AuthorDate: Fri, 12 Apr 2024 11:08:37 -0700
Committer:  H. Peter Anvin <hpa at zytor.com>
CommitDate: Fri, 12 Apr 2024 11:08:37 -0700

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 <hpa at zytor.com>


---
 doc/nasmdoc.src | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/nasmdoc.src b/doc/nasmdoc.src
index 3eef0aa6..0fcf7d1d 100644
--- a/doc/nasmdoc.src
+++ b/doc/nasmdoc.src
@@ -823,7 +823,10 @@ e.g. \c{-Oxv}.
         actually executed.
 
 The \c{-Ox} mode is recommended for most uses, and is the default
-since NASM 2.09.
+since NASM 2.09. \e{Any other mode will generate worse quality
+output.} Use \c{-O0} or \c{-O1} only if you need the finer
+programmer-level control of output and \c{strict} is not suitable for
+your use case.
 
 Note that this is a capital \c{O}, and is different from a small \c{o}, which
 is used to specify the output file name. See \k{opt-o}.