From mboxrd@z Thu Jan 1 00:00:00 1970 Received: (from majordomo@localhost) by pauillac.inria.fr (8.7.6/8.7.3) id WAA16329; Sun, 13 May 2001 22:22:03 +0200 (MET DST) X-Authentication-Warning: pauillac.inria.fr: majordomo set sender to owner-caml-list@pauillac.inria.fr using -f Received: (from weis@localhost) by pauillac.inria.fr (8.7.6/8.7.3) id WAA16317 for caml-list@pauillac.inria.fr; Sun, 13 May 2001 22:22:03 +0200 (MET DST) Received: from concorde.inria.fr (concorde.inria.fr [192.93.2.39]) by pauillac.inria.fr (8.7.6/8.7.3) with ESMTP id UAA02021 for ; Wed, 9 May 2001 20:11:38 +0200 (MET DST) Received: from localhost.localdomain (jimbo151.zip.com.au [202.7.67.151]) by concorde.inria.fr (8.11.1/8.10.0) with ESMTP id f49IBWX18517; Wed, 9 May 2001 20:11:33 +0200 (MET DST) Received: from ozemail.com.au (IDENT:root@localhost [127.0.0.1]) by localhost.localdomain (8.9.3/8.8.7) with ESMTP id DAA13851; Thu, 10 May 2001 03:58:02 +1000 Message-ID: <3AF9852A.F2B18679@ozemail.com.au> Date: Thu, 10 May 2001 03:58:02 +1000 From: John Max Skaller X-Mailer: Mozilla 4.7 [en] (X11; I; Linux 2.2.12-20 i686) X-Accept-Language: en MIME-Version: 1.0 To: Markus Mottl CC: Fabrice Le Fessant , caml-list@inria.fr Subject: Re: [Caml-list] CDK binary release References: <15094.25994.675673.222337@cremant.inria.fr> <20010509125858.B28402@miss.wu-wien.ac.at> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk Markus Mottl wrote: > I have just taken a look at the way documentation is handled. It would > be fine if there were some kind of standard way to prepare documentation > for OCaml-sources in general. It's otherwise a tremendous effort to > maintain various formats (and who likes writing documentation anyway? ;) But the CDK generates documentation is a way that clearly defines such a 'standard'. So what's needed is a description of this for people preparing packages for inclusion in CDK. I'd also suggest that every package be allowed a 'native html documentation directory'. If present, a link in the generated documentation to it would allow the reader to go the suppliers original html documentation. [For example, if there is a 'doc' directory in the package, the CDK summary could include a link to 'doc/index.html'] -- John (Max) Skaller, mailto:skaller@maxtal.com.au 10/1 Toxteth Rd Glebe NSW 2037 Australia voice: 61-2-9660-0850 checkout Vyper http://Vyper.sourceforge.net download Interscript http://Interscript.sourceforge.net ------------------- To unsubscribe, mail caml-list-request@inria.fr. Archives: http://caml.inria.fr