cabal/haddock features

[Simon Marlow]

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