Update RGBDS master documentation

Author: GitHub Action

docs/gbz80.7.pdf

@@ -3,7 +3,7 @@ <h2 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a><
 <table class="Nm">
   <tr>
     <td><code class="Nm">rgbfix</code></td>
-    <td>[<code class="Fl"><a href="#h">-h</a><a href="#j">j</a><a href="#O">O</a><a href="#s">s</a><a href="#V">V</a><a href="#v">v</a></code>] [<code class="Fl"><a href="#C">-C</a></code> |
+    <td>[<code class="Fl"><a href="#h">-h</a><a href="#j">j</a><a href="#O">O</a><a href="#s">s</a><a href="#V">V</a><a href="#v">v</a><a href="#w">w</a></code>] [<code class="Fl"><a href="#C">-C</a></code> |
       <code class="Fl"><a href="#c">-c</a></code>] [<code class="Fl"><a href="#f">-f</a></code>
       <var class="Ar">fix_spec</var>] [<code class="Fl"><a href="#i">-i</a></code>
       <var class="Ar">game_id</var>] [<code class="Fl"><a href="#k">-k</a></code>
@@ -15,7 +15,8 @@ <h2 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a><
       <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="#r">-r</a></code>
       <var class="Ar">ram_size</var>] [<code class="Fl"><a href="#t">-t</a></code>
-      <var class="Ar">title_str</var>] [<var class="Ar">file ...</var>]</td>
+      <var class="Ar">title_str</var>] [<code class="Fl"><a href="#W">-W</a></code>
+      <var class="Ar">warning</var>] [<var class="Ar">file ...</var>]</td>
   </tr>
 </table>
 </section>
