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-1.0.0.0/System-Random.html
>
> but not in
>
> http://hackage.haskell.org/packages/archive/random/1.0.0.0/doc/html/System-Random.html

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