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 PAA04565; Thu, 10 May 2001 15:18:57 +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 PAA04561 for ; Thu, 10 May 2001 15:18:56 +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 f4ADItn24243; Thu, 10 May 2001 15:18:55 +0200 (MET DST) Received: (from mottl@localhost) by miss.wu-wien.ac.at (8.9.0/8.9.0) id PAA16451; Thu, 10 May 2001 15:18:54 +0200 (MET DST) Date: Thu, 10 May 2001 15:18:54 +0200 From: Markus Mottl To: Sven LUTHER Cc: Fabrice Le Fessant , John Max Skaller , caml-list@inria.fr Subject: Re: [Caml-list] CDK binary release Message-ID: <20010510151854.A6851@miss.wu-wien.ac.at> References: <15094.25994.675673.222337@cremant.inria.fr> <20010509125858.B28402@miss.wu-wien.ac.at> <3AF9852A.F2B18679@ozemail.com.au> <20010510004003.A27333@miss.wu-wien.ac.at> <3AF9D067.93E6DE1A@ozemail.com.au> <15098.23852.403551.65183@cremant.inria.fr> <20010510131646.A20887@lambda.u-strasbg.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010510131646.A20887@lambda.u-strasbg.fr>; from luther@dpt-info.u-strasbg.fr on Thu, May 10, 2001 at 13:16:46 +0200 Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk On Thu, 10 May 2001, Sven LUTHER wrote: > On Thu, May 10, 2001 at 11:19:40AM +0200, Fabrice Le Fessant wrote: > > The CDK documentation tool has still many problems, but it is > > currently the only tool which produces man pages for Ocaml modules and > > functions. Moreover, LaTeX is not used by all Ocaml users (some are > > using Windows and its wonderful editors). For now, I think the best > > language is a specific language, for example, a subset of HTML. I agree with Dave and Sven that producing LaTeX should be supported in some way or the other. HTML alone is not good enough, and translating from HTML to LaTeX definitely doesn't seem to be so much easier than the other way round. It's usually better to translate from more powerful to less powerful languages. Also, I don't need man page support, though this could be surely added to hevea (it already supports texinfo). Man pages are really just text beefed up with some formatting (no cross-references and such). The following bash function probably produces more readable output: function ocdoc () { command vim -R `ocamlc -where`/$1; } To summarize, I'd prefer a tool that produces Latex and also allows Latex-code within the documentation. Ocamlweb could surely be improved (more features, more beautiful formatting, etc.), but I think it gets the ideas of simplicity + expressiveness basically right. Why not take this tool and make it ready for wide-spread public use? I was a bit surprised that cdk_doc doesn't build on ocamlweb + hevea. Best regards, Markus Mottl -- 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