Re: [Haskell-cafe] ANNOUNCE: Haddock version 2.0.0.0
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? 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.
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.
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe
Re: [Haskell-cafe] ANNOUNCE: Haddock version 2.0.0.0
2008/1/16, Henning Thielemann [EMAIL PROTECTED]:
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
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe
Re: [Haskell-cafe] ANNOUNCE: Haddock version 2.0.0.0
2008/1/10, Alfonso Acosta [EMAIL PROTECTED]: On Jan 8, 2008 1:28 PM, David Waern [EMAIL PROTECTED] wrote: Dear Haskell community, I'm proud to announce the release of Haddock 2.0.0.0! Great! I already tested a dracs spanshot before the release and seemed to work well with TH code. Any idea about when will hackage adopt this version to generate its documentation? Hmm, I'm not sure since I'm not involved in Hackage, but I can't think of anything that would stop Hackage from adopting it right away. David ___ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe
Re: [Haskell-cafe] ANNOUNCE: Haddock version 2.0.0.0
On Jan 8, 2008 1:28 PM, David Waern [EMAIL PROTECTED] wrote: Dear Haskell community, I'm proud to announce the release of Haddock 2.0.0.0! Great! I already tested a dracs spanshot before the release and seemed to work well with TH code. Any idea about when will hackage adopt this version to generate its documentation? ___ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe
Re: [Haskell-cafe] ANNOUNCE: Haddock version 2.0.0.0
Hello, I've just tried this with cabal runghc Setup haddock --hyperlink-source --hscolour-css=..\hscolour.css and I get this error.. Setup: haddock --hyperlink-source requires Haddock version 0.8 or later This looks like a bug in cabal rather than the new Haddock to me. Can anyone think of an easy workaround? Regards -- Adrian Hey ___ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe
Re: [Haskell-cafe] ANNOUNCE: Haddock version 2.0.0.0
2008/1/8, Adrian Hey [EMAIL PROTECTED]: Hello, I've just tried this with cabal runghc Setup haddock --hyperlink-source --hscolour-css=..\hscolour.css and I get this error.. Setup: haddock --hyperlink-source requires Haddock version 0.8 or later This looks like a bug in cabal rather than the new Haddock to me. Can anyone think of an easy workaround? Yes, you could switch to the darcs version of Cabal, where this has been fixed. I don't know if a release containing the fix has been made. David ___ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe
