summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorH. Peter Anvin <hpa@zytor.com>2008-10-29 18:14:03 -0700
committerH. Peter Anvin <hpa@zytor.com>2008-10-29 20:47:25 -0700
commitd37e5232b4a93e9327a90aec114628249a375f81 (patch)
tree2bb492ee9a73a5407ee1b0e932844970e78d2531
parent32f58028dab2aebfcf201f0daba4d26c0c1d1dee (diff)
downloadnasm-d37e5232b4a93e9327a90aec114628249a375f81.tar.gz
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>
-rw-r--r--doc/changes.src8
-rw-r--r--doc/nasmdoc.src13
2 files changed, 20 insertions, 1 deletions
diff --git a/doc/changes.src b/doc/changes.src
index 2fce8c15..942eee51 100644
--- a/doc/changes.src
+++ b/doc/changes.src
@@ -275,6 +275,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 326ab412..657490be 100644
--- 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