On 17 March 2005 06:11, Sean Perry wrote:
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.
Actually the DocBook backend isn't really there yet. It wouldn't be too hard to add a plain ASCII backend to Haddock that generates the interfaces for modules without the implementation - that would address Benjamin's concern to some extent. Cheers, Simon