Document -dsuppress-uniques
authorsimonpj@microsoft.com <unknown>
Tue, 29 Jul 2008 14:52:47 +0000 (14:52 +0000)
committersimonpj@microsoft.com <unknown>
Tue, 29 Jul 2008 14:52:47 +0000 (14:52 +0000)
docs/users_guide/debugging.xml
docs/users_guide/flags.xml

index e00cd8f..d6a520a 100644 (file)
 
       <varlistentry>
        <term>
+          <option>-dsuppress-uniques</option>
+          <indexterm><primary><option>-dsuppress-uniques</option></primary></indexterm>
+        </term>
+       <listitem>
+         <para>Suppress the printing of uniques in debugging output. This may make 
+         the printout ambiguous (e.g. unclear where an occurrence of 'x' is bound), but
+         it makes the output of two compiler runs have many fewer gratuitous differences,
+           so you can realistically apply <command>diff</command>.  Once <command>diff</command>
+         has shown you where to look, you can try again without <option>-dsuppress-uniques</option></para>
+       </listitem>
+      </varlistentry>
+
+      <varlistentry>
+       <term>
           <option>-dppr-user-length</option>
           <indexterm><primary><option>-dppr-user-length</option></primary></indexterm>
         </term>
index f13d34c..23c1b2b 100644 (file)
              <entry>-</entry>
            </row>
            <row>
+             <entry><option>-dsuppress-uniques</option></entry>
+             <entry>Suppress the printing of uniques in debug output (easier to use <command>diff</command>.</entry>
+             <entry>static</entry>
+             <entry>-</entry>
+           </row>
+           <row>
              <entry><option>-dppr-noprags</option></entry>
              <entry>Don't output pragma info in dumps</entry>
              <entry>static</entry>