Re: [arch-haskell] distributing documentation

roma:

* Don Stewart [2008-09-07 10:53:36-0700]

...

roma:

...

I came from Debian world. One of things I like in Debian is mandatory documentation for each package.

In arch there seems to be another practice -- I don't have /usr/share/doc at all. I don't know whether arch has some policy concerning documentation, but can't we do better at least in arch-haskell land? I mean to include haddock docs in haskell packages. For me it sounds abusive, that having packages installed I need to search Internet for their documentation.

Yes, we've discussed this. I think it isn't feasible to build the haddocks *for each package*, but instead, we should have a haskell-documentation package, that downloads *all* the haddock documentation (and user's guide and ...).

Why isn't it? Debian does this pretty well. For each package they have ${package}-doc with haddocks.

Not every package has haddocks that build, and it adds haddock as a new dependency to the build process. And there's already a complete documentation tree on hackage.haskell.org we can use. -- Don