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/ ---------
_______________________________________________ Haskell mailing list [EMAIL PROTECTED] http://www.haskell.org/mailman/listinfo/haskell
