[[project @ 2001-03-15 16:16:05 by simonmar]
simonmar**20010315161605
 - document new <command>ghc-pkg</command> tool
 - document <literal>source_dirs</literal> field
] {
hunk ./ghc/docs/users_guide/packages.sgml 18
-    existing GHC installation.</para>
-
-    <sect2 id="listing-packages">
-      <title>Listing the available packages</title>
-      <indexterm><primary>packages</primary>
-	<secondary>listing</secondary></indexterm>
-
-      <para>To see what packages are currently installed, use the
-      <literal>--list-packages</literal> option:</para>
-      <indexterm><primary><literal>--list-packages</literal></primary>
-      </indexterm>
-
-<screen>
-  $ ghc --list-packages
-  gmp, rts, std, lang, concurrent, data, net, posix, text, util
-</screen>
-
-      <para>Note that your GHC installation might have a slightly
-      different set of packages installed.</para>
-
-      <para>The <literal>gmp</literal> and <literal>rts</literal>
-      packages are always present, and represent the multi-precision
-      integer and runtime system libraries respectively.  The
-      <literal>std</literal> package contains the Haskell prelude.
-      The rest of the packages are optional libraries.</para>
-
-    </sect2>
+    existing GHC installation, using the supplied
+    <literal>ghc-pkg</literal><indexterm><primary><literal>ghc-pkg</literal></primary>
+    </indexterm> tool, described in <xref
+    linkend="package-management">.</para>
hunk ./ghc/docs/users_guide/packages.sgml 29
-      to the command line:</para>
+      to the GHC command line:</para>
hunk ./ghc/docs/users_guide/packages.sgml 33
-	  <term><option>-package &lt;lib&gt;</option></term>
-	  <indexterm><primary>-package &lt;lib&gt; option</primary></indexterm>
+	  <term><option>-package <replaceable>lib</replaceable></option></term>
+	  <indexterm><primary>-package <replaceable>lib</replaceable> option</primary></indexterm>
hunk ./ghc/docs/users_guide/packages.sgml 37
-	    package <literal>&lt;lib&gt;</literal> (they still have to
+	    package <literal><replaceable>lib</replaceable></literal> (they still have to
hunk ./ghc/docs/users_guide/packages.sgml 98
-	  <term><option>-package-name &lt;foo&gt;</option></term>
+	  <term><option>-package-name <replaceable>foo</replaceable></option></term>
hunk ./ghc/docs/users_guide/packages.sgml 122
-
hunk ./ghc/docs/users_guide/packages.sgml 123
+
hunk ./ghc/docs/users_guide/packages.sgml 132
-      directly, instead GHC provides options for adding & removing
-      packages:</para>
+      directly, instead packages can be added or removed using GHC's
+      package management tool, <literal>ghc-pkg</literal>.</para>
hunk ./ghc/docs/users_guide/packages.sgml 136
+	<varlistentry>
+	  <term><option>--list-packages</option></term>
+	  <term><option>-l</option></term>
+	  <indexterm><primary><option>--list-packages</option></primary></indexterm>
+	  <listitem>
+	    <para>This option displays the list of currently installed
+	    packages.</para>
+
+<screen>
+  $ ghc-pkg --list-packages
+  gmp, rts, std, lang, concurrent, data, net, posix, text, util
+</screen>
+
+	    <para>Note that your GHC installation might have a
+            slightly different set of packages installed.</para>
+
+	    <para>The <literal>gmp</literal> and
+            <literal>rts</literal> packages are always present, and
+            represent the multi-precision integer and runtime system
+            libraries respectively.  The <literal>std</literal>
+            package contains the Haskell prelude and standard
+            libraries.  The rest of the packages are optional
+            libraries.</para>
+	  </listitem>
+	</varlistentry>
+
hunk ./ghc/docs/users_guide/packages.sgml 164
-	  <indexterm><primary><literal>--add-package</literal></primary>
-	      <secondary>option</secondary></indexterm>
+	  <term><option>-a</option></term>
+	  <indexterm><primary><option>--add-package</option></primary>
+	      </indexterm>
hunk ./ghc/docs/users_guide/packages.sgml 176
-	  <term><option>--delete-package &lt;foo&gt;</option></term>
-	  <indexterm><primary><literal>--delete-package</literal></primary>
-	      <secondary>option</secondary></indexterm>
+	  <term><option>--remove-package <replaceable>foo</replaceable></option></term>
+	  <term><option>-r <replaceable>foo</replaceable></option></term>
+	  <indexterm><primary><option>--delete-package</option></primary>
+	      </indexterm>
hunk ./ghc/docs/users_guide/packages.sgml 199
+     source_dirs     = [],
hunk ./ghc/docs/users_guide/packages.sgml 236
+	</varlistentry>
+
+	<varlistentry>
+	  <term><literal>source_dirs</literal></term>
+	  <indexterm><primary><literal>source_dirs</literal></primary>
+	    <secondary>package specification</secondary></indexterm>
+	  <listitem>
+	    <para>A list of directories containing Haskell source
+	    files for this package.  This field isn't used by GHC, but
+	    could potentially be used by an all-interpreted system
+	    like Hugs.</para>
+	  </listitem>
}