summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEdward Z. Yang <ezyang@cs.stanford.edu>2014-07-27 00:19:28 +0100
committerEdward Z. Yang <ezyang@cs.stanford.edu>2014-07-28 03:16:00 -0700
commitba00258bfb2dd5108ccc353d5dbeefc748dd5235 (patch)
treeaee743b54c9dc3f22dd1e50ba9064c797f714a9f /docs
parent57ed4101687651ba3de59fb75355f4b83ffdca75 (diff)
downloadhaskell-ba00258bfb2dd5108ccc353d5dbeefc748dd5235.tar.gz
Support ghc-pkg --ipid to query package ID.
Summary: Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu> Test Plan: validate Reviewers: hvr, simonmar, austin Subscribers: simonmar, relrod, carter Differential Revision: https://phabricator.haskell.org/D98
Diffstat (limited to 'docs')
-rw-r--r--docs/users_guide/packages.xml22
1 files changed, 21 insertions, 1 deletions
diff --git a/docs/users_guide/packages.xml b/docs/users_guide/packages.xml
index 3f2dd97aa5..0e207171d8 100644
--- a/docs/users_guide/packages.xml
+++ b/docs/users_guide/packages.xml
@@ -691,7 +691,9 @@ haskell98-1.0.1.0
package; the specified action will be applied to all the matching
packages. A package specifier that matches all version of the package
can also be written <replaceable>pkg</replaceable><literal>-*</literal>,
- to make it clearer that multiple packages are being matched.</para>
+ to make it clearer that multiple packages are being matched. To match
+ against the package ID instead of just package name and version,
+ pass the <option>--ipid</option> flag.</para>
<variablelist>
<varlistentry>
@@ -1049,6 +1051,24 @@ ghc-pkg dot | tred | dot -Tpdf >pkgs.pdf
</varlistentry>
</variablelist>
+ <varlistentry>
+ <term>
+ <option>--ipid</option>
+ <indexterm><primary>
+ <option>--ipid</option>
+ </primary></indexterm>
+ </term>
+ <listitem>
+ <para>Causes <literal>ghc-pkg</literal> to interpret arguments
+ as package IDs (e.g., an identifier like
+ <literal>unix-2.3.1.0-de7803f1a8cd88d2161b29b083c94240
+ </literal>). This is useful if providing just the package
+ name and version are ambiguous (in old versions of GHC, this
+ was guaranteed to be unique, but this invariant no longer
+ necessarily holds).</para>
+ </listitem>
+ </varlistentry>
+
</sect2>
<sect2 id="building-packages">