Haddock (software) - Misplaced Pages

Command-line program documentation generator for Haskell

This article relies excessively on references to primary sources. Please improve this article by adding secondary or tertiary sources.
Find sources: "Haddock" software – news · newspapers · books · scholar · JSTOR (September 2018) (Learn how and when to remove this message)

Haddock
Developer(s)	Simon Marlow
Initial release	May 1, 2002

Stable release	2.25.0 / 2 March 2021; 3 years ago (2 March 2021)

Repository	github.com/haskell/haddock
Written in	Haskell
Operating system	Cross-platform
Platform	x86, PowerPC
Type	Documentation generation
License	BSD-style license
Website	http://haskell.org/haddock/

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

Software

It is influenced by IDoc, HDoc, and Doxygen. 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. 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. Its lightweight markup is based on IDoc's. Haddock is contained in the Haskell Platform.

It is used by the GHC, Gtk2Hs and HTk projects, as well as xmonad.

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

"Release 2.25.0". 2 March 2021. Retrieved 25 March 2021.
Haddock runs on POSIX-compliant operating systems and Microsoft Windows.
"IDoc Manual - Installation". www.cse.unsw.edu.au.
"Homepage of Armin Größlinger". www.fmi.uni-passau.de.
"1.3. Contributors". haskell.org.
^ "Haddock: A Haskell Documentation Tool" Archived 2006-10-11 at the Wayback Machine -(by Simon Marlow, Proceedings of the ACM SIGPLAN workshop on Haskell, 2002; PDF)
"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.

External links

Official website

Haskell programming

Software

Implementations
(features)

Generic Haskell°
Glasgow Haskell Compiler°
- Template Haskell°
Gofer° → Hugs°
York Haskell Compiler° (Yhc)

Dialects

Agda° Cryptol° Curry° Elm° Hume° Idris° Ωmega° Orwell° Pugs° TidalCycles° Ur°
Electronic design	Atom° Bluespec SystemVerilog (BSV)