From cf2edc34e8b124993828a2b6da4126c43afcbf99 Mon Sep 17 00:00:00 2001
From: simonmar <unknown>
Date: Mon, 29 Oct 2001 13:42:52 +0000
Subject: [PATCH] [project @ 2001-10-29 13:42:52 by simonmar] - document
 --print-libdir - replace some <literal>s with <option>s
 where appropriate

---
 ghc/docs/users_guide/flags.sgml |    6 +++
 ghc/docs/users_guide/using.sgml |   84 +++++++++++++++++++++++----------------
 2 files changed, 56 insertions(+), 34 deletions(-)

diff --git a/ghc/docs/users_guide/flags.sgml b/ghc/docs/users_guide/flags.sgml
index 0d6ffba..27f13cc 100644
--- a/ghc/docs/users_guide/flags.sgml
+++ b/ghc/docs/users_guide/flags.sgml
@@ -56,6 +56,12 @@
 	      <entry>static</entry>
 	      <entry>-</entry>
 	    </row>
+	    <row>
+	      <entry><option>--print-libdir</option></entry>
+	      <entry>display GHC library directory</entry>
+	      <entry>static</entry>
+	      <entry>-</entry>
+	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
diff --git a/ghc/docs/users_guide/using.sgml b/ghc/docs/users_guide/using.sgml
index 932f9a6..ea97423 100644
--- a/ghc/docs/users_guide/using.sgml
+++ b/ghc/docs/users_guide/using.sgml
@@ -252,10 +252,10 @@ module X where
 
     <variablelist>
       <varlistentry>
-	<term><literal>--help</literal></term>
-	<term><literal>-?</literal></term>
-	<indexterm><primary><literal>-?</literal></primary></indexterm>
-	<indexterm><primary><literal>--help</literal></primary></indexterm>
+	<term><option>--help</option></term>
+	<term><option>-?</option></term>
+	<indexterm><primary><option>-?</option></primary></indexterm>
+	<indexterm><primary><option>--help</option></primary></indexterm>
 	<listitem>
 	  <para>Cause GHC to spew a long usage message to standard
           output and then exit.</para>
@@ -263,8 +263,8 @@ module X where
       </varlistentry>
 
       <varlistentry>
-	<term><literal>-v</literal></term>
-	<indexterm><primary><literal>-v</literal></primary></indexterm>
+	<term><option>-v</option></term>
+	<indexterm><primary><option>-v</option></primary></indexterm>
 	<listitem>
 	  <para>The <option>-v</option> option makes GHC
           <emphasis>verbose</emphasis>: it reports its version number
@@ -281,7 +281,7 @@ module X where
       </varlistentry>
 	
       <varlistentry>
-	<term><literal>-v</literal><replaceable>n</replaceable></term>
+	<term><option>-v</option><replaceable>n</replaceable></term>
 	<indexterm><primary><option>-v</option></primary></indexterm>
 	<listitem>
 	  <para>To provide more control over the compiler's verbosity,
@@ -292,7 +292,7 @@ module X where
 	  
 	  <variablelist>
 	    <varlistentry>
-	      <term><literal>-v0</literal></term>
+	      <term><option>-v0</option></term>
 	      <listitem>
 		<para>Disable all non-essential messages (this is the
 		default).</para>
@@ -300,7 +300,7 @@ module X where
 	    </varlistentry>
 
 	    <varlistentry>
