[Haskell-cafe] No fish, please
andrewcoppin at btinternet.com
Sat May 28 15:10:04 CEST 2011
On 18/05/2011 10:39 PM, Andrew Coppin wrote:
> On 18/05/2011 05:28 AM, Don Stewart wrote:
>> I'm intrigued by the idea of Hackage docs that don't use Haddock.
> This is basically the reason I asked. Currently Cabal assumes that
> Haddock is the only tool of its kind. If somebody built a better
> Haddock, you wouldn't be able to use it. (Unless you named the
> executable "haddock" and made it accept the same command options.)
> Also, Haddock generates API reference documentation. It does not really
> support generating tutorials, introductions, HOWTOs, and all the other
> types of useful documentation that a project ought to have.
Apparently there's already a ticket for this:
It seems part of the reason for inaction is that people would like a
general way of saying how to generate different types of documentation.
Myself, I would be content with a way to say "put *these* files with
documentation and tell the user where you've put them" as a first step.
We can worry about how to *generate* various types of documentation later...
More information about the Haskell-Cafe