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