Browse thread
Re: [Caml-list] Re: [Caml-announce] OCamldoc
- Benjamin C. Pierce
[
Home
]
[ Index:
by date
|
by threads
]
[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
[ 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