- <para>The <literal>ghc-pkg</literal> program may be run in the following
- ways. Where a package name is required, the package can be named either
- in full including the version number
+ <para>Commands which only inspect the database (<literal>list</literal>,
+ <literal>describe</literal>, <literal>field</literal>) will take into
+ account the user's local package database too, unless the
+ <literal>--global</literal> option is given. This matches the behaviour
+ of GHC, which automatically reads the user's local database if it is
+ available.</para>
+
+ <para>The <literal>ghc-pkg</literal> program may be run in the ways listed
+ below. Where a package name is required, the package can be named in
+ full including the version number