@@ -82,8 +83,7 @@ <h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIP
     <var class="Ar">game_id</var></dt>
   <dd>Set the game ID string
       (<span class="Ad">0x13F</span>&#x2013;<span class="Ad">0x142</span>) to a
-      given string. If it's longer than 4 chars, it will be truncated, and a
-      warning emitted.</dd>
+      given string. If it's longer than 4 characters, it will be truncated.</dd>
   <dt id="j"><a class="permalink" href="#j"><code class="Fl">-j</code></a>,
     <code class="Fl">--non-japanese</code></dt>
   <dd>Set the non-Japanese region flag (<span class="Ad">0x14A</span>) to
@@ -93,8 +93,7 @@ <h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIP
     <var class="Ar">licensee_str</var></dt>
   <dd>Set the new licensee string
       (<span class="Ad">0x144</span>&#x2013;<span class="Ad">0x145</span>) to a
-      given string. If it's longer than 2 chars, it will be truncated, and a
-      warning emitted.</dd>
+      given string. If it's longer than 2 characters, it will be truncated.</dd>
   <dt id="L~2"><a class="permalink" href="#L~2"><code class="Fl">-L</code></a>
     <var class="Ar">logo_file</var>, <code class="Fl">--logo</code>
     <var class="Ar">logo_file</var></dt>
@@ -114,7 +113,8 @@ <h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIP
       to 0xFF.
     <p class="Pp">This value may also be an MBC name. The list of accepted names
         can be obtained by passing
-        &#x2018;<code class="Li"><code class="Cm">help</code></code>&#x2019; as
+        &#x2018;<code class="Li"><code class="Cm">help</code></code>&#x2019; or
+        &#x2018;<code class="Li"><code class="Cm">list</code></code>&#x2019; as
         the argument. Any amount of whitespace (space and tabs) is allowed
         around plus signs, and the order of &quot;components&quot; is free, as
         long as the MBC name is first. There are special considerations to take
@@ -128,8 +128,7 @@ <h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIP
       0 to 0xFF.</dd>
   <dt id="O"><a class="permalink" href="#O"><code class="Fl">-O</code></a>,
     <code class="Fl">--overwrite</code></dt>
-  <dd>Allow overwriting different non-zero bytes in the header without a warning
-      being emitted.</dd>
+  <dd>Alias for <code class="Fl">-Wno-overwrite</code>.</dd>
   <dt id="o"><a class="permalink" href="#o"><code class="Fl">-o</code></a>
     <var class="Ar">out_file</var>, <code class="Fl">--output</code>
     <var class="Ar">out_file</var></dt>
@@ -153,25 +152,85 @@ <h2 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIP
   <dt id="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a>,
     <code class="Fl">--sgb-compatible</code></dt>
   <dd>Set the SGB flag (<span class="Ad">0x146</span>) to 0x03. This flag will
-      be ignored by the SGB unless the old licensee code is 0x33! If this is
-      given as well as <code class="Fl">-l</code>, but is not set to 0x33, a
-      warning will be printed.</dd>
+      be ignored by the SGB unless the old licensee code
+      (<code class="Fl">--l</code>) is 0x33!</dd>
   <dt id="t"><a class="permalink" href="#t"><code class="Fl">-t</code></a>
     <var class="Ar">title</var>, <code class="Fl">--title</code>
     <var class="Ar">title</var></dt>
   <dd>Set the title string
       (<span class="Ad">0x134</span>&#x2013;<span class="Ad">0x143</span>) to a
-      given string. If the title is longer than the max length, it will be
-      truncated, and a warning emitted. The max length is 11 characters if the
-      game ID (<code class="Fl">-i</code>) is specified, 15 characters if the
-      CGB flag (<code class="Fl">-c</code> or <code class="Fl">-C</code>) is
-      specified but the game ID is not, and 16 characters otherwise.</dd>
+      given string. If the title is longer than the maximum length, it will be
+      truncated. The max length is 11 characters if the game ID
+      (<code class="Fl">-i</code>) is specified, 15 characters if the CGB flag
+      (<code class="Fl">-c</code> or <code class="Fl">-C</code>) is specified
+      but the game ID is not, and 16 characters otherwise.</dd>
   <dt id="V"><a class="permalink" href="#V"><code class="Fl">-V</code></a>,
     <code class="Fl">--version</code></dt>
   <dd>Print the version of the program and exit.</dd>
   <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a>,
     <code class="Fl">--validate</code></dt>
   <dd>Equivalent to <code class="Fl">-f</code> <code class="Cm">lhg</code>.</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></dt>
+  <dd>Disable all warning output, even when turned into errors.</dd>
+</dl>
+</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 header-fixing 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=overwrite</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">-Wtruncation</code> enables the warning that
+    <code class="Fl">-Wno-truncation</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-mbc"><a class="permalink" href="#Wno-mbc"><code class="Fl">-Wno-mbc</code></a></dt>
+  <dd>Warn when there are inconsistencies with or caveats about the specified
+      MBC type.</dd>
+  <dt id="Wno-overwrite"><a class="permalink" href="#Wno-overwrite"><code class="Fl">-Wno-overwrite</code></a></dt>
+  <dd>Warn when overwriting different non-zero bytes in the header.</dd>
+  <dt id="Wno-sgb"><a class="permalink" href="#Wno-sgb"><code class="Fl">-Wno-sgb</code></a></dt>
+  <dd>Warn when the SGB flag (<code class="Fl">-s</code>) conflicts with the old
+      licensee code (<code class="Fl">-l</code>).</dd>
+  <dt id="Wno-truncation"><a class="permalink" href="#Wno-truncation"><code class="Fl">-Wno-truncation</code></a></dt>
+  <dd>Warn when truncating values to fit the available space.</dd>
 </dl>
 </section>
 <section class="Sh">
@@ -220,8 +279,7 @@ <h3 class="Ss" id="MBC_name"><a class="permalink" href="#MBC_name">MBC
     however, &#x2018;<code class="Li">RAM</code>&#x2019; should not be
     specified, as the TPP1 mapper implicitly requests RAM if a non-zero RAM size
     is specified. Therefore, <code class="Nm">rgbfix</code> will ignore the
-    &#x2018;<code class="Li">RAM</code>&#x2019; feature on a TPP1 mapper with a
-    warning.</p>
+    &#x2018;<code class="Li">RAM</code>&#x2019; feature on a TPP1 mapper.</p>
 </section>
 <section class="Ss">
 <h3 class="Ss" id="Special_considerations"><a class="permalink" href="#Special_considerations">Special

docs/rgbasm-old.5.pdf

@@ -15,6 +15,11 @@ export const toc = [
 	"id": "DESCRIPTION",
 	"level": 2,
 },
+{
+	"value": "DIAGNOSTICS",
+	"id": "DIAGNOSTICS",
+	"level": 2,
+},
 {
 	"value": "EXAMPLES",
 	"id": "EXAMPLES",