Update RGBDS master documentation

Author: GitHub Action

docs/gbz80.7.pdf

@@ -309,8 +309,8 @@ <h2 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOS
       &#x2018;<code class="Li">*/</code>&#x2019; will end the whole
     comment.</dd>
   <dt id="Wno-obsolete"><a class="permalink" href="#Wno-obsolete"><code class="Fl">-Wno-obsolete</code></a></dt>
-  <dd>Warn when obsolete constructs such as the <code class="Ic">_PI</code>
-      constant or <code class="Ic">PRINTT</code> directive are encountered.</dd>
+  <dd>Warn when obsolete features are encountered, which have been deprecated
+      and may later be removed.</dd>
   <dt id="Wnumeric-string="><a class="permalink" href="#Wnumeric-string="><code class="Fl">-Wnumeric-string=</code></a></dt>
   <dd>Warn when a multi-character string is treated as a number.
       <code class="Fl">-Wnumeric-string=0</code> or

docs/rgbasm-old.5.pdf

@@ -10,7 +10,8 @@ <h2 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a><
       <var class="Ar">overlay_file</var>] [<code class="Fl"><a href="#o">-o</a></code>
       <var class="Ar">out_file</var>] [<code class="Fl"><a href="#p">-p</a></code>
       <var class="Ar">pad_value</var>] [<code class="Fl"><a href="#S">-S</a></code>
-      <var class="Ar">spec</var>] <var class="Ar">file ...</var></td>
+      <var class="Ar">spec</var>] [<code class="Fl"><a href="#W">-W</a></code>
+      <var class="Ar">warning</var>] <var class="Ar">file ...</var></td>
   </tr>
 </table>
 </section>
@@ -111,6 +112,13 @@ <h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIP
   <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a>,
     <code class="Fl">--verbose</code></dt>
   <dd>Verbose: enable printing more information to standard error.</dd>
+  <dt id="W"><a class="permalink" href="#W"><code class="Fl">-W</code></a>
+    <var class="Ar">warning</var>, <code class="Fl">--warning</code>
+    <var class="Ar">warning</var></dt>
+  <dd>Set warning flag <var class="Ar">warning</var>. A warning message will be
+      printed if <var class="Ar">warning</var> is an unknown warning flag. See
+      the <a class="Sx" href="#DIAGNOSTICS">DIAGNOSTICS</a> section for a list
+      of warnings.</dd>
   <dt id="w"><a class="permalink" href="#w"><code class="Fl">-w</code></a>,
     <code class="Fl">--wramx</code></dt>
   <dd>Expand the WRAM0 section size from 4 KiB to the full 8 KiB assigned to
@@ -181,6 +189,70 @@ <h3 class="Ss" id="Scrambling_algorithm"><a class="permalink" href="#Scrambling_
 </section>
 </section>
 <section class="Sh">
+<h2 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h2>
+<p class="Pp">Warnings are diagnostic messages that indicate possibly erroneous
+    behavior that does not necessarily compromise the linking process. The
+    following options alter the way warnings are processed.</p>
+<dl class="Bl-tag">
+  <dt id="Werror"><a class="permalink" href="#Werror"><code class="Fl">-Werror</code></a></dt>
+  <dd>Make all warnings into errors. This can be negated as
+      <code class="Fl">-Wno-error</code> to prevent turning all warnings into
+      errors.</dd>
+  <dt id="Werror="><a class="permalink" href="#Werror="><code class="Fl">-Werror=</code></a></dt>
+  <dd>Make the specified warning or meta warning into an error. A warning's name
+      is appended (example: <code class="Fl">-Werror=assert</code>), and this
+      warning is implicitly enabled and turned into an error. This can be
+      negated as <code class="Fl">-Wno-error=</code> to prevent turning a
+      specified warning into an error, even if <code class="Fl">-Werror</code>
+      is in effect.</dd>
+</dl>
+<p class="Pp">The following warnings are &#x201C;meta&#x201D; warnings, that
+    enable a collection of other warnings. If a specific warning is toggled via
+    a meta flag and a specific one, the more specific one takes priority. The
+    position on the command-line acts as a tie breaker, the last one taking
+    effect.</p>
+<dl class="Bl-tag">
+  <dt id="Wall"><a class="permalink" href="#Wall"><code class="Fl">-Wall</code></a></dt>
+  <dd>This enables warnings that are likely to indicate an error or undesired
+      behavior, and that can easily be fixed.</dd>
+  <dt id="Weverything"><a class="permalink" href="#Weverything"><code class="Fl">-Weverything</code></a></dt>
+  <dd>Enables literally every warning.</dd>
+</dl>
+<p class="Pp">The following warnings are actual warning flags; with each
+    description, the corresponding warning flag is included. Note that each of
+    these flag also has a negation (for example,
+    <code class="Fl">-Wobsolete</code> enables the warning that
+    <code class="Fl">-Wno-obsolete</code> disables; and
+    <code class="Fl">-Wall</code> enables every warning that
+    <code class="Fl">-Wno-all</code> disables). Only the non-default flag is
+    listed here. Ignoring the &#x201C;no-&#x201D; prefix, entries are listed
+    alphabetically.</p>
+<dl class="Bl-tag">
+  <dt id="Wno-assert"><a class="permalink" href="#Wno-assert"><code class="Fl">-Wno-assert</code></a></dt>
+  <dd>Warn when <code class="Ic">WARN</code><span class="No">-type</span>
+      assertions fail. (See &#x201C;Aborting the assembly process&#x201D; in
+      <a class="Xr" href="./rgbasm.5">rgbasm(5)</a> for
+      <code class="Ic">ASSERT</code>).</dd>
+  <dt id="Wdiv"><a class="permalink" href="#Wdiv"><code class="Fl">-Wdiv</code></a></dt>
+  <dd>Warn when dividing the smallest negative integer (-2**31) by -1, which
+      yields itself due to integer overflow. This warning is enabled by
+      <code class="Fl">-Wall</code>.</dd>
+  <dt id="Wno-obsolete"><a class="permalink" href="#Wno-obsolete"><code class="Fl">-Wno-obsolete</code></a></dt>
+  <dd>Warn when obsolete features are encountered, which have been deprecated
+      and may later be removed.</dd>
+  <dt id="Wshift"><a class="permalink" href="#Wshift"><code class="Fl">-Wshift</code></a></dt>
+  <dd>Warn when shifting right a negative value. Use a division by 2**N instead.
+      This warning is enabled by <code class="Fl">-Wall</code>.</dd>
+  <dt id="Wshift-amount"><a class="permalink" href="#Wshift-amount"><code class="Fl">-Wshift-amount</code></a></dt>
+  <dd>Warn when a shift's operand is negative or greater than 32. This warning
+      is enabled by <code class="Fl">-Wall</code>.</dd>
+  <dt id="Wno-truncation"><a class="permalink" href="#Wno-truncation"><code class="Fl">-Wno-truncation</code></a></dt>
+  <dd>Warn when an implicit truncation (for example, <code class="Ic">db</code>
+      to an 8-bit value) loses some bits. This occurs when an N-bit value is
+      2**N or greater, or less than -2**N.</dd>
+</dl>
+</section>
+<section class="Sh">
 <h2 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h2>
 <p class="Pp">All you need for a basic ROM is an object file, which can be made
     into a ROM image like so:</p>