On Wed, Oct 22, 2008 at 12:08:49AM +0200, Gerd Stolpmann wrote:
> I know that Debian prefers /usr/share/doc/<packagename>. Don't know for
> Fedora.

Getting off-topic here ...

Yes, the one mention by Gerd is a policy rule which generically states
where to store package documentation.

Still, in Debian we also have a higher-level mechanism for registering
documentation, and we are for the OCaml packages using it consistently
to register ocamldoc API references. The mechanism is called doc-base.

To given an idea about which information are stored there, here is the
entry in the doc-base database for the ocamlnet API reference:

> Document: libocamlnet-ocaml-dev-ocamldoc-api-reference
> Title: libocamlnet-ocaml-dev OCamldoc API Reference
> Abstract: API reference manual for libocamlnet-ocaml-dev (generated via 
> OCamldoc)
> Section: Programming/OCaml
>
> Format: HTML
> Index: /usr/share/doc/libocamlnet-ocaml-dev/html/api/index.html
> Files: /usr/share/doc/libocamlnet-ocaml-dev/html/api/*

In case of need, we have (easily guessable from the above) naming
conventions which let us recognize all doc-base entries which contain
ocamldoc API references.

Cheers.

-- 
Stefano Zacchiroli -*- PhD in Computer Science \ PostDoc @ Univ. Paris 7
[EMAIL PROTECTED],pps.jussieu.fr,debian.org} -<>- http://upsilon.cc/zack/
Dietro un grande uomo c'รจ sempre /oo\ All one has to do is hit the right
uno zaino        -- A.Bergonzoni \__/ keys at the right time -- J.S.Bach

_______________________________________________
Godi-list mailing list
[email protected]
https://godirepo.camlcity.org/mailman/listinfo/godi-list

Reply via email to