aboutsummaryrefslogtreecommitdiff
path: root/doc/haddock.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/haddock.sgml')
-rw-r--r--doc/haddock.sgml13
1 files changed, 8 insertions, 5 deletions
diff --git a/doc/haddock.sgml b/doc/haddock.sgml
index 1539126b..72446566 100644
--- a/doc/haddock.sgml
+++ b/doc/haddock.sgml
@@ -550,16 +550,19 @@
which we also need to run the C pre-processor:</para>
<screen>
-$ ghc -cpp -E -D__HADDOCK__ Foo.lhs -o Foo.hs
+$ ghc -cpp -E -optP-P -D__HADDOCK__ Foo.lhs -o Foo.hs
$ haddock -h Foo.hs ...
</screen>
<para>The <option>-E</option> option to GHC says "stop after
- pre-processing", the <option>-cpp</option> turns on the C
- pre-processor, and the <option>-D__HADDOCK__</option> option
+ pre-processing", the <option>-cpp</option> option turns on the C
+ pre-processor, the <option>-optP-P</option> option tells the C
+ pre-processor not to leave any extra dropping behind (see the
+ description of the <option>-P</option> option in the gcc manual
+ for details), and the <option>-D__HADDOCK__</option> option
defines the symbol <literal>__HADDOCK__</literal> when
- pre-processing (this is sometimes handy if you need to
- any pre-processing conditionals in your source which depend on
+ pre-processing (this is sometimes handy if you need to any
+ pre-processing conditionals in your source which depend on
whether the source is going to be fed to Haddock).</para>
</section>