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 QAA30508; Mon, 14 May 2001 16:31:12 +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 QAA30504 for ; Mon, 14 May 2001 16:31:11 +0200 (MET DST) Received: from mailout01.sul.t-online.com (mailout01.sul.t-online.com [194.25.134.80]) by concorde.inria.fr (8.11.1/8.10.0) with ESMTP id f4EEV9529981 for ; Mon, 14 May 2001 16:31:09 +0200 (MET DST) Received: from fwd06.sul.t-online.de by mailout01.sul.t-online.com with smtp id 14zJNd-0003h0-05; Mon, 14 May 2001 16:31:25 +0200 Received: from pD9019F58.dip.t-dialin.net (340009195196-0001@[217.1.159.88]) by fwd06.sul.t-online.com with esmtp id 14zJNd-2ACPq4C; Mon, 14 May 2001 16:31:25 +0200 Date: Mon, 14 May 2001 16:36:49 +0200 (CEST) From: markus.kliegl@t-online.de (markus.kliegl) To: caml-list@pauillac.inria.fr Subject: Re: [Caml-list] Documentation tools In-Reply-To: <20010514101144.A22215@pauillac.inria.fr> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Sender: 340009195196-0001@t-dialin.net Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk On Mon, 14 May 2001, Xavier Leroy wrote: ... > > Suggestions and pointers to existing documentation systems are most > welcome. Well, besides the documentation generation stuff, I also like the documentation strings of lisp (i.e. (describe 'xyz) and the comments of objects in smalltalk (i.e. Integer comment printnl!). Something similar to this in Ocaml would be great. Perhaps a let...with_comment... construct? As in: let f x y = ... with_comment "f takes two arguments..." This could also easily be used for the documentation generation. But I'm rather new to Ocaml, so I'm not sure if anything I just said made sense :-) > > - Xavier Leroy > ------------------- > To unsubscribe, mail caml-list-request@inria.fr. Archives: http://caml.inria.fr > Markus Kliegl ------------------- To unsubscribe, mail caml-list-request@inria.fr. Archives: http://caml.inria.fr