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 -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
