Haddock (software)

From Wikipedia, the free encyclopedia

Template:Short description

Page Module:Message box/ambox.css has no content.

Page Module:Infobox/styles.css has no content.

Haddock
[[Programmer|DeveloperTemplate:Pluralize from text]]Simon Marlow
Initial releaseMay 1, 2002
Template:Infobox software/simple
Written inHaskell
Operating systemCross-platform
Platformx86, PowerPC
TypeDocumentation generation
LicenseBSD-style license
Websitehttp://haskell.org/haddock/

Script error: No such module "Check for conflicting parameters".

Haddock is a free, portable[1] command-line program documentation generator for Haskell.

Software

It is influenced by IDoc,[2] HDoc,[3] and Doxygen.[4] It produces hyperlinked HTML files from annotated Haskell (the documentation is embedded in comments) source files, with additional information extracted from type annotations; it supports only partially generating documentation in SGML.[5] It is often used in conjunction with darcs and Cabal. It is dependent on Glasgow Haskell Compiler (GHC), using a modified form of the HsParser (written in Happy) parser for Haskell included in GHC.[5] Its lightweight markup is based on IDoc's.[5] Haddock is contained in the Haskell Platform.

It is used by the GHC, Gtk2Hs and HTk projects,[6] as well as xmonad.[citation needed]

Here is an example of Haddock markup:

 -- | This is the documentation for 'square', which
 --   uses the (*) operator from "Prelude".
 --   It multiplies the @x@ argument against itself.
 square :: Integer -> Integer
 square x = x*x

References

Page Template:Reflist/styles.css has no content.

  1. ^ Haddock runs on POSIX-compliant operating systems and Microsoft Windows.
  2. ^ Page Module:Citation/CS1/styles.css has no content."IDoc Manual - Installation". www.cse.unsw.edu.au.
  3. ^ Page Module:Citation/CS1/styles.css has no content."Homepage of Armin Größlinger". www.fmi.uni-passau.de. Archived from the original on 2006-12-23. Retrieved 2007-02-17.
  4. ^ Page Module:Citation/CS1/styles.css has no content."1.3. Contributors". haskell.org.
  5. ^ a b c "Haddock: A Haskell Documentation Tool" Script error: No such module "webarchive". -(by Simon Marlow, Proceedings of the ACM SIGPLAN workshop on Haskell, 2002; PDF)
  6. ^ "Haddock is being used to document the new hierarchical Haskell libraries. The documentation generated for the libraries shipped with the latest release of GHC is here. The Gtk2Hs project is using Haddock to build reference documentation. The HTk project is using Haddock to generate its library documentation." From the Haddock homepage.

Template:Haskell programming