Re: where to put manpages (filename clash issue)
On Tue, Aug 28, 2007 at 08:09:21AM +0200, Stefano Zacchiroli wrote:
> Do you think automatic registration with doc-base would be enough? That
> way you can use the doc-base browsing tools to find OCaml API docs. In
> addition to that we can think of creating a new OCaml-specific section
> for OCaml module API references and that would enable to see a page with
> only OCaml stuff, but we need to check if it is allowed to arbitrarily
> create new sections in doc-base (volunteers welcome :)).
According to the doc-base documentation, the sections are taken from
the Debian menu policy:
http://www.debian.org/doc/packaging-manuals/menu-policy/ch2.html#s2.1
which says
"Please do not put your packages into any other sections without
asking for permission first!
and
"If you have a package which doesn't fit within the existing menu
hierarchy, please bring it up on the debian-devel mailing list. If
you have other proposals for changing the menu hierarchy, or making
other changes to menu policy, please bring it up on debian-policy.
Right now, a couple of OCaml libraries (cryptokit and pcre) are in doc-base.
They're in Apps/Programming, but that category is unusably large
-- it's got all the libraries and tools from every language.
Asking for a subcategory for OCaml would be the best approach, I
think, but that might open the floodgates for all the other languages
out there. I'm sure it would generate at least a 2-week flamefest on
debian-policy :-)
But it would be nice to not have to invent another tool for gathering
just the OCaml stuff, generating an HTML index page, etc., when dhelp
could do it already.
--
Eric Cooper e c c @ c m u . e d u
Reply to: