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 RAA06828; Thu, 10 May 2001 17:09:56 +0200 (MET DST) X-Authentication-Warning: pauillac.inria.fr: majordomo set sender to owner-caml-list@pauillac.inria.fr using -f Received: from nez-perce.inria.fr (nez-perce.inria.fr [192.93.2.78]) by pauillac.inria.fr (8.7.6/8.7.3) with ESMTP id RAA06824 for ; Thu, 10 May 2001 17:09:54 +0200 (MET DST) Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by nez-perce.inria.fr (8.11.1/8.10.0) with ESMTP id f4AF9q909879; Thu, 10 May 2001 17:09:53 +0200 (MET DST) Received: from localhost (patrick@localhost) by fledge.watson.org (8.11.3/8.11.3) with SMTP id f4AF9L805129; Thu, 10 May 2001 11:09:21 -0400 (EDT) (envelope-from patrick@watson.org) Date: Thu, 10 May 2001 11:09:21 -0400 (EDT) From: Patrick M Doane To: Sven LUTHER cc: Fabrice Le Fessant , John Max Skaller , Markus Mottl , caml-list@inria.fr Subject: Re: [Caml-list] CDK binary release In-Reply-To: <20010510131646.A20887@lambda.u-strasbg.fr> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII 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. > > What about sgml, most project use that, and they can then transform it in many > different format afterward. I agree. I posted recently about any experiences users have with SGML documentation linked with Ocaml programs so this seems to be coming up at a good time. I would like to have a good framework in place for writing the documentation for FORT and would prefer an SGML approach. > Also if windows people don't use latex (there is a tex suite for windows > available anyway), you just need to transform the latex files into something > they can use, like html, with one of the latex2html tools available (hevea for > example). > > Releasing html documentation only is not a nice thing. Good points again. One advantage worth mentioning about sgml/xml representation of the documentation is that transformations will be much easier to implement than if the native output format is latex. Patrick ------------------- To unsubscribe, mail caml-list-request@inria.fr. Archives: http://caml.inria.fr