caml-list - the Caml user's mailing list
 help / color / mirror / Atom feed
* [Caml-list] Quotes in comments: (* " *)
@ 2003-12-17 15:22 Richard Jones
  2003-12-17 15:54 ` Kim Nguyen
                   ` (2 more replies)
  0 siblings, 3 replies; 7+ messages in thread
From: Richard Jones @ 2003-12-17 15:22 UTC (permalink / raw)
  To: caml-list


Is there a deep reason why the compiler is fussed by unmatched quotes
appearing in comments, ie: (* " *) ?

I have a problem where tuareg-mode is getting confused by a quote
character, in fact in this line:

 let chars = ['\\';'/';':';'*';'\'';'"'] in

and I can fix tuareg-mode by adding (* " *) at the end of the line,
but then the compiler barfs. So the only way to work around the
tuareg-mode bug would seem to be to actually alter the code itself,
which is not what I want to do.

It seems better all round if the compiler treated comments as
comments, ie. ignoring them.

Rich.

-- 
Richard Jones. http://www.annexia.org/ http://freshmeat.net/users/rwmj
Merjis Ltd. http://www.merjis.com/ - improving website return on investment
MONOLITH is an advanced framework for writing web applications in C, easier
than using Perl & Java, much faster and smaller, reusable widget-based arch,
database-backed, discussion, chat, calendaring:
http://www.annexia.org/freeware/monolith/

-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners


^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [Caml-list] Quotes in comments: (* " *)
  2003-12-17 15:22 [Caml-list] Quotes in comments: (* " *) Richard Jones
@ 2003-12-17 15:54 ` Kim Nguyen
  2003-12-17 17:02   ` Richard Jones
  2003-12-18 13:52 ` Hendrik Tews
  2003-12-18 17:05 ` Xavier Leroy
  2 siblings, 1 reply; 7+ messages in thread
From: Kim Nguyen @ 2003-12-17 15:54 UTC (permalink / raw)
  To: caml-list; +Cc: Richard Jones

[-- Attachment #1: Type: text/plain, Size: 710 bytes --]

On Wed, 17 Dec 2003 15:22:32 +0000
Richard Jones <rich@annexia.org> wrote:

> 
> Is there a deep reason why the compiler is fussed by unmatched quotes
> appearing in comments, ie: (* " *) ?

This seems necessary to ensure that any piece of code can easily be commented out :

(* This is a valid comment

let print_close_comment () = print_string "*)" <-- the comment does not end here.

*)

So the comment part of the  lexer needs to analyse strings as well to igonre any "*)" character sequence within a
string. And therefore, it fails when a string is unterminated.

See http://caml.inria.fr/FAQ/FAQ_EXPERT-eng.html#commentaire

IMHO, the bug should be corrected in tuareg-mode (if possible).

Cheers,

Kim.

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [Caml-list] Quotes in comments: (* " *)
  2003-12-17 15:54 ` Kim Nguyen
@ 2003-12-17 17:02   ` Richard Jones
  2003-12-17 23:09     ` William Lovas
  0 siblings, 1 reply; 7+ messages in thread
From: Richard Jones @ 2003-12-17 17:02 UTC (permalink / raw)
  Cc: caml-list

[-- Attachment #1: Type: text/plain, Size: 1071 bytes --]

I've had a few replies along the lines that "(*" or "*)" is valid
code, and hence all this quoting comments stuff is justified.  I have
to say that writing such code is amazingly rare (perhaps only compiler
writers will write this, and then only once in their lives), whereas
I've encountered the problems with quotes in comments routinely since
I started using OCaml.  I doubt I'm alone in this.  I actually have
a small collection of programs now which have lines like this:

  (* ... some comment which contains an odd number of quotes ...

  [Keep OCaml compiler happy -->] " *)

I think the behaviour is counter-intuitive, and should be classified
as a bug, along with the other annoyance of being unable to write
let f = printf "** %i" and have it do what you expect.

Rich.

-- 
Richard Jones. http://www.annexia.org/ http://freshmeat.net/users/rwmj
Merjis Ltd. http://www.merjis.com/ - improving website return on investment
Learning Objective CAML for C, C++, Perl and Java programmers:
http://www.merjis.com/richj/computers/ocaml/tutorial/

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [Caml-list] Quotes in comments: (* " *)
  2003-12-17 17:02   ` Richard Jones
@ 2003-12-17 23:09     ` William Lovas
  2003-12-18  3:47       ` Dustin Sallings
  0 siblings, 1 reply; 7+ messages in thread
From: William Lovas @ 2003-12-17 23:09 UTC (permalink / raw)
  To: caml-list

On Wed, Dec 17, 2003 at 05:02:31PM +0000, Richard Jones wrote:
> [...] I doubt I'm alone in this.  I actually have
> a small collection of programs now which have lines like this:
> 
>   (* ... some comment which contains an odd number of quotes ...
> 
>   [Keep OCaml compiler happy -->] " *)
> 
> I think the behaviour is counter-intuitive, and should be classified
> as a bug, [...]

Funny, i always found the opposite behavior to be the more counter-
intuitive of the two.  (And if you want C/Java behavior, you know
where to get it.)

What circumstances lead you to produce comments that contain an odd
number of quotes?

William

-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners


^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [Caml-list] Quotes in comments: (* " *)
  2003-12-17 23:09     ` William Lovas
@ 2003-12-18  3:47       ` Dustin Sallings
  0 siblings, 0 replies; 7+ messages in thread
From: Dustin Sallings @ 2003-12-18  3:47 UTC (permalink / raw)
  To: William Lovas; +Cc: caml-list


On Dec 17, 2003, at 15:09, William Lovas wrote:

> What circumstances lead you to produce comments that contain an odd
> number of quotes?

	I've had to do that in the past to make vim's syntax highlighting 
happy.

--
SPY                      My girlfriend asked me which one I like better.
pub  1024/3CAE01D5 1994/11/03 Dustin Sallings <dustin@spy.net>
|    Key fingerprint =  87 02 57 08 02 D0 DA D6  C8 0F 3E 65 51 98 D8 BE
L_______________________ I hope the answer won't upset her. ____________

-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners


^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [Caml-list] Quotes in comments: (* " *)
  2003-12-17 15:22 [Caml-list] Quotes in comments: (* " *) Richard Jones
  2003-12-17 15:54 ` Kim Nguyen
@ 2003-12-18 13:52 ` Hendrik Tews
  2003-12-18 17:05 ` Xavier Leroy
  2 siblings, 0 replies; 7+ messages in thread
From: Hendrik Tews @ 2003-12-18 13:52 UTC (permalink / raw)
  To: caml-list


Richard Jones writes:
   
   I have a problem where tuareg-mode is getting confused by a quote
   character, in fact in this line:
   
    let chars = ['\\';'/';':';'*';'\'';'"'] in

What about adding this comment:
			(* help tuareg fontification '"' *)
?

Bye,

Hendrik

-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners


^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [Caml-list] Quotes in comments: (* " *)
  2003-12-17 15:22 [Caml-list] Quotes in comments: (* " *) Richard Jones
  2003-12-17 15:54 ` Kim Nguyen
  2003-12-18 13:52 ` Hendrik Tews
@ 2003-12-18 17:05 ` Xavier Leroy
  2 siblings, 0 replies; 7+ messages in thread
From: Xavier Leroy @ 2003-12-18 17:05 UTC (permalink / raw)
  To: Richard Jones; +Cc: caml-list

> I have a problem where tuareg-mode is getting confused by a quote
> character, in fact in this line:
> 
>  let chars = ['\\';'/';':';'*';'\'';'"'] in
> 
> and I can fix tuareg-mode by adding (* " *) at the end of the line,
> but then the compiler barfs.

I suggest writing '\"' instead of '"'.  It means the same thing,
but Emacs fontification code seems to understand that \" isn't a
string delimiter.

- Xavier Leroy

-------------------
To unsubscribe, mail caml-list-request@inria.fr Archives: http://caml.inria.fr
Bug reports: http://caml.inria.fr/bin/caml-bugs FAQ: http://caml.inria.fr/FAQ/
Beginner's list: http://groups.yahoo.com/group/ocaml_beginners


^ permalink raw reply	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2003-12-18 17:06 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2003-12-17 15:22 [Caml-list] Quotes in comments: (* " *) Richard Jones
2003-12-17 15:54 ` Kim Nguyen
2003-12-17 17:02   ` Richard Jones
2003-12-17 23:09     ` William Lovas
2003-12-18  3:47       ` Dustin Sallings
2003-12-18 13:52 ` Hendrik Tews
2003-12-18 17:05 ` Xavier Leroy

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).