-	      <term><literal>-v1</literal></term>
+	      <term><option>-v1</option></term>
 	      <listitem>
 		<para>Minimal verbosity: print one line per
 		compilation (this is the default when
@@ -310,7 +310,7 @@ module X where
 	    </varlistentry>
 
 	    <varlistentry>
-	      <term><literal>-v2</literal></term>
+	      <term><option>-v2</option></term>
 	      <listitem>
 		<para>Print the name of each compilation phase as it
 		is executed. (equivalent to
@@ -319,7 +319,7 @@ module X where
 	    </varlistentry>
 
 	    <varlistentry>
-	      <term><literal>-v3</literal></term>
+	      <term><option>-v3</option></term>
 	      <listitem>
 		<para>The same as <option>-v2</option>, except that in
                 addition the full command line (if appropriate) for
@@ -328,7 +328,7 @@ module X where
 	    </varlistentry>
 
 	    <varlistentry>
-	      <term><literal>-v4</literal></term>
+	      <term><option>-v4</option></term>
 	      <listitem>
 		<para>The same as <option>-v3</option> except that the
 		intermediate program representation after each
@@ -341,20 +341,36 @@ module X where
       </varlistentry>
       
       <varlistentry>
-	<term><literal>--version</literal></term>
-	<indexterm><primary><literal>--version</literal></primary></indexterm>
+	<term><option>--version</option></term>
+	<indexterm><primary><option>--version</option></primary></indexterm>
 	<listitem>
 	  <para>Print a one-line string including GHC's version number.</para>
 	</listitem>
       </varlistentry>
 
       <varlistentry>
-	<term><literal>--numeric-version</literal></term>
-	<indexterm><primary><literal>--numeric-version</literal></primary></indexterm>
+	<term><option>--numeric-version</option></term>
+	<indexterm><primary><option>--numeric-version</option></primary></indexterm>
 	<listitem>
 	  <para>Print GHC's numeric version number only.</para>
 	</listitem>
       </varlistentry>
+
+      <varlistentry>
+	<term><option>--print-libdir</option></term>
+	<indexterm><primary><option>--print-libdir</option></primary></indexterm>
+	<listitem>
+	  <para>Print the path to GHC's library directory.  This is
+	  the top of the directory tree containing GHC's libraries,
+	  interfaces, and include files (usually something like
+	  <literal>/usr/local/lib/ghc-5.02</literal> on Unix).  This
+	  is the value of
+	  <literal>$libdir</literal><indexterm><primary><literal>libdir</literal></primary>
+	  </indexterm>in the package configuration file (see <xref
+	  linkend="packages">).</para>
+	</listitem>
+      </varlistentry>
+
     </variablelist>
   </sect1>
 
@@ -538,8 +554,8 @@ ghc --make Main.hs
 
     <variablelist>
       <varlistentry>
-	<term><literal>-o</literal></term>
-	<indexterm><primary><literal>-o</literal></primary></indexterm>
+	<term><option>-o</option></term>
+	<indexterm><primary><option>-o</option></primary></indexterm>
 	<listitem>
 	  <para>GHC's compiled output normally goes into a
           <filename>.hc</filename>, <filename>.o</filename>, etc.,
@@ -556,8 +572,8 @@ ghc --make Main.hs
       </varlistentry>
 
       <varlistentry>
-	<term><literal>-odir</literal></term>
-	<indexterm><primary><literal>-odir</literal></primary></indexterm>
+	<term><option>-odir</option></term>
+	<indexterm><primary><option>-odir</option></primary></indexterm>
 	<listitem>
 	  <para>The <option>-o</option> option isn't of much use if
           you have <emphasis>several</emphasis> input files&hellip;
@@ -676,24 +692,24 @@ ghc --make Main.hs
 
       <variablelist>
 	<varlistentry>
-	  <term><literal>-keep-hc-files</literal></term>
+	  <term><option>-keep-hc-files</option></term>
 	  <indexterm>
-	    <primary><literal>-keep-hc-files</literal></primary>
+	    <primary><option>-keep-hc-files</option></primary>
 	  </indexterm>
 	  <listitem>
 	    <para>Keep intermediate <literal>.hc</literal> files when
 	    doing <literal>.hs</literal>-to-<literal>.o</literal>
 	    compilations via C (NOTE: <literal>.hc</literal> files
 	    aren't generated when using the native code generator, you
-	    may need to use <literal>-fvia-C</literal> to force them
+	    may need to use <option>-fvia-C</option> to force them
 	    to be produced).</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
-	  <term><literal>-keep-s-files</literal></term>
+	  <term><option>-keep-s-files</option></term>
 	  <indexterm>
-	    <primary><literal>-keep-s-files</literal></primary>
+	    <primary><option>-keep-s-files</option></primary>
 	  </indexterm>
 	  <listitem>
 	    <para>Keep intermediate <literal>.s</literal> files.</para>
@@ -701,9 +717,9 @@ ghc --make Main.hs
 	</varlistentry>
 
 	<varlistentry>
-	  <term><literal>-keep-raw-s-files</literal></term>
+	  <term><option>-keep-raw-s-files</option></term>
 	  <indexterm>
-	    <primary><literal>-keep-raw-s-files</literal></primary>
+	    <primary><option>-keep-raw-s-files</option></primary>
 	  </indexterm>
 	  <listitem>
 	    <para>Keep intermediate <literal>.raw-s</literal> files.
@@ -715,9 +731,9 @@ ghc --make Main.hs
 	</varlistentry>
 
 	<varlistentry>
-	  <term><literal>-keep-tmp-files</literal></term>
+	  <term><option>-keep-tmp-files</option></term>
 	  <indexterm>
-	    <primary><literal>-keep-tmp-files</literal></primary>
+	    <primary><option>-keep-tmp-files</option></primary>
 	  </indexterm>
 	  <indexterm>
 	    <primary>temporary files</primary>
@@ -728,7 +744,7 @@ ghc --make Main.hs
 	    temporary files, which it normally keeps in
 	    <literal>/tmp</literal> (or possibly elsewhere; see <xref
 	    linkend="temp-files">).  Running GHC with
-	    <literal>-v</literal> will show you what temporary files
+	    <option>-v</option> will show you what temporary files
 	    were generated along the way.</para>
 	  </listitem>
 	</varlistentry>
@@ -745,8 +761,8 @@ ghc --make Main.hs
 
       <variablelist>
 	<varlistentry>
-	  <term><literal>-tmpdir</literal></term>
-	  <indexterm><primary><literal>-tmpdir</literal></primary></indexterm>
+	  <term><option>-tmpdir</option></term>
+	  <indexterm><primary><option>-tmpdir</option></primary></indexterm>
 	  <listitem>
 	    <para>If you have trouble because of running out of space
             in <filename>/tmp</filename> (or wherever your
@@ -1866,9 +1882,9 @@ statements or clauses.
     <variablelist>
 
   	<varlistentry>
-	  <term><literal>-fext-core</literal></term>
+	  <term><option>-fext-core</option></term>
 	  <indexterm>
-	    <primary><literal>-fext-core</literal></primary>
+	    <primary><option>-fext-core</option></primary>
 	  </indexterm>
 	  <listitem>
 	    <para>Generate <literal>.hcr</literal> files.</para>
-- 
1.7.10.4