Re: [Haskell-cafe] Type classes

On Sunday 04 July 2010 14:07:03, Ivan Lazar Miljenovic wrote:

Ross Paterson writes:

...

On Sun, Jul 04, 2010 at 09:55:53PM +1000, Ivan Lazar Miljenovic wrote:

...

Andrew Coppin writes:

...

In summary, I think we need to devise a way of better-documenting class instances.

Haddock 2.7 supports documenting instance implementations; I don't know how this works, but according to the Changelog it's available.

Now we need to go round and document our instances.

Hmm, it seems only partial: documentation attached to an instance is shown in the list of instances under a type, but not the list under a class.

I'm guessing that's to reduce noise...

I'm guessing it might have something to do with the fact that often the module containing the class definition isn't processed together with the module containing the instance declaration.