[[project @ 2001-07-16 12:46:04 by simonpj]
simonpj**20010716124604
 Fix markup bugs; add documentation about deprecations
] {
hunk ./ghc/docs/users_guide/glasgow_exts.sgml 101
-	<para>See <xref LinkEnd="nullary types">.</para>
+	<para>See <xref LinkEnd="nullary-types">.</para>
hunk ./ghc/docs/users_guide/glasgow_exts.sgml 425
-<sect1 id="nullary types">
+<sect1 id="nullary-types">
hunk ./ghc/docs/users_guide/glasgow_exts.sgml 428
-<para>With the <option>-fglasgow-exts</options> flag, GHC lets you declare
+<para>With the <option>-fglasgow-exts</option> flag, GHC lets you declare
hunk ./ghc/docs/users_guide/glasgow_exts.sgml 2754
+</sect2>
+
+<sect2 id="deprecated-pragma">
+<title>DEPRECATED pragma</title>
+
+<para>
+The DEPRECATED pragma lets you specify that a particular function, class, or type, is deprecated.  
+There are two forms.  
+</para>
+<itemizedlist>
+<listitem><para>
+You can deprecate an entire module thus:</para>
+<programlisting>
+   module Wibble {-# DEPRECATED "Use Wobble instead" #-} where
+     ...
+</programlisting>
+<para>
+When you compile any module that import <literal>Wibble</literal>, GHC will print
+the specified message.</para>
+</listitem>
+
+<listitem>
+<para>
+You can deprecate a function, class, or type, with the following top-level declaration:
+</para>
+<programlisting>
+   {-# DEPRECATED f, C, T "Don't use these" #-}
+</programlisting>
+<para>
+When you compile any module that imports and uses any of the specifed entities, 
+GHC will print the specified message.
+</para>
+</listitem>
+</itemizedlist>
+<para>You can suppress the warnings with the flag <option>-fno-warn-deprecations</option>.</para>
+
hunk ./ghc/docs/users_guide/installing.sgml 20
-<listitem> Installing on Unix-a-likes (<Xref LinkEnd="sec-unix-a-likes">).  </listitem>
-<listitem> Installing on Windows  (<Xref LinkEnd="sec-install-windows">).  </listitem>
-<listitem> The layout of installed files  (<Xref LinkEnd="sec-install-files">).  
+<listitem> <para> Installing on Unix-a-likes (<Xref LinkEnd="sec-unix-a-likes">). </para>  </listitem>
+<listitem> <para> Installing on Windows  (<Xref LinkEnd="sec-install-windows">).   </para> </listitem>
+<listitem> <para> The layout of installed files  (<Xref LinkEnd="sec-install-files">).  
hunk ./ghc/docs/users_guide/installing.sgml 24
-but it's useful if you are changing the implementation.   </listitem>
-<listitem> Installing or building the documentation (<Xref LinkEnd="building-docs">). </listitem>
+but it's useful if you are changing the implementation.   </para>  </listitem>
+<listitem> <para> Installing or building the documentation (<Xref LinkEnd="building-docs">).  </para> </listitem>
hunk ./ghc/docs/users_guide/installing.sgml 671
-<Sect1 id="sec-install-files><Title>The layout of installed files</Title>
+<Sect1 id="sec-install-files"><Title>The layout of installed files</Title>
hunk ./ghc/docs/users_guide/installing.sgml 682
-<listitem> known as <Filename>$(bindir)</Filename>, holds executables that 
+<listitem> <para> known as <Filename>$(bindir)</Filename>, holds executables that 
hunk ./ghc/docs/users_guide/installing.sgml 687
+</para>
hunk ./ghc/docs/users_guide/installing.sgml 692
-<listitem> known as <Filename>$(libdir)</Filename>, holds all the 
+<listitem> <para> known as <Filename>$(libdir)</Filename>, holds all the 
hunk ./ghc/docs/users_guide/installing.sgml 694
-directory is usually something like <Filename>/usr/lib/ghc/ghc-5.02</Filename>.
+directory is usually something like <Filename>/usr/lib/ghc/ghc-5.02</Filename>. </para>
hunk ./ghc/docs/users_guide/installing.sgml 696
+</varlistentry>
hunk ./ghc/docs/users_guide/installing.sgml 705
+<para>
hunk ./ghc/docs/users_guide/installing.sgml 712
-
+</para>
hunk ./ghc/docs/users_guide/installing.sgml 715
-On Windows (but not Unix), if no <option>-B</option> flag is given, GHC uses a system
+<para> On Windows (but not Unix), if no <option>-B</option> flag is given, GHC uses a system
hunk ./ghc/docs/users_guide/installing.sgml 718
+</para>
hunk ./ghc/docs/users_guide/installing.sgml 826
-<filename>$(libdir)/extra-bin/perl</filename>
-directly,
+<filename>$(libdir)/extra-bin/perl</filename> directly,
hunk ./ghc/docs/users_guide/installing.sgml 831
-
-</itemizelist>
+</itemizedlist>
}