[Haskell-cafe] ANN: Haddock version 2.2.1

[David Waern]

--------------------------------------------
-- Haddock 2.2.1
--------------------------------------------

A new version of Haddock, the Haskell documentation tool, is out.

The homepage will be updated soon, containing a windows binary release.

Please use the bug tracker to submit bug reports and feature requests.

--------------------------------------------
-- Changes since version 2.1.0
--------------------------------------------

 * Support for GHC 6.8.3

 * The Hoogle backend is back

 * Show associated types in the documentation for class declarations

 * Show type family declarations

 * Show type equality predicates

 * Major bug fixes (#1 and #44)

 * It is no longer required to specify the path to GHC's lib dir

 * Remove unnecessary parenthesis in type signatures

 * Minor bug fixes

--------------------------------------------
-- Links
--------------------------------------------

Homepage:
 http://www.haskell.org/haddock

Hackage page:
 http://hackage.haskell.org/cgi-bin/hackage-scripts/package/haddock-2.2.1

Bugtracker and wiki:
 http://trac.haskell.org/haddock

Mailing list:
 haskelldoc at haskell.org

Code repository:
 http://code.haskell.org/haddock

--------------------------------------------
-- Details
--------------------------------------------

This release contains experimental and incomplete support for GHC's
Type Families extension. We have basic support for rendering of type
family declarations and associated types in the documentation.
Type/Data instances are not shown in the documentation at all, and
associated types are not shown for class instances. Feedback is
appreciated, especially for ideas of how to render type family
instances. Use either the bugtracker, or send a mail to the mailing
list.

We have also got the Hoogle backend back, thanks to Neil Mitchell! The
plan is to be compatible with the upcoming pre-release of Hoogle 4,
which is being developed by Neil as a Summer of Code project.

--------------------------------------------
-- Get Involved
--------------------------------------------

Haddock is an important project, as it is part of the Haskell
infrastructure core. The code base is gradually becoming easier to
read, better documented and more stable, but more work is needed. To
get involved, start by grabbing the code at

 http://code.haskell.org/haddock

then take a look at the bug and feature tracker at

 http://trac.haskell.org/haddock

for things to work on.

David