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 BAA32011; Sat, 12 May 2001 01:25:21 +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 BAA32002 for ; Sat, 12 May 2001 01:25:09 +0200 (MET DST) Received: from shell5.ba.best.com (shell5.ba.best.com [206.184.139.136]) by concorde.inria.fr (8.11.1/8.10.0) with ESMTP id f4BNP5f20711; Sat, 12 May 2001 01:25:05 +0200 (MET DST) Received: from localhost (bpr@localhost) by shell5.ba.best.com (8.9.3/8.9.2/best.sh) with ESMTP id QAA27465; Fri, 11 May 2001 16:24:58 -0700 (PDT) Date: Fri, 11 May 2001 16:24:58 -0700 (PDT) From: Brian Rogoff To: Fabrice Le Fessant cc: Patrick M Doane , caml-list@inria.fr Subject: Re: [Caml-list] CDK binary release In-Reply-To: <15099.54264.965247.51247@cremant.inria.fr> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk On Fri, 11 May 2001, Fabrice Le Fessant wrote: > 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 ! I think that's the main point of disagreement. I'd like a source documentation tool which will scale up to writing books (unlikely) or at least magazine or journal article like things. I'd also prefer not to have a separate tool and source of embedded comment information just for documenting interfaces, like JavaDoc. Latex seems to be able to fill that role, there is a wealth of experience using it, and now there is hevea, ocamlweb, and mldoc. I don't know enough about the state of SGML or XML tools to know how they fare against my desires. I'm leaning to the Latex approach now. -- Brian ------------------- To unsubscribe, mail caml-list-request@inria.fr. Archives: http://caml.inria.fr