From e94d22033443e2cd90b8c2a8e2b0d5a686936484 Mon Sep 17 00:00:00 2001 From: David Waern Date: Tue, 31 Aug 2010 22:32:27 +0000 Subject: Update ANNOUNCE --- ANNOUNCE | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 56 insertions(+), 8 deletions(-) diff --git a/ANNOUNCE b/ANNOUNCE index 4ec1b59c..e0b7d8b8 100644 --- a/ANNOUNCE +++ b/ANNOUNCE @@ -1,18 +1,62 @@ -------------------------------------------- --- Haddock 2.7.0 +-- Haddock 2.8.0 -------------------------------------------- A new version of Haddock, the Haskell documentation tool, is out! +The biggest news this time is that we have a shiny new XHTML backend, created +by Mark Lentczner, which outputs semantically correct XHTML, making it much +easier to create new themes for Haddock. + +Mark has made an extraordinary effort by going through and rewriting the old +table based HTML backend, fixing non-standards-compliant quirks, and adding a +bunch of new useful features on top of that. See the changelog for more +details. + +Included is a new default CSS theme created by Thomas Schilling, Mark and Johan +Tibell, as well as the classic theme converted to work with the new backend. + +Another great new feature is markup support for examples, contributed by Simon +Hengel. The idea is to be able to write examples that function both as +documentation and unit tests. + +Last but not least, we now also have a LaTeX backend. It was written by Simon +Marlow and it was used to generate the libraries section of the Haskell 2010 +report. + -------------------------------------------- --- Changes in version 2.7.0 +-- Changes in version 2.8.0 -------------------------------------------- - * Instances can be commented + * HTML backend completely rewritten to generate semantically rich XHTML + using the xhtml package. + + * New default CSS based on the color scheme chosen for the new Haskell + wiki, with a pull-out tab for the synopsis. + + * Theme engine based on CSS files. Themes can be switched from the + header menu. (New flags --built-in-themes and --theme. The latter + is an alias for --css which now has extended semantics). + + * Markup support for executable examples/unit-tests. To be used with an + upcoming version of the DocTest program. + + * Addition of a LaTeX backend. + + * Frames-mode can be turned on/off from the header menu. + + * Path to source entities can be specified per package, so that source + links work for cross-package documentation. + + * Support for a second form of enumerated lists (1. 2. etc). + + * Additions and changes to the Haddock API. - * The Haddock API now exposes more of the internals of Haddock + * New flag --no-tmp-comp-dir to tell Haddock to read/write + compilation files (.o, .hi, etc) to/from GHC's output directory instead of + to/from a temporary directory. - * Bug fixes (most importantly #128) + * Various bug fixes. -------------------------------------------- -- Links @@ -22,7 +66,7 @@ Homepage: http://www.haskell.org/haddock Hackage page: - http://hackage.haskell.org/cgi-bin/hackage-scripts/package/haddock-2.7.0 + http://hackage.haskell.org/package/haddock-2.8.0 Bugtracker and wiki: http://trac.haskell.org/haddock @@ -39,8 +83,12 @@ Code repository: The following people contributed patches to this release: - Isaac Dupree - Yitzchak Gale + Simon Hengel + Mark Lentczner + Ian Lynagh + Simon Marlow + Simon Peyton-Jones + Thomas Schilling David Waern -------------------------------------------- -- cgit v1.2.3