bug#3417: c-mode uses font-lock-doc-face for /**

bug#3417: c-mode uses font-lock-doc-face for /**

[Antoine Levitt]

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

Compare :
/**
some file
*/
with
/*
some file
*/

In the first case, font-lock-doc-face is used, in the second
font-lock-comment-face is.

The first example fontifies with doc-face only if there is just "/**" :
"/*", "/** " (with a space) or "/***", for instance, use the standard
comment-face.

This is using emacs 23.0.94.1, and was reproduced on emacs22 as well. C++
and obj-C aren't affected, and java also shows this behavior on "/***"" and
"/** "/

This behavior is certainly unexpected : I expect all comments to be
fontified with the same face. Am I right in thinking it's a bug ?

Antoine

[-- Attachment #2: Type: text/html, Size: 729 bytes --]

bug#3417: marked as done (c-mode uses font-lock-doc-face for /**)

[Emacs bug Tracking System]

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


Your message dated Fri, 29 May 2009 12:01:38 -0400
with message-id <jwvprdrnbkf.fsf-monnier+emacsbugreports@gnu.org>
and subject line Re: bug#3417: c-mode uses font-lock-doc-face for /**
has caused the Emacs bug report #3417,
regarding c-mode uses font-lock-doc-face for /**
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com
immediately.)


-- 
3417: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3417
Emacs Bug Tracking System
Contact owner@emacsbugs.donarmstrong.com with problems

[-- Attachment #2: Type: message/rfc822, Size: 4523 bytes --]

[-- Attachment #2.1.1: Type: text/plain, Size: 597 bytes --]

Compare :
/**
some file
*/
with
/*
some file
*/

In the first case, font-lock-doc-face is used, in the second
font-lock-comment-face is.

The first example fontifies with doc-face only if there is just "/**" :
"/*", "/** " (with a space) or "/***", for instance, use the standard
comment-face.

This is using emacs 23.0.94.1, and was reproduced on emacs22 as well. C++
and obj-C aren't affected, and java also shows this behavior on "/***"" and
"/** "/

This behavior is certainly unexpected : I expect all comments to be
fontified with the same face. Am I right in thinking it's a bug ?

Antoine

[-- Attachment #2.1.2: Type: text/html, Size: 729 bytes --]

[-- Attachment #3: Type: message/rfc822, Size: 1893 bytes --]

From: Stefan Monnier <monnier@IRO.UMontreal.CA>
To: Antoine Levitt <antoine.levitt@gmail.com>
Cc: 3417-done@emacsbugs.donarmstrong.com
Subject: Re: bug#3417: c-mode uses font-lock-doc-face for /**
Date: Fri, 29 May 2009 12:01:38 -0400
Message-ID: <jwvprdrnbkf.fsf-monnier+emacsbugreports@gnu.org>

> This behavior is certainly unexpected : I expect all comments to be
> fontified with the same face.  Am I right in thinking it's a bug ?

It's a feature. This comment format is used by doxygen (or somesuch).


        Stefan

bug#3417: c-mode uses font-lock-doc-face for /**

[martin rudalics]

 > Compare :
 > /**
 > some file
 > */
 > with
 > /*
 > some file
 > */
 >
 > In the first case, font-lock-doc-face is used, in the second
 > font-lock-comment-face is.
 >
 > The first example fontifies with doc-face only if there is just "/**" :
 > "/*", "/** " (with a space) or "/***", for instance, use the standard
 > comment-face.
 >
 > This is using emacs 23.0.94.1, and was reproduced on emacs22 as well. C++
 > and obj-C aren't affected, and java also shows this behavior on "/***"" and
 > "/** "/
 >
 > This behavior is certainly unexpected : I expect all comments to be
 > fontified with the same face. Am I right in thinking it's a bug ?

Have you tried to customize `c-doc-comment-style'?

martin

bug#3417: c-mode uses font-lock-doc-face for /**

[Antoine Levitt]

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

Using your variable as a starting point, I found this :
for gtkdoc (default in C), regexp is :
    (c-font-lock-doc-comments "/\\*\\*$" limit
      gtkdoc-font-lock-doc-comments)

for javadoc, it's :
(c-font-lock-doc-comments "/\\*\\*" limit
      javadoc-font-lock-doc-comments)))))

Gtkdoc manual specifies :

A multiline comment that starts with an additional '*' marks a documentation
block that will be processed by the Gtk-Doc tools.

Shouldn't the regexp for gtkdoc be "/\\*\\*" then ? (without the $)
2009/5/29 martin rudalics <rudalics@gmx.at>

> > Compare :
> > /**
> > some file
> > */
> > with
> > /*
> > some file
> > */
> >
> > In the first case, font-lock-doc-face is used, in the second
> > font-lock-comment-face is.
> >
> > The first example fontifies with doc-face only if there is just "/**" :
> > "/*", "/** " (with a space) or "/***", for instance, use the standard
> > comment-face.
> >
> > This is using emacs 23.0.94.1, and was reproduced on emacs22 as well. C++
> > and obj-C aren't affected, and java also shows this behavior on "/***""
> and
> > "/** "/
> >
> > This behavior is certainly unexpected : I expect all comments to be
> > fontified with the same face. Am I right in thinking it's a bug ?
>
> Have you tried to customize `c-doc-comment-style'?
>
> martin
>

[-- Attachment #2: Type: text/html, Size: 2026 bytes --]

bug#3417: c-mode uses font-lock-doc-face for /**

[martin rudalics]

 > Using your variable as a starting point, I found this :
 > for gtkdoc (default in C), regexp is :
 >     (c-font-lock-doc-comments "/\\*\\*$" limit
 >       gtkdoc-font-lock-doc-comments)
 >
 > for javadoc, it's :
 > (c-font-lock-doc-comments "/\\*\\*" limit
 >       javadoc-font-lock-doc-comments)))))
 >
 > Gtkdoc manual specifies :
 >
 > A multiline comment that starts with an additional '*' marks a documentation
 > block that will be processed by the Gtk-Doc tools.
 >
 > Shouldn't the regexp for gtkdoc be "/\\*\\*" then ? (without the $)

I don't have the slightest idea about these conventions.  That's in the
domain of Mr. Mackenzie.  Good evening, Alan ...

martin