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 PAA30150; Wed, 9 May 2001 15:19:46 +0200 (MET DST) X-Authentication-Warning: pauillac.inria.fr: majordomo set sender to owner-caml-list@pauillac.inria.fr using -f 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 PAA30086 for ; Wed, 9 May 2001 15:19:45 +0200 (MET DST) Received: from miss.wu-wien.ac.at (miss.wu-wien.ac.at [137.208.107.17]) by concorde.inria.fr (8.11.1/8.10.0) with ESMTP id f49DJhX04448; Wed, 9 May 2001 15:19:43 +0200 (MET DST) Received: (from mottl@localhost) by miss.wu-wien.ac.at (8.9.0/8.9.0) id PAA30099; Wed, 9 May 2001 15:18:28 +0200 (MET DST) Date: Wed, 9 May 2001 15:18:28 +0200 From: Markus Mottl To: David Mentre Cc: Fabrice Le Fessant , caml-list@inria.fr Subject: [Caml-list] Re: About documentation tools Message-ID: <20010509151828.A16874@miss.wu-wien.ac.at> References: <15094.25994.675673.222337@cremant.inria.fr> <20010509125858.B28402@miss.wu-wien.ac.at> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: ; from David.Mentre@inria.fr on Wed, May 09, 2001 at 14:01:23 +0200 Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk On Wed, 09 May 2001, David Mentre wrote: > ocamlweb intents to be a tool to document source code as Knuth's WEB > tool. In other words, it's more for internal code documentation than > for user manual and reference guide. It can also be used to extract information about interfaces. The nice thing about it is that it allows you to fully exploit the power of Latex (and therefore Hevea). I think it's a good idea to support such features if one wants to have flexible ways of generating documentation. > the tool used by the Caml team is specific and not ready for a public > release, i.e. some shortcomings are solved in ad-hoc manner. But it wouldn't hurt either to make it available as alpha software on some CVS-server, would it? Maybe some voluntary hero (not me ;) would go about making it "ready for public use"... > But I agree that a recommended documentation tool would be a plus. I still see a lack of "social" standard tools. Documentation tools are one thing, packaging tools another. Wouldn't this be exactly the right thing that the new OCaml-consortium would want to fund? - It's a reasonable assumption that Xavier and the others prefer hacking away on new compiler features rather than such things and would need engineers for more earthly tasks. How are things developing in the Consortium? Are there already plans to fund specific projects, possibly of this kind? > It does not mean that such a tool should be very elaborated. The > simpler, the better. I find ocamlweb fairly easy to use (not really much more difficult than your tool, I think). It still gives you the option to drop to Latex if required. > And I also think that such a tool should be close to standard tool > in other languages, mostly javadoc. It would help the transition from > other languages (and multi-language developments). I don't know Java (and therefore javadoc) well enough to judge this (maybe at least javadoc is well-designed), but I'd surely argue against taking up inferior approaches if we can do things the right way right from the start. Best regards, Markus -- Markus Mottl, mottl@miss.wu-wien.ac.at, http://miss.wu-wien.ac.at/~mottl ------------------- To unsubscribe, mail caml-list-request@inria.fr. Archives: http://caml.inria.fr