From: simonpj@microsoft.com <unknown>
Date: Tue, 29 Jul 2008 14:52:47 +0000 (+0000)
Subject: Document -dsuppress-uniques
X-Git-Tag: 2008-09-12~343
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=8f0ebee036adfcf86aa73171e17280e45bf1f788;p=ghc-hetmet.git

Document -dsuppress-uniques
---

diff --git a/docs/users_guide/debugging.xml b/docs/users_guide/debugging.xml
index e00cd8f..d6a520a 100644
--- a/docs/users_guide/debugging.xml
+++ b/docs/users_guide/debugging.xml
@@ -423,6 +423,20 @@
 
       <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>
diff --git a/docs/users_guide/flags.xml b/docs/users_guide/flags.xml
index f13d34c..23c1b2b 100644
--- a/docs/users_guide/flags.xml
+++ b/docs/users_guide/flags.xml
@@ -2233,6 +2233,12 @@
 	      <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>