[Haskell-cafe] Haddock/hscolour integration broken on Hackage?

Malcolm Wallace Malcolm.Wallace at cs.york.ac.uk
Mon Sep 10 15:42:01 EDT 2007


"David Menendez" <zednenem at psualum.com> writes:

> I was looking at the Data.Binary documentation[1] on Hackage, and I've
> noticed some problems with the associated source listings[2].
> 
> First, none of the "Source" links work. They all refer to fragment IDs
> (e.g., "#Binary") that are not defined. I'm not sure if this is a
> problem with hscolor, haddock, or hackage.

Some of the source links do work, e.g. #encodeFile.  I believe those
that do not work are due to a documented limitation of hscolour, that it
is unable to lexically discover class methods, in order to place an
anchor in front of them.

> Second, the source listing itself[2] is invalid HTML[3]. The W3C
> validator lists 678 errors. Of these, 677 are have to do with the line
> number anchors, all of which start with parentheses.

Oops.  The line number anchors were added to hscolour in a patch
contributed by a third party, which I accepted in good faith.  Since I
have no need of line number anchors myself, maybe the easiest solution
is simply to rollback that patch for the next version of hscolour.

If someone wants to do this for their own copy of hscolour, the patch in
question is this one:

    Sat Apr 21 01:27:56 BST 2007  Roberto Zunino <zunrob at users.sf.net>
      * insert HTML anchors for new lines

Regards,
    Malcolm


More information about the Haskell-Cafe mailing list