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 719639 - @xrefitem with empty heading string
@xrefitem with empty heading string
Status: VERIFIED FIXED
Product: doxygen
Classification: Other
Component: build
1.8.5
Other Windows
: Normal enhancement
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2013-12-01 13:38 UTC by albert
Modified: 2013-12-29 18:09 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description albert 2013-12-01 13:38:03 UTC
In case parameter "(heading)" of the @xrefitem is the empty string no heading is generated. This can be useful when used in combination with the \page command e.g.

/** @page my_errors My Errors
 *  @brief Errors page
 *
 *  Errors page contents.
 */

/** \error ERROR 101: in case a file can not be opened.
    Check about file system read/write access. */
#define MY_ERR_CANNOT_OPEN_FILE                   101

/** \error ERROR 102: in case a file can not be closed.
    Check about file system read/write access. */
#define MY_ERR_CANNOT_CLOSE_FILE                  102

with \error defined as
  ALIASES += "error=\xrefitem my_errors \"\" \"\"" 

Currently when the "(heading)" is left empty a click-able colon remains in the HTML output.
Comment 1 albert 2013-12-01 13:46:07 UTC
If just pushed a fix to git (pull request 61)
Comment 2 Dimitri van Heesch 2013-12-07 22:26:35 UTC
Thanks, I've just merged the pull request.
Comment 3 Dimitri van Heesch 2013-12-24 18:59:42 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.6. 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 (preferrably in the form of a self-contained example).
Comment 4 albert 2013-12-29 18:09:25 UTC
Verified. In version 1.8.6 the problem of the clickable colon is solved.