Re: Haskell platform proposal: split package

On Sat, Jul 21, 2012 at 04:37:48PM +0200, Gábor Lehel wrote:

On Sat, Jul 21, 2012 at 2:13 PM, Simon Hengel wrote:

...

...

An unrelated suggestion: you can give type signatures to the various functions which are synonyms of each other as a group and they will show up as a single item in the Haddocks.

Have you tried this a recent version of Haddock? I think this was only in the Haddock version that was released with GHC 7.2 (introduced due to a change in GHC). But it had issues with explicit export lists, so we now always expand such signatures.

Cheers, Simon

It seems to work with Haddock 2.10 / GHC 7.4. I remember I initially tried it with whatever old version of Haddock I had installed and I was annoyed that it didn't work (it got split into two declarations with one of them missing documentation entirely -- quite suboptimal), but then following a suggestion I tried it again with GHC 7.4 and was happy that it seemed to have improved and gave the expected behaviour, and impressively even worked across module boundaries. I would be sad if it stopped working again. :)

Indeed, from the CHANGES file in the haddock distribution: Changes in version 2.9.3: * A type signature for multiple names generates one signature in the output Neato, I didn't know about this feature. I think grouping synonyms together like this is a good idea. -Brent