Update RGBDS master documentation

Author: GitHub Action

docs/gbz80.7.pdf

@@ -384,10 +384,10 @@ <h2 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOS
   <dt id="Wpurge="><a class="permalink" href="#Wpurge="><code class="Fl">-Wpurge=</code></a></dt>
   <dd>Warn when purging symbols which are likely to have been necessary.
       <code class="Fl">-Wpurge=0</code> or <code class="Fl">-Wno-purge</code>
-      disables this warning. <code class="Fl">-Wpurge=1</code> or just
-      <code class="Fl">-Wpurge</code> warns when purging any exported symbol
-      (regardless of type). <code class="Fl">-Wpurge=2</code> also warns when
-      purging any label (even if not exported).</dd>
+      disables this warning. <code class="Fl">-Wpurge=1</code> warns when
+      purging any exported symbol (regardless of type).
+      <code class="Fl">-Wpurge=2</code> or just <code class="Fl">-Wpurge</code>
+      also warns when purging any label (even if not exported).</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.</dd>
@@ -397,11 +397,11 @@ <h2 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOS
   <dd>Warn when an implicit truncation (for example, <code class="Ic">db</code>
       to an 8-bit value) loses some bits. <code class="Fl">-Wtruncation=0</code>
       or <code class="Fl">-Wno-truncation</code> disables this warning.
-      <code class="Fl">-Wtruncation=1</code> warns when an N-bit value is 2**N
-      or greater, or less than -2**N. <code class="Fl">-Wtruncation=2</code> or
-      just <code class="Fl">-Wtruncation</code> also warns when an N-bit value
-      is less than -2**(N-1), which will not fit in two's complement
-    encoding.</dd>
+      <code class="Fl">-Wtruncation=1</code> or just
+      <code class="Fl">-Wtruncation</code> warns when an N-bit value is 2**N or
+      greater, or less than -2**N. <code class="Fl">-Wtruncation=2</code> also
+      warns when an N-bit value is less than -2**(N-1), which will not fit in
+      two's complement encoding.</dd>
   <dt id="Wunmapped-char="><a class="permalink" href="#Wunmapped-char="><code class="Fl">-Wunmapped-char=</code></a></dt>
   <dd>Warn when a character goes through charmap conversion but has no defined
       mapping. <code class="Fl">-Wunmapped-char=0</code> or

docs/rgbasm-old.5.pdf

@@ -1922,17 +1922,23 @@ <h3 class="Ss" id="Exporting_and_importing_symbols"><a class="permalink" href="#
 <h3 class="Ss" id="Purging_symbols"><a class="permalink" href="#Purging_symbols">Purging
   symbols</a></h3>
 <p class="Pp"><code class="Ic">PURGE</code> allows you to completely remove a
-    symbol from the symbol table, as if it had never been defined. Be
-    <a class="permalink" href="#very"><i class="Em" id="very">very</i></a>
-    careful when purging symbols, especially labels, because it could result in
-    unpredictable errors if something depends on the missing symbol (for
-    example, expressions the linker needs to calculate).</p>
+    symbol from the symbol table, as if it had never been defined.</p>
 <div class="Bd Pp Bd-indent Li">
-<pre>DEF Kamikaze EQUS &quot;I don't want to live anymore&quot;
-AOLer: DB &quot;Me too lol&quot;
-PURGE Kamikaze, AOLer
-ASSERT !DEF(Kamikaze) &amp;&amp; !DEF(AOLer)</pre>
+<pre>DEF value EQU 42
+PURGE value
+DEF value EQUS &quot;I'm a string now&quot;
+ASSERT DEF(value)
+PURGE value
+ASSERT !DEF(value)</pre>
 </div>
+<p class="Pp" id="very">Be
+    <a class="permalink" href="#very"><i class="Em">very</i></a> careful when
+    purging symbols that have been referenced in section data, or that have been
+    exported, because it could result in unpredictable errors if something
+    depends on the missing symbol (for example, expressions the linker needs to
+    calculate). Purging labels at all is
+    <a class="permalink" href="#not"><i class="Em" id="not">not</i></a>
+    recommended.</p>
 <p class="Pp">String constants are not expanded within the symbol names.</p>
 </section>
 <section class="Ss">