[Doxygen-users] comments in comments

[Volker B. <vbo...@te...>]

Hi,

beside documenting code we are using doxygen also for some specification
documents (using \page). Until some weeks ago one could use /* */ -
comments inside a \page for comments that were ignored by doxygen. This
(undocumented!) feature is broken now. Instead such comments lead to
parsing errors. It seems as if doxygen takes the closing '*/' as the end
of the comment-block. A warning 'comment inside a comment' would be
helpful. (Note that these pages are never compiled so no compiler will do
this job.)

Looking for a replacement I figured out that XML-style comments work
instead. Since I couldn't find this feature documented anywhere (I'ld
expect it in the "HTML Commands" section), I'ld like to know if this
feature is "officially" supported or not.

A little example that shows the problem (but gives no doxygen error
messages):

/** @page specs Technische Spezifikation
/*  $Id: specs.dox,v 1.10 2002/01/07 08:22:39 vboerchers Exp $  */
text
*/

Regards,
Volker
--=20
Volker Boerchers <vbo...@te...>
System Engineer
TECON Systems AG, Perlengraben 2, 50676 K=F6ln, http://www.tecon.de
Tel: +49-221-92007-55, Fax: +49-221-92007-77