aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authortob.brandt <tob.brandt@gmail.com>2010-11-23 23:35:11 +0000
committertob.brandt <tob.brandt@gmail.com>2010-11-23 23:35:11 +0000
commitb220bbfd2ec08e83dba00dbc2d1cef7b879c13e4 (patch)
treeca589138dc8e5b2526a9a07277f78c2a0b121f1d
parent0c906c379dc5bd1ae4d4b577406e3ae3e2702acc (diff)
documentation for qualification
-rw-r--r--doc/haddock.xml55
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/haddock.xml b/doc/haddock.xml
index 806e50e7..461d01d3 100644
--- a/doc/haddock.xml
+++ b/doc/haddock.xml
@@ -788,6 +788,61 @@ $ pdflatex <replaceable>package</replaceable>.tex</screen>
<varlistentry>
<term>
+ <indexterm><primary><option>-q</option></primary></indexterm>
+ <option>-q</option> <replaceable>mode</replaceable>
+ </term>
+ <term>
+ <indexterm><primary><option>--qual</option></primary></indexterm>
+ <option>--qual</option>=<replaceable>mode</replaceable>
+ </term>
+ <listitem>
+ <para>
+ Specify how identifiers are qualified.
+ </para>
+ <para>
+ <replaceable>mode</replaceable> should be one of
+ <itemizedlist>
+ <listitem>
+ <para>none (default): don't qualify any identifiers</para>
+ </listitem>
+ <listitem>
+ <para>full: always qualify identifiers completely</para>
+ </listitem>
+ <listitem>
+ <para>local: only qualify identifiers that are not part
+ of the module</para>
+ </listitem>
+ <listitem>
+ <para>relative: like local, but strip name of the module
+ from qualifications of identifiers in submodules</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ Example: If you generate documentation for module A, then the
+ identifiers A.x, A.B.y and C.z are qualified as follows.
+ </para>
+ <para>
+ <itemizedlist>
+ <listitem>
+ none: x, y, z
+ </listitem>
+ <listitem>
+ full: A.x, A.B.y, C.z
+ </listitem>
+ <listitem>
+ local: x, A.B.y, C.z
+ </listitem>
+ <listitem>
+ relative: x, B.y, C.z
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
<indexterm><primary><option>-d</option></primary></indexterm>
<option>-d</option>
</term>