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

Re: menu policy & use of doc-base for programming documentation



On Thu, Aug 30, 2007 at 03:19:43PM -0400, Eric Cooper wrote:
> The Debian OCaml maintenance team is looking at how to organize the
> HTML documentation provided by the various OCaml packages.  Our first

Right, to add some details to that:
- each library we have (will) ship an HTML documentation of the API,
  generated with ocamldoc (the equivalent of javadoc). Such
  documentation will be installed as /usr/share/doc/PACKAGE/html/api/
- we just want to have a global HTML index which contain a listing of
  all the library we ship as simple HTML links to the above pieces of
  documentation

If possible we would like to avoid reinventing the wheel, and doc-base
seems to be the right tool; it's just to restrictive: why should its
categories be tight to the menu categories?

Cheers.

-- 
Stefano Zacchiroli -*- PhD in Computer Science ............... now what?
zack@{cs.unibo.it,debian.org,bononia.it} -%- http://www.bononia.it/zack/
(15:56:48)  Zack: e la demo dema ?    /\    All one has to do is hit the
(15:57:15)  Bac: no, la demo scema    \/    right keys at the right time

Attachment: signature.asc
Description: Digital signature


Reply to: