[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: doc-base



Hallo Joachim.

Excerpts from Joachim Breitner's message of Qui Mar 25 14:27:16 -0300 2010:
(...)
> Am Dienstag, den 23.03.2010, 13:46 -0300 schrieb Marco Túlio Gontijo e
> Silva:
> > I noticed that hstringtemplate includes a doc-base file for the HTML haddock
> > documentation.  Should we do this in all packages and include it in the
> > PackageTemplate?
> 
> I’m not sure. I, as a user, never used doc-base.

Me neither.

> Also, the haddock libraries are linked in a probably more useful way from
> file:///usr/share/doc/ghc6-doc/html/libraries/index.html
> Maybe only that should have a doc-base entry, and single modules should
> not?
>
> IIRC some few libraries have real, non-API documentation. These can of
> course have a doc-base entry of their own.

This is a good point.  Does anyone think it's useful also for libraries to
provide doc-base links?

I'm CCing the doc-base maintainer.  Robert, what do you think about this
situation?

> But if we chose to add doc-base files to all libraries, we should, if
> possible, do it via haskell-devscripts.

Seconded.

Auf Wiedersehen.
(...)
-- 
marcot
http://wiki.debian.org/MarcoSilva


Reply to: