Update RGBDS master documentation

Author: GitHub Action

docs/gbz80.7.pdf

@@ -291,6 +291,13 @@ <h2 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOS
       four characters, since four or fewer characters fit within a 32-bit
       integer. <code class="Fl">-Wnumeric-string=2</code> warns about any
       multi-character string.</dd>
+  <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>
   <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>

docs/rgbasm.1.html

@@ -1623,18 +1623,16 @@ <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 existed.
-    <a class="permalink" href="#USE"><i class="Em" id="USE">USE WITH EXTREME
-    CAUTION</i></a>! I can't stress this enough,
-    <a class="permalink" href="#you"><b class="Sy" id="you">you seriously need
-    to know what you are doing</b></a>. DON'T purge a symbol that you use in
-    expressions the linker needs to calculate. When not sure, it's probably not
-    safe to purge anything other than variables, numeric or string constants, or
-    macros.</p>
+    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>
 <div class="Bd Pp Bd-indent Li">
-<pre>DEF Kamikaze EQUS  &quot;I don't want to live anymore&quot;
-DEF AOLer    EQUS  &quot;Me too&quot;
-         PURGE Kamikaze, AOLer</pre>
+<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>
 </div>
 <p class="Pp">String constants are not expanded within the symbol names.</p>
 </section>