After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 607743 - \internal confuses conditional \if
\internal confuses conditional \if
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
1.6.1
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2010-01-22 09:45 UTC by Michael Stockman
Modified: 2010-02-21 12:57 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Michael Stockman 2010-01-22 09:45:29 UTC 
Hello,

I have a documentation file that I share between different doxygen configuration
 to produce different web and printed documentation, and also different for a few variants of our software. It looks generally like this:

/** \if A1_DOC
\page a1_info A1 software general information

Some public information applicable when the A1 module is included.

\internal

Some internal information applicable when the A1 module is included.

\endif
 */

When A1_DOC is included and INTERNAL_DOCS=NO then this produces the warning:  "Documentation block ended in the middle of a conditional section!".

It seems to work okay though as long as one can live with the warning.
Comment 1 Dimitri van Heesch 2010-02-20 14:06:20 UTC 
Confirmed. Should be fixed in the next release.
Comment 2 Dimitri van Heesch 2010-02-21 12:57:31 UTC 
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.6.3. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information 
that you think can be relevant.