Ticket #2299 (closed bug: fixed)

Opened 5 years ago

Last modified 5 years ago

Haddock 2 library documentation not available

Reported by: fons Owned by:
Priority: normal Milestone:
Component: Documentation Version: 6.8.2
Keywords: Cc:
Operating System: Unknown/Multiple Architecture: Unknown/Multiple
Type of failure: Difficulty: Unknown
Test Case: Blocked By:
Blocking: Related Tickets:

Description

As you know, the .haddock files generated by haddock-0.8 are incompatible with haddock-2.X

However, GHC's site only seems to offer a 0.8-friendly documentation package.

I think GHC should systematically offer an alternative haddock-2 documentation package or, even better, provide documentation compatible with both versions (this would probably require changes in haddock).

It would maybe be agood idea to offer http://www.haskell.org/ghc/docs/latest/libraries.html-haddock2.tar.gz apart from http://www.haskell.org/ghc/docs/latest/libraries.html.tar.gz or simply move on to haddock 2.

Since most of my code relies on GHC syntax extensions and I didn't want to lose the ability to get links in my documentation, I created a haddock-2 version of the library documentation myself:

 http://code.haskell.org/~fons/libraries.html-haddock2.tgz

Should I add the link to  http://haskell.org/haskellwiki/GHC or wait until a cleaner solution is found?

Change History

Changed 5 years ago by igloo

  • status changed from new to closed
  • difficulty set to Unknown
  • resolution set to fixed

Thanks, I've added your haddock2 tarball to the documentation page.

I don't think that making haddock2 docs automatically is feasible until we make the move from haddock 0.8 to haddock 2, but hopefully we'll do that for GHC 6.10 anyway.

Changed 5 years ago by simonmar

  • architecture changed from Unknown to Unknown/Multiple

Changed 5 years ago by simonmar

  • os changed from Unknown to Unknown/Multiple
Note: See TracTickets for help on using tickets.