doc: retroactively document updates to the warning options

Retroactively document the following changes to the warning options:

  - gcc-like syntax (-Wfoo, -Wno-foo)
  - "all" alias
  - "error" metawarning

Added in 2.00rc1 but never documented.

Signed-off-by: H. Peter Anvin <hpa@zytor.com>

diff --git a/doc/changes.src b/doc/changes.src
index d32aaf551804b8e8650b3e7ed0979cfc3a6c824c..02446df31b8b7289b5ae0f085c85b95e899ab039 100644 (file)
--- a/doc/changes.src
+++ b/doc/changes.src
@@ -288,6 +288,14 @@ creation.
 
 \b Significant performance improvements.
 
+\b \c{-w+warning} and \c{-w-warning} can now be written as -Wwarning and
+ -Wno-warning, respectively.  See \k{opt-w}.
+
+\b Add \c{-w+error} to treat warnings as errors.  See \k{opt-w}.
+
+\b Add \c{-w+all} and \c{-w-all} to enable or disable all suppressible
+ warnings.  See \k{opt-w}.
+
 
 \H{cl-0.98.xx} NASM 0.98 Series
 

diff --git a/doc/nasmdoc.src b/doc/nasmdoc.src
index a0adbed0058849f8cae356f0740c29275be5db09..a23612509ef15b2c6c963afd98542f0ac633bb56 100644 (file)
--- a/doc/nasmdoc.src
+++ b/doc/nasmdoc.src
@@ -38,6 +38,7 @@
 \IR{-s} \c{-s} option
 \IR{-u} \c{-u} option
 \IR{-v} \c{-v} option
+\IR{-W} \c{-W} option
 \IR{-w} \c{-w} option
 \IR{-y} \c{-y} option
 \IR{-Z} \c{-Z} option
@@ -830,7 +831,7 @@ the instruction.
 \c{else}, \c{endif}, \c{if}, \c{ifdef}, \c{ifdifi}, \c{ifndef},
 \c{include}, \c{local})
 
-\S{opt-w} The \i\c{-w} Option: Enable or Disable Assembly \i{Warnings}
+\S{opt-w} The \i\c{-w} and \i\c{-W} Options: Enable or Disable Assembly \i{Warnings}
 
 NASM can observe many conditions during the course of assembly which
 are worth mentioning to the user, but not a sufficiently severe
@@ -892,12 +893,22 @@ Enabled by default.
 \b \i\c{user} controls \c{%warning} directives (see \k{pperror}).
 Enabled by default.
 
+\b \i\c{error} causes warnings to be treated as errors.  Disabled by
+default.
+
+\b \i\c{all} is an alias for \e{all} suppressible warning classes (not
+including \c{error}).  Thus, \c{-w+all} enables all available warnings.
+
 In addition, you can set warning classes across sections.
 Warning classes may be enabled with \i\c{[warning +warning-name]},
 disabled with \i\c{[warning -warning-name]} or reset to their
 original value with \i\c{[warning *warning-name]}. No "user form"
 (without the brackets) exists.
 
+Since version 2.00, NASM has also supported the gcc-like syntax
+\c{-Wwarning} and \c{-Wno-warning} instead of \c{-w+warning} and
+\c{-w-warning}, respectively.
+
 
 \S{opt-v} The \i\c{-v} Option: Display \i{Version} Info