haddock (and -- $)

[Johannes Waldmann]

hello. a few comments and questions on haddock (www.haskell.org/haddock/)

1. haddock is great

2. haddock's interpretation of "-- $" is un-great:

I have two types of "-- $" occurences in my code
that conflict with haddock's idea of "named doc chunks"

a. CVS macros: -- $Id: ...$

b. pipes like this, with some lines commented out:

let x = this_function
       $ that_function
       -- $ but_not_this
       $ arg


3. how can I refer to external system libraries documentation
    (i. e. Data.FiniteMap from the ghc web site)?

4. haddock does not seem to understand cpp #ifdefs.
    how can I work around this? (I know I shouldn't use cpp
    in the first place, but I want to document existing code,
    and not rewrite it just to make the doc tool happy :-)


again, haddock is great.
even running it on the code as-is (without any annotations)
gives nice interface documentation, indexing and cross-refs.
-- 
-- Johannes Waldmann,  Tel/Fax: (0341) 3076 6479 / 6480 --
------ http://www.imn.htwk-leipzig.de/~waldmann/ ---------