diff options
author | tob.brandt <tob.brandt@gmail.com> | 2010-11-23 23:35:11 +0000 |
---|---|---|
committer | tob.brandt <tob.brandt@gmail.com> | 2010-11-23 23:35:11 +0000 |
commit | b220bbfd2ec08e83dba00dbc2d1cef7b879c13e4 (patch) | |
tree | ca589138dc8e5b2526a9a07277f78c2a0b121f1d | |
parent | 0c906c379dc5bd1ae4d4b577406e3ae3e2702acc (diff) |
documentation for qualification
-rw-r--r-- | doc/haddock.xml | 55 |
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> |