[Haskell-cafe] Best practices for modular programming in Haskell

[Sean Perry]

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.