Version française
Home     About     Download     Resources     Contact us    
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: -- (:)
From: Sven <luther@d...>
Subject: Re: [Caml-list] Re: [Caml-announce] OCamldoc
On Wed, Oct 10, 2001 at 01:07:19PM -0400, Patrick M Doane wrote:
> On Wed, 10 Oct 2001, Benjamin C. Pierce wrote:
> 
> > 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.
> 
> This proposal looks perfect to me.
> 
> I've also noticed in the manual that all of the multi-line comment
> examples are like this:
> 
>  (**  line 1
>       line 2
>       line 3 *)
> 
> Will there be any issues with writing comments like this?
> 
>  (** line 1
>   *  line 2
>   *  line 3
>   *)

Yes, this is nice, and the extra * may even be provided by your editor
automatically, like what happens with C code, provided the corresponding
vim/emacs rules are extended accordyingly (but then maybe vim 6 can already do
thi ?).

Friendly,

Sven Luther
-------------------
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