cabal/haddock features
Simon Marlow
simonmarhaskell at gmail.com
Wed Dec 6 06:31:59 EST 2006
Claus Reinke wrote:
> I was surprised to see haddock apparently ignoring much of my comment
> layout, and a quick glance at the code indicated that it indeed throws
> away or doesn't even collect useful layout info. the first thing I noticed
> was that I can't find a way to have multiple paragraphs in a list item,
> apparently because haddock merges them early..
>
> {- |
> - this is a long list item
>
>
>> a code example
>
>
> i'm in a good mood, so I write more comments
>
> also note the following
>
>
>> variant example
>
>
> - this is the next item
> -}
>
> are there any plans to make haddock more sensitive to existing comment
> layout, preserving it in the html form, or am I just not using it the right way?
I haven't looked into what's going on here, but I'll just say that I'm more than
happy to accept patches that improve things as long as they don't have a serious
impact on backwards compatibility.
Cheers,
Simon
More information about the Libraries
mailing list