emacs c-mode

emacs c-mode

[Hadron]

A small bug or something I am missing?

Consider comment (1) below:

/*
 * task_nice - return the nice value of a given task.
 * @p: the task in question.
 */

describe face reveals it as 

font-lock-comment-face

All is highlighted as I would expect based on my customised faces.

However, comment block (2) below (note the second asterisk on line 1):

/**
 * task_nice - return the nice value of a given task.
 * @p: the task in question.
 */

Here the face is

font-lock-doc-face

Is this correct? Is /** supposed to be something special?

c-version is 5.31.3

Re: emacs c-mode

[Lennart Borgman (gmail)]

Hadron wrote:
> A small bug or something I am missing?
> 
> Consider comment (1) below:
> 
> /*
>  * task_nice - return the nice value of a given task.
>  * @p: the task in question.
>  */
> 
> describe face reveals it as 
> 
> font-lock-comment-face
> 
> All is highlighted as I would expect based on my customised faces.
> 
> However, comment block (2) below (note the second asterisk on line 1):
> 
> /**
>  * task_nice - return the nice value of a given task.
>  * @p: the task in question.
>  */
> 
> Here the face is
> 
> font-lock-doc-face
> 
> Is this correct? Is /** supposed to be something special?

It is special in Java, but I do not think it is so in C/C++.

> c-version is 5.31.3

Re: emacs c-mode

[Karl Hegbloom]

On Thu, 2007-04-19 at 17:23 +0200, Hadron wrote:
> A small bug or something I am missing?
>  [...]
> Is this correct? Is /** supposed to be something special?

Doxygen: http://www.doxygen.org/ ... is in widespread use.  It provides
something very much like Javadoc markup for C and C++ sources.

Re: emacs c-mode

[Daniel]

Karl Hegbloom wrote:

> On Thu, 2007-04-19 at 17:23 +0200, Hadron wrote:
>> A small bug or something I am missing?
>>  [...]
>> Is this correct? Is /** supposed to be something special?
> 
> Doxygen: http://www.doxygen.org/ ... is in widespread use.  It provides
> something very much like Javadoc markup for C and C++ sources.

There are two variables concerning doc-comments: 
c-doc-comment-style and c-doc-comment-start-regexp.

The first one is a c-style-variable and the buffer-local setting 
of the latter is derived from that, I think.

Do you use any specific c-style, Hadron?

Have fun
----Daniel

Re: emacs c-mode

[Hadron]

Daniel <daniel@warum-ada.de> writes:

> Karl Hegbloom wrote:
>
>> On Thu, 2007-04-19 at 17:23 +0200, Hadron wrote:
>>> A small bug or something I am missing?
>>>  [...]
>>> Is this correct? Is /** supposed to be something special?
>>
>> Doxygen: http://www.doxygen.org/ ... is in widespread use.  It provides
>> something very much like Javadoc markup for C and C++ sources.
>
> There are two variables concerning doc-comments: c-doc-comment-style
> and c-doc-comment-start-regexp.
>
> The first one is a c-style-variable and the buffer-local setting of
> the latter is derived from that, I think.
>
> Do you use any specific c-style, Hadron?


K&R

Re: emacs c-mode

[Daniel]

Hadron wrote:

> Daniel <daniel@warum-ada.de> writes:
> 
>> Karl Hegbloom wrote:
>>
>>> On Thu, 2007-04-19 at 17:23 +0200, Hadron wrote:
>>>> A small bug or something I am missing?
>>>>  [...]
>>>> Is this correct? Is /** supposed to be something special?
>>> Doxygen: http://www.doxygen.org/ ... is in widespread use.  It provides
>>> something very much like Javadoc markup for C and C++ sources.
>> There are two variables concerning doc-comments: c-doc-comment-style
>> and c-doc-comment-start-regexp.
>>
>> The first one is a c-style-variable and the buffer-local setting of
>> the latter is derived from that, I think.
>>
>> Do you use any specific c-style, Hadron?
> 
> 
> K&R

Aah, and you're coding C, not C++, right?  In my GNU Emacs 
22.0.93.1, the default doc-comment style for C is `gtkdoc', which 
also uses `/**' as opener for doc-comment blocks.  Maybe it's 
because your c-doc-comment-style setting is not `set-from-style'?
I don't think it stems from the k&r style.