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 NAA01758; Tue, 22 May 2001 13:49:59 +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 NAA01753 for ; Tue, 22 May 2001 13:49:58 +0200 (MET DST) Received: from miss.wu-wien.ac.at (miss.wu-wien.ac.at [137.208.107.17]) by nez-perce.inria.fr (8.11.1/8.10.0) with ESMTP id f4MBnvH02431; Tue, 22 May 2001 13:49:57 +0200 (MET DST) Received: (from mottl@localhost) by miss.wu-wien.ac.at (8.9.0/8.9.0) id NAA26595; Tue, 22 May 2001 13:49:56 +0200 (MET DST) Date: Tue, 22 May 2001 13:49:56 +0200 From: Markus Mottl To: Fabrice Le Fessant Cc: caml-list@inria.fr Subject: Re: [Caml-list] New CDK documentation Message-ID: <20010522134955.A32228@miss.wu-wien.ac.at> References: <15114.11808.906797.96108@cremant.inria.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <15114.11808.906797.96108@cremant.inria.fr>; from fabrice.le_fessant@inria.fr on Tue, May 22, 2001 at 11:15:12 +0200 Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk On Tue, 22 May 2001, Fabrice Le Fessant wrote: > After the discussion on which format should be used for the CDK, we > implemented a new version of cdk_doc generating texinfo files. The > results (DVI, Postscript, Info, HTML and PDF) can be seen on: The set of target formats is sufficiently large with this option, and output looks reasonably nice. The power of texinfo is probably high enough to cover around 99% of all uses. It's not clear that the remaining 1% should actually be written as interface documentation anyway: seperately written Latex-documentation might be the better choice then. I think I could live with this option, but before I adopt it, I'd really want to make sure that it has a chance of becoming "the" standard. I already suffer enough when I have to write documentation once. Having to do this even more often due to shifting standards would ruin my life... ;) Any chance that we could jointly agree on this? 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