Version française
Home     About     Download     Resources     Contact us    

This site is updated infrequently. For up-to-date information, please visit the new OCaml website at

Browse thread
RE: [Caml-list] Re: [Caml-announce] OCamldoc
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: 2001-10-09 (12:32)
From: Dave Berry <Dave@k...>
Subject: RE: [Caml-list] Re: [Caml-announce] OCamldoc
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.


-----Original Message-----
From: Benjamin C. Pierce []
Sent: 09 October 2001 13:14
To: Dave Berry
Cc: Maxence Guesdon; Jerome Vouillon; Francois Pottier;
Subject: Re: [Caml-list] Re: [Caml-announce] OCamldoc 

Let me enter a plea here for *not* introducing a dozen different kinds
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.


Bug reports:  FAQ:
To unsubscribe, mail  Archives: