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: Benjamin C. Pierce <bcpierce@s...>
Subject: Re: [Caml-list] Re: [Caml-announce] OCamldoc
> How about a variation on Jerome's suggestion:
> 
> - 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 *)

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