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 /doc | |
| parent | 0c906c379dc5bd1ae4d4b577406e3ae3e2702acc (diff) | |
documentation for qualification
Diffstat (limited to 'doc')
| -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> | 
