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 739214 - Cannot make unscoped link to C++ conversion operator [with test case]
Cannot make unscoped link to C++ conversion operator [with test case]
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
1.8.8-GIT
Other All
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2014-10-26 16:28 UTC by Vladimír Vondruš
Modified: 2014-11-16 19:29 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Repro/test case (400 bytes, application/zip)
2014-10-26 16:28 UTC, Vladimír Vondruš
Details

Description Vladimír Vondruš 2014-10-26 16:28:31 UTC
Created attachment 289356 [details]
Repro/test case

See attached ZIP file for minimal repro case or the following snippet:

    /**
     * @brief Foo
     *
     * - operator int()
     * - @ref operator int()
     * - @ref operator int() "title"
     * - Foo::operator int()
     * - @ref Foo::operator int()
     * - @ref Foo::operator int() "title"
     */
    struct Foo {
        /** @brief Conversion to int */
        operator int();
    };

The generated HTML docs properly parse and document the int conversion operator, but none of the first three links work. The first one is not detected as link at all (no warning on output), the second and third produce a warning:

    operator.h:3: warning: unable to resolve reference to `operator' for \ref command
    operator.h:4: warning: unable to resolve reference to `operator' for \ref command

Interestingly enough, the second three (explicitly scoped) links work without issue, so that can be considered as workaround.

All other kinds of unscoped operator links (`operator=()`, `operator[]()` etc.) are working without issues. I admit that marking the conversion operator link implicit might bring up many false positives, so I'm all for making these links possible only with explicit @ref. Possibly related issues: #678643, #699465.

Tested with current Git (a31c9ff).
Comment 1 Dimitri van Heesch 2014-11-16 15:50:32 UTC
I'll follow your suggestions. Should be corrected in the next GIT update.
Comment 2 Vladimír Vondruš 2014-11-16 19:29:37 UTC
Just tested and works, thanks!