Page 1 of 1

Syntax Coloring for DoxyGen comments

Posted: Thu Jan 21, 2010 9:35 pm
by apa
Hi,

this is a very small observation ...

Say, your C code (actually an .h file) has the following DoxyGen-style documentation

Code: Select all

@subsection SEC1 MySection1
some text here
@code 
void MyExampleFunc(int Par1) {
...
/* this is some multi-line comment that spawns
over 
multiple lines
*/
...
}
@endcode 
And here we have some more DoxyGen documentation. Unfortunately, this documentation 
is coloured not as "comment", but as "regular code". 
If I remove the closing comment tag ("*/") and/or replace everything with single-line comments ("//"), the
colouring works fine.

Rgds
Arndt

Re: Syntax Coloring for DoxyGen comments

Posted: Thu Jan 21, 2010 9:53 pm
by eranif
This is because that C style comment can not be nested (this is the C/C++ restrictions) it will always end up at the first closing characters sequence ('*/')

So, there is no such thing as "this is some multi-line comment that spawns".
Eran

Re: Syntax Coloring for DoxyGen comments

Posted: Thu Jan 21, 2010 10:35 pm
by apa
thx for the explanation
Arndt