[Haskell-cafe] Best practices for modular programming in Haskell
shaleh at speakeasy.net
Thu Mar 17 01:11:21 EST 2005
Benjamin Pierce wrote:
> Other people seem to rely on Haddock to generate interfaces as
> documentation. This is nicer in many ways (e.g., it solves the above
> problem because Haddock elides the right-hand side of a "data" or "newtype"
> declaration if the constructors are not exported by the module), but it
> means that you are stuck browsing interfaces in a web browser can't just
> have a look with emacs. This is especially annoying if you want to read the
> interface in tandem with the implementation (because you are trying to
> understand how the thing works internally but want to use the interface to
> get a high-level picture of the functionality it presents to the world).
haddock can also output docbook and you can make info pages from docbook.
More information about the Haskell-Cafe