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 690602 - \cond \endcond not processed with /// style comments
\cond \endcond not processed with /// style comments
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
1.8.2
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2012-12-21 10:37 UTC by MariusBelfor
Modified: 2012-12-26 16:09 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description MariusBelfor 2012-12-21 10:37:21 UTC
If you writes comments including \cond and \endcond tags in the following style, doxygen will generate a warning: "Found \endcond command without matching \cond"

/// \cond CONDITION
/// \brief Brief description
///
/// \param p Parameter
void function(p);
/// \endcond

Workarounds to solve this problem can be:

1. Mixing documentation style like,

/** \cond CONDITION */
/// \brief Brief description
///
/// \param p Parameter
void function(p);
/** \endcond */

2. or adding extra lines of /// like,

///
/// \cond CONDITION
/// \brief Brief description
///
/// \param p Parameter
void function(p);
/// \endcond
///
Comment 1 Dimitri van Heesch 2012-12-21 10:41:16 UTC
Confirmed. Should be fixed in the next release.
Comment 2 MariusBelfor 2012-12-21 11:59:09 UTC
I have to correct myself ... it seems you need to use

///
/// \endcond

instead of

/// \endcond
///
Comment 3 Dimitri van Heesch 2012-12-26 16:09:30 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.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.