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 NAA12635; Wed, 10 Oct 2001 13:08:10 +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 NAA12382 for ; Wed, 10 Oct 2001 13:08:09 +0200 (MET DST) Received: from saul.cis.upenn.edu (SAUL.CIS.UPENN.EDU [158.130.12.4]) by concorde.inria.fr (8.11.1/8.10.0) with ESMTP id f9AB87123630; Wed, 10 Oct 2001 13:08:07 +0200 (MET DST) Received: from localhost (localhost [127.0.0.1]) by saul.cis.upenn.edu (8.10.1/8.10.1) with SMTP id f9AB85x04068; Wed, 10 Oct 2001 07:08:05 -0400 (EDT) To: "Dave Berry" cc: "Maxence Guesdon" , "Jerome Vouillon" , "Francois Pottier" , caml-list@inria.fr Reply-to: bcpierce@cis.upenn.edu Subject: Re: [Caml-list] Re: [Caml-announce] OCamldoc In-reply-to: Your message of Tue, 09 Oct 2001 13:30:30 +0100. <8E31D6933A2FE64F8AE3CC1381EEDCE7140166@NT.kal.com> Date: Wed, 10 Oct 2001 07:08:05 EDT Message-ID: <4066.1002712085@saul.cis.upenn.edu> From: "Benjamin C. Pierce" 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. Aha -- sorry, I did miss the point. So I'd like to make another a variant proposal... :-) - The comment is before the element: (** fun 1 *) val f : t (** fun 2 *) val g : u - The comment is after the element: val f : t (** fun 1 *) val g : u (** fun 2 *) - The comment is on the same line as the element: val f : t (** fun 1 *) val g : u (** fun 2 *) (Most useful for record fields, probably.) I.e., *one* kind of (not very) funny comment marker, plus using the indentation to decide whether the comment binds to the expression before or after: if the comment is on a line by itself, then if its indentation is the same as the following (non-comment) line then it goes with the following else it goes with the preceding else it goes with the line it's on. -- B ----------------------------------------------------------------------------- BENJAMIN C. PIERCE Associate Prof., Computer & Information Science bcpierce@cis.upenn.edu University of Pennsylvania +1 215 898-2012 200 South 33rd St. Fax: +1 215 898-0587 Philadelphia, PA 19104, USA http://www.cis.upenn.edu/~bcpierce ----------------------------------------------------------------------------- ------------------- 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