X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=blobdiff_plain;f=docs%2Fusers_guide%2Fpackages.xml;h=0d7a02f25106afb075763d0e36b598f9237f984a;hp=8f8f880237ba5070574d66d1d4dcd50dd2647daf;hb=432b9c9322181a3644083e3c19b7e240d90659e7;hpb=29edb8f84852f3bd5bdb1c859bc469f209262d27

diff --git a/docs/users_guide/packages.xml b/docs/users_guide/packages.xml
index 8f8f880..0d7a02f 100644
--- a/docs/users_guide/packages.xml
+++ b/docs/users_guide/packages.xml
@@ -613,6 +613,10 @@ c:/fptools/validate/ghc/driver/package.conf.inplace:
 	    <literal>InstalledPackageInfo</literal>, the same as the input file
 	    format for <literal>ghc-pkg register</literal>.  See <xref
 	      linkend="installed-pkg-info" /> for details.</para>
+
+          <para>If the pattern matches multiple packages, the
+            description for each package is emitted, separated by the
+            string <literal>---</literal> on a line by itself.</para>
 	</listitem>
       </varlistentry>
 
@@ -624,6 +628,23 @@ c:/fptools/validate/ghc/driver/package.conf.inplace:
       them with commas</para>
 	</listitem>
       </varlistentry>
+
+      <varlistentry>
+        <term><literal>ghc-pkg dump</literal></term>
+        <listitem>
+          <para>Emit the full description of every package, in the
+            form of an <literal>InstalledPackageInfo</literal>.
+            Multiple package descriptions are separated by the
+            string <literal>---</literal> on a line by itself.</para>
+
+          <para>This is almost the same as <literal>ghc-pkg describe '*'</literal>, except that <literal>ghc-pkg dump</literal>
+            is intended for use by tools that parse the results, so
+            for example where <literal>ghc-pkg describe '*'</literal>
+            will emit an error if it can't find any packages that
+            match the pattern, <literal>ghc-pkg dump</literal> will
+            simply emit nothing.</para>
+        </listitem>
+      </varlistentry>
     </variablelist>
 
     <para>