ANN: Haddock version 2.5.0
David Waern
david.waern at gmail.com
Sat Aug 15 06:04:41 EDT 2009
--------------------------------------------
-- Haddock 2.5.0
--------------------------------------------
A new version of Haddock, the Haskell documentation tool, is out!
If you're using GHC 6.10.2 and Haddock 2.4.2, you should be able to upgrade to
this version without any problem. If you're using something else, you should
re-install any documentation that you want to link to after upgrading.
Please use the bug tracker to submit bug reports or feature requests.
--------------------------------------------
-- Changes in version 2.5.0
--------------------------------------------
* Drop support for GHC 6.8.*
* Add support for GHC 6.10.3 and 6.10.4
* Revert to the old multi-page index for large packages (#106)
* Show GADT records in the generated documentation
* Create the output directory if it doesn't exist (#104)
* Use the native codegen instead of compiling via C for TH modules
* Add --use-unicode flag for displaying prettier versions of common symbols
* Mutiple verbosity levels: remove --verbose and add --verbosity=n
* Simpler versioning of .haddock files
To avoid slow search, Haddock switches from the searchable index to the old
multi-page index for large packages (containing over 150 items). This, and
support for GADT records in the generated documentation was implemented by
Isaac Dupree as part of his Summer of Code project.
The --use-unicode flag was contributed by George Porges.
--------------------------------------------
-- Links
--------------------------------------------
Homepage:
http://www.haskell.org/haddock
Hackage page:
http://hackage.haskell.org/package/haddock-2.5.0
Bugtracker and wiki:
http://trac.haskell.org/haddock
Mailing list:
haddock at projects.haskell.org
Code repository:
http://code.haskell.org/haddock
--------------------------------------------
-- Contributors
--------------------------------------------
The following people contributed patches to this release:
Isaac Dupree
Ian Lynagh
Simon Marlow
Simon Peyton-Jones
George Porges
David Waern
--------------------------------------------
-- Future Plans
--------------------------------------------
Here are the top priority tickets right now:
* Cross-package documentation (#24)
* Good warning messages when encountering unexpected Haddock comments (#94)
* Comments on instance declarations (#29)
Isaac Dupree has been working on the first item as part of his SoC project and
it is near completion.
If you have any input on what we should prioritize, add yourself to the CC list
of the ticket(s) that you are interested in.
--------------------------------------------
-- Get Involved
--------------------------------------------
We would be very happy to get more contributors. To get involved, start by
grabbing the code:
http://code.haskell.org/haddock
Then take a look at the bug and feature tracker for things to work on:
http://trac.haskell.org/haddock
More information about the Haddock
mailing list