GNU bug report logs - #3417
c-mode uses font-lock-doc-face for /**

Previous Next

Full log

View this message in rfc822 format

From: Antoine Levitt <antoine.levitt <at> gmail.com>
To: martin rudalics <rudalics <at> gmx.at>
Cc: 3417 <at> debbugs.gnu.org
Subject: bug#3417: c-mode uses font-lock-doc-face for /**
Date: Fri, 29 May 2009 19:03:05 +0200

[Message part 1 (text/plain, inline)]

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

[Message part 2 (text/html, inline)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.