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 OAA22434; Tue, 9 Oct 2001 14:32:45 +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 OAA22345 for ; Tue, 9 Oct 2001 14:32:44 +0200 (MET DST) Received: from mrwall.kal.com (mrwall.kal.com [194.193.14.236]) by concorde.inria.fr (8.11.1/8.10.0) with SMTP id f99CWhX03724; Tue, 9 Oct 2001 14:32:43 +0200 (MET DST) Received: from mrwall.kal.com [194.193.14.236] (HELO localhost) by mrwall.kal.com (AltaVista Mail V2.0J/2.0J BL25J listener) id 0000_0051_3bc2_ef17_9f67; Tue, 09 Oct 2001 13:35:35 +0100 Subject: RE: [Caml-list] Re: [Caml-announce] OCamldoc MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Date: Tue, 9 Oct 2001 13:30:30 +0100 Message-ID: <8E31D6933A2FE64F8AE3CC1381EEDCE7140166@NT.kal.com> X-MimeOLE: Produced By Microsoft Exchange V6.0.4417.0 content-class: urn:content-classes:message Thread-Topic: [Caml-list] Re: [Caml-announce] OCamldoc Thread-Index: AcFQu6vdaskPIEM9TdSQI27yTU1IYgAApZcw From: "Dave Berry" To: Cc: "Maxence Guesdon" , "Jerome Vouillon" , "Francois Pottier" , Sender: owner-caml-list@pauillac.inria.fr Precedence: bulk I think you missed the point of Jerome's suggestion, which was (** ... *) vs. (* ... **). (Either that, or I missed his point...). So my variant was to show the difference at the start of each comment, where it would be more immediate. Anyway, we're not talking about a dozen markers, just two: one for comments that precede items, and one for comments that follow them. Admittedly my variant uses two more characters, and could be considered more intrusive for that reason. Dave. -----Original Message----- From: Benjamin C. Pierce [mailto:bcpierce@saul.cis.upenn.edu] Sent: 09 October 2001 13:14 To: Dave Berry Cc: Maxence Guesdon; Jerome Vouillon; Francois Pottier; caml-list@inria.fr Subject: Re: [Caml-list] Re: [Caml-announce] OCamldoc=20 Let me enter a plea here for *not* introducing a dozen different kinds of funny markers in comments. One of the nice features of the original proposal was that it doesn't uglify the source code very much -- please let's keep that. For the record, I like Jerome's idea of using just indentation to figure out which comment goes with which declaration. B ------------------- Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/ To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr