X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2Fusing.xml;h=cc4f36639ab38703ee51cd63de82a463bb0ead98;hb=79d7a7c0d17b51dfb2bb06d758b6e556550862ba;hp=ffe639c507befa110a46da089790ab9c47a15249;hpb=beeecedc85ef566031cc49ae7a370ab44f83bbbd;p=ghc-hetmet.git

diff --git a/ghc/docs/users_guide/using.xml b/ghc/docs/users_guide/using.xml
index ffe639c..cc4f366 100644
--- a/ghc/docs/users_guide/using.xml
+++ b/ghc/docs/users_guide/using.xml
@@ -835,6 +835,33 @@ g [] = 2
       </varlistentry>
 
       <varlistentry>
+	<term><option>-fwarn-incomplete-record-updates</option>:</term>
+	<listitem>
+	  <indexterm><primary><option>-fwarn-incomplete-record-updates</option></primary></indexterm>
+	  <indexterm><primary>incomplete record updates, warning</primary></indexterm>
+	  <indexterm><primary>record updates, incomplete</primary></indexterm>
+
+	  <para>The function
+          <function>f</function> below will fail when applied to
+          <literal>Bar</literal>, so the compiler will emit a warning about
+          this when <option>-fwarn-incomplete-record-updates</option> is
+          enabled.</para>
+
+<programlisting>
+data Foo = Foo { x :: Int }
+         | Bar
+
+f :: Foo -> Foo
+f foo = foo { x = 6 }
+</programlisting>
+
+	  <para>This option isn't enabled be default because it can be
+          very noisy, and it often doesn't indicate a bug in the
+          program.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
 	<term>
           <option>-fwarn-misc</option>:
           <indexterm><primary><option>-fwarn-misc</option></primary></indexterm>
@@ -1823,7 +1850,7 @@ ordinary Haskell 98, when translated to External Core, uses things like rank-2 t
 
 <!-- Emacs stuff:
      ;;; Local Variables: ***
-     ;;; mode: sgml ***
+     ;;; mode: xml ***
      ;;; sgml-parent-document: ("users_guide.xml" "book" "chapter") ***
      ;;; End: ***
  -->