[arch-haskell] distributing documentation

Don Stewart dons at galois.com
Sat Oct 12 07:33:54 UTC 2013


roma:
> * Don Stewart <dons at galois.com> [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



More information about the arch-haskell mailing list