diff docs/manual.docbook.sgml @ 563:8c6c3363e18e

Update manual to reflect pragma nolistcode and correct nolist semantics
author William Astle <lost@l-w.ca>
date Fri, 01 Dec 2023 21:16:54 -0700
parents f12c767c363e
children fc072f6cde09
line wrap: on
line diff
--- a/docs/manual.docbook.sgml	Fri Dec 01 21:11:56 2023 -0700
+++ b/docs/manual.docbook.sgml	Fri Dec 01 21:16:54 2023 -0700
@@ -1896,7 +1896,22 @@
 listing.  Also, any symbols defined under this pragma will not show up in
 the symbol list.  This is most useful in include files to avoid spamming the
 assembly listing with dozens, hundreds, or thousands of irrelevant
-symbols.</para>
+symbols. It is important to note that this pragma will not hide lines that
+generate output to the binary.</para>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>nolistcode</term>
+<listitem>
+
+<para>Lines where this pragma is in effect will not appear in the assembly
+listing.  Also, any symbols defined under this pragma will not show up in
+the symbol list.  This is most useful in include files to avoid spamming the
+assembly listing with dozens, hundreds, or thousands of irrelevant
+symbols. Unlike "nolist", this pragma will hide lines that generate output
+to the binary.</para>
 
 </listitem>
 </varlistentry>