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-10 (14:10)
From: Jacques Garrigue <garrigue@k...>
Subject: Re: [Caml-list] Re: [Caml-announce] OCamldoc
From: Sven <>
> On Wed, Oct 10, 2001 at 07:08:05AM -0400, 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.
> Personnaly, i would be very strongly against using indentation to define if
> the stuff is before or after, after all, not everyone wants to indent things
> the same way.

I think that the above rules match rather closely what most people
write anyway. A documentation tool is based on conventions, as visual
as possible (you want to read the comments in the source too).

And I understand Benjamin Pierce's resistance to a multiplication of
strange symbols: they are harder to read than indentation.

But what am I doing in a discussion on automatic documentation, while
I almost never write any comment :-(


Jacques Garrigue
Bug reports:  FAQ:
To unsubscribe, mail  Archives: