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 NAA19858; Fri, 11 May 2001 13:58:54 +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 NAA19854 for ; Fri, 11 May 2001 13:58:53 +0200 (MET DST) Received: from cremant.inria.fr (cremant.inria.fr [128.93.8.143]) by concorde.inria.fr (8.11.1/8.10.0) with ESMTP id f4BBwof03884; Fri, 11 May 2001 13:58:50 +0200 (MET DST) Received: (from lefessan@localhost) by cremant.inria.fr (8.11.0/8.11.0) id f4BBwoc11297; Fri, 11 May 2001 13:58:50 +0200 X-Authentication-Warning: cremant.inria.fr: lefessan set sender to fabrice.le_fessant@inria.fr using -f From: Fabrice Le Fessant MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <15099.54264.965247.51247@cremant.inria.fr> Date: Fri, 11 May 2001 13:58:48 +0200 (CEST) To: Patrick M Doane Cc: caml-list@inria.fr Subject: Re: [Caml-list] CDK binary release References: <15098.23852.403551.65183@cremant.inria.fr> X-Mailer: VM 6.75 under Emacs 20.7.1 Reply-To: fabrice.le_fessant@inria.fr Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk > On Thu, 10 May 2001, 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. > > Out of curiosity, who wants to be reading Ocaml documentation through man > pages? I would think HTML and texinfo would both be nicer formats to work > with. Is there some advantage that I'm missing? You mean that, because you don't like man pages, nobody like them ? HTML is already supported, I have nothing against texinfo. But, do you know a tool to generate it from all the mli files from the CDK (that use different formatting conventions) ? Can you send me a patch to the CDK to use it ? Are you sure it is installed on all computers that will compile the CDK documentation ? For LaTeX, we will not force people to use LaTeX to document their interfaces: most comments are simple text lines including some pieces of code (in cdk_doc, they simply have to be between brackets). Only section titles have to be handled differently. cdk_doc is enough for that. New output formats have to be added, and all interfaces have to be completely translated to the input format ... We are not writting a book, but only a reference manual, thus, we don't need SGML or complicated formatting tool for that ! - Fabrice ------------------- To unsubscribe, mail caml-list-request@inria.fr. Archives: http://caml.inria.fr