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 555327 - When referencing a file using @ref converts it to file::ext
When referencing a file using @ref converts it to file::ext
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: build
1.5.4
Other Windows
: Normal minor
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2008-10-07 01:21 UTC by andrew
Modified: 2012-02-25 15:37 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Doxygen Test example with problem added (1.04 KB, application/zip)
2008-10-07 01:23 UTC, andrew
Details

Description andrew 2008-10-07 01:21:32 UTC
This is a minor bug.  I was using @ref to add a link to a file of example.  But in the generated html, it looked like a class function (file_name.extension).


To reproduce this problem, I used the test example (shown below)
--------------------------------------------------------------------
/** A Test class.
 *  More details about this class.
 *
 * See example @ref example_test.cpp
 */

class Test
{
  public:
    /** An example member function.
     *  More details about this function.
     */
    void example();
};

void Test::example() {}

/** \example example_test.cpp
 * This is an example of how to use the Test class.
 * More details about this example.
 */

--------------------------------------------------------------------

The output looks like this

Detailed Description
A Test class.

More details about this class.

See example example_test::cpp  <- THE PROBLEM!!!

Examples:

    example_test.cpp.
Comment 1 andrew 2008-10-07 01:23:30 UTC
Created attachment 120075 [details]
Doxygen Test example with problem added

This is the Test example with the added ref line to link the class to the example.
Comment 2 Jakob van Bethlehem 2011-12-07 20:59:40 UTC
Bug confirmed to be present in doxygen 1.7.6
Comment 3 Dimitri van Heesch 2012-01-22 18:42:22 UTC
Confirmed. Should be fixed in the next subversion update.
Comment 4 Dimitri van Heesch 2012-02-25 15:37:31 UTC
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.0. 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.