On Mon, Sep 03, 2007 at 06:12:43PM +0200, Stefano Zacchiroli wrote: > > Also, I don't see the need for the verbose names. What's wrong > > with the current <PACKAGENAME> entry in /usr/share/doc-base? > > That you don't know how to recognize that they are actually ocamldoc > generated API references. Also remember that a package can ship more > than one doc-base entries, findlib is an example of such a package. > With a naming convention I manage to distinguish the one I'm interested > in. Let me add a couple more info about that. First of all the verbose name "PKGNAME-ocamldoc-api-reference" is only the internal unique id used by doc-base, AFAIK the users never see it (except if they dig manually in /usr/share/doc-base/ of course). The rationale for the various parts is that "ocamldoc" is to identify that the doc has been generated automatically, after all a package can even ship an API reference made in some other non automatic ways (or automatic but not based on ocamldoc). 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