haddock - links with fragments messed up

Ross Paterson ross at soi.city.ac.uk
Sun Nov 18 08:54:33 EST 2007

On Sun, Nov 18, 2007 at 12:35:32PM +0100, apfelmus wrote:
> the #-links to the references at the bottom of System.Random work fine in
> http://www.haskell.org/ghc/docs/latest/html/libraries/random-
> but not in
> http://hackage.haskell.org/packages/archive/random/

Presumably a bug in the version of haddock used (not sure which one).
It's fixed now.

> Besides, I doubt that the links like
>   System.Random#globalrng
> are intended to be rendered as such but rather as the title of the 
> destination
>   The global random number generator
> or something.

That would need a change to haddock's design.  Currently section headers
and fragment references are two separate elements that authors can place
near one another, e.g.

-- ** The global random number generator

-- #globalrng#

The link is actually to a location just below the section header.
Combining the two would certainly be an improvement.

More information about the Libraries mailing list