[Caml-list] Re: Emacs comment support (was OCamldoc)

[Patrick M Doane <patrick@watson.org>]

On Wed, 10 Oct 2001, Sven wrote:

> On Wed, Oct 10, 2001 at 01:07:19PM -0400, Patrick M Doane wrote:
> > 
> > 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 ?).

This reminds me of a current gripe with the Tuareg mode (and I believe the
O'Caml mode that comes with the distribution has the same issue). If I
have a multi-line comment line this: 

 (* line 1
  * line 2
  * line 3 
  *)

and then hit M-q to refill the region I get:

 (* line 1 * line 2 * line 3 *)

In the C mode, refilling a similar comment produces

 /* line 1 line 2 line 3 */

and multiline comments maintain the '*' pattern appropriately on each
line. I have no idea how to implement Emacs modes, but does anyone have
any idea how difficult it would be to fix this? Editing documentation in
comments can be very tedious because of the need to manually refill
paragraphs.

Patrick

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