
2008/1/16, Henning Thielemann
On Tue, 8 Jan 2008, David Waern wrote:
Changes in version 2.0.0.0:
* The GHC API is used as the front-end
It's great to see this progress in Haddock. However, is Haddock now more difficult to port than before?
Haddock is already ported to the GHC API, the wiki-page needs updating.
Is there some bug- and feature request tracker for Haddock? I only know of http://www.haskell.org/haskellwiki/Haddock/Development_ideas and the first big point seems to be finished now.
There is no bug-tracker yet. When community.haskell.org provides Trac, we might use that. For now, we're using the TODO file in the darcs repo (code.haskell.org/haddock).
I like to have the following enhancements:
* Optionally show qualifications of identifiers, that is print "Sequence.map" rather than "map", "Music.T" rather than just "T". The option for haddock could be --qualification QUAL QUAL=none (default) strip off qualification (just "map") QUAL=orig show the identifiers as they are written in the module (e.g. "map" or "List.map") QUAL=full show all identifiers with full qualification (Data.List.map) Actually I tried to implement it by myself in the old Haddock, but I could not precisely identify the place, where the qualification is removed.
* Documentation of arguments of type constructors other than 'top level' arrows. E.g. T (a {- ^ arg -} -> b {- ^ result -} ) (a {- ^ arg -} -> b {- ^ result -} ) -> c (a {- ^ x coord -}, b {- ^ y coord -}) -> c It's probably difficult to format properly in HTML.
I've added these to the TODO file. Thanks, David