ANN: Haddock version 2.2.1

-------------------------------------------- -- 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@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

http://hackage.haskell.org/cgi-bin/hackage-scripts/package/haddock-2.2.1 depends on ghc-paths http://hackage.haskell.org/cgi-bin/hackage-scripts/package/ghc-paths-0.1.0.2 ghc-paths failed for me with: Setup.hs:7:7: Could not find module `Distribution.Simple.PackageIndex': I've ghc-6.8.3 and Cabal-1.2.4.0 Can haddock-2.2.1 replace may old haddock-0.8 (or haddock-0.9)? Cheers Christian David Waern wrote:
-------------------------------------------- -- 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@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

On 2008.08.04 19:32:13 +0200, Christian Maeder
http://hackage.haskell.org/cgi-bin/hackage-scripts/package/haddock-2.2.1 depends on ghc-paths http://hackage.haskell.org/cgi-bin/hackage-scripts/package/ghc-paths-0.1.0.2 ghc-paths failed for me with:
Setup.hs:7:7: Could not find module `Distribution.Simple.PackageIndex':
I've ghc-6.8.3 and Cabal-1.2.4.0
Can haddock-2.2.1 replace may old haddock-0.8 (or haddock-0.9)?
Cheers Christian
ghc-paths is very picky about its cabal version. Apparently Cabal 1.4.x works; you can get it from darcs at http://darcs.haskell.org/cabal-branches/cabal-1.4 (dunno about any packages). -- gwern monarchist emc Taiwan SIGDASYS ation HRT SURSAT GNU OPS Ingram

Right, http://hackage.haskell.org/cgi-bin/hackage-scripts/package/Cabal-1.4.0.1 works. It seems that the dependencies for ghc-paths could be improved. Thanks Christian Gwern Branwen wrote:
On 2008.08.04 19:32:13 +0200, Christian Maeder
scribbled 3.0K characters: http://hackage.haskell.org/cgi-bin/hackage-scripts/package/haddock-2.2.1 depends on ghc-paths http://hackage.haskell.org/cgi-bin/hackage-scripts/package/ghc-paths-0.1.0.2 ghc-paths failed for me with:
Setup.hs:7:7: Could not find module `Distribution.Simple.PackageIndex':
I've ghc-6.8.3 and Cabal-1.2.4.0
Can haddock-2.2.1 replace may old haddock-0.8 (or haddock-0.9)?
I'm still struggling with this point. haddock-0.8 accepted the same file multiple times and several Main modules.
Cheers Christian
ghc-paths is very picky about its cabal version. Apparently Cabal 1.4.x works; you can get it from darcs at http://darcs.haskell.org/cabal-branches/cabal-1.4 (dunno about any packages).
-- gwern monarchist emc Taiwan SIGDASYS ation HRT SURSAT GNU OPS Ingram

On 2008.08.04 20:47:12 +0200, Christian Maeder
Right, http://hackage.haskell.org/cgi-bin/hackage-scripts/package/Cabal-1.4.0.1 works.
It seems that the dependencies for ghc-paths could be improved.
Thanks Christian
Yes, I emailed Marlow suggesting that yesterday. (Or perhaps it was the day before.) -- gwern Firewalls CAVE Richard Croatian Honduras WAS AKR 701 hrt varon

On 2008.08.04 20:47:12 +0200, Christian Maeder
scribbled 1.1K characters: Right, http://hackage.haskell.org/cgi-bin/hackage-scripts/package/Cabal-1.4.0.1 works.
It seems that the dependencies for ghc-paths could be improved.
Thanks Christian
Yes, I emailed Marlow suggesting that yesterday. (Or perhaps it was the day before.)
Sorry - I fixed the .cabal file and then got sidetracked into trying to make it work with Cabal-1.5 too. I'll upload the version with the fixed dependency now. Cheers, Simon

On 2008.08.04 20:47:12 +0200, Christian Maeder
scribbled 1.1K characters: Right, http://hackage.haskell.org/cgi-bin/hackage-scripts/package/Cabal- 1.4.0.1 works.
It seems that the dependencies for ghc-paths could be improved.
Thanks Christian
Yes, I emailed Marlow suggesting that yesterday. (Or perhaps it was the day before.)
Sorry - I fixed the .cabal file and then got sidetracked into trying to make it work with Cabal-1.5 too. I'll upload the version with the fixed dependency now.
Hackage won't let me upload a package with cabal-version: >= 1.4 && < 1.5, but it will let me upload with just >= 1.4, so I've done that for now. The package will fail to build if you have Cabal 1.5.x installed, presumably. Cheers, Simon

On 2008.08.05 09:22:17 +0100, Simon Marlow
On 2008.08.04 20:47:12 +0200, Christian Maeder
scribbled 1.1K characters: Right, http://hackage.haskell.org/cgi-bin/hackage-scripts/package/Cabal- 1.4.0.1 works.
It seems that the dependencies for ghc-paths could be improved.
Thanks Christian
Yes, I emailed Marlow suggesting that yesterday. (Or perhaps it was the day before.)
Sorry - I fixed the .cabal file and then got sidetracked into trying to make it work with Cabal-1.5 too. I'll upload the version with the fixed dependency now.
Hackage won't let me upload a package with cabal-version: >= 1.4 && < 1.5, but it will let me upload with just >= 1.4, so I've done that for now. The package will fail to build if you have Cabal 1.5.x installed, presumably.
Cheers, Simon
Hm. So far as I know there was only one 1.4 release, so couldn't you do cabal-version: == 1.4.0.1? -- gwern mol snuffle evil Firewalls fissionable SRT Speakeasy HIC 5.53 Steve
participants (4)
-
Christian Maeder
-
David Waern
-
Gwern Branwen
-
Simon Marlow