unnamed class results in copy_doc not finding target in totally unrelated files (Origin: bugzilla #608359)

[doxygen]

status RESOLVED severity normal in component general for ---
Reported in version 1.6.2 on platform Other
Assigned to: Dimitri van Heesch

Original attachment names and IDs:

• copy_doc.h (ID 152501)
• Doxyfile (ID 152502)

On 2010-01-28 17:28:40 +0000, Torsten Robitzki wrote:

Created attachment 152501
reproducer

This might seem a little esoteric, but this is real code and it was quit hard to find what was triggering the bug. The attached file copy_doc.h contains a little example that reproduces the bug and I've used Comeau C/C++ Online to make sure, that this is valid C++.

The two classes data::abs_interface and data::totally_unrelated and the object foo might be in parts of the project that seems to be totally unrelated. When I implement the interface data::abs_interface with an unnamed class, this will cause doxygen to not find the @copydoc target in class data::totally_unrelated.

A working workaround is to give the class of foo a name.

best regards
Torsten

On 2010-01-28 17:29:13 +0000, Torsten Robitzki wrote:

Created attachment 152502
doxyfile

On 2010-03-18 21:03:02 +0000, Torsten Robitzki wrote:

I've debug the issue a little bit and what I've found so far is, that the anonymous class gets added as a class named "@0::data" and this seems to hide data::totally_unrelated when the copydoc command looks up f1().

On 2010-04-20 12:24:29 +0000, Dimitri van Heesch wrote:

Confirmed. This should be corrected in the latest subversion update.

On 2010-06-15 11:22:16 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.7.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.

[supriyaKrishnamurthy]

Hi @doxygen , @copybrief filename.classname.functionname works when function belongs to any specific class. What about the generic functions in the file that do not belong to any class. @copybrief throws warning target not found.

[albert-github]

• what is the warning you get?
• Is this the same problem as indicated in the closed question? When not open a new issue, though it is anyway better to open a new issue and not dock to a long solved issue one can always refer to the issue.

In all cases:

• Can you please attach a, small, self contained example (source+configuration file in a tar or zip) that allows us to reproduce the problem? Please don't add external links as they might not be persistent.
• Please also specify the full doxygen version used (doxygen -v).

[supriyaKrishnamurthy]

Hi @doxygen , the version I am using is 1.8.20. Checked with the higher version, and I am not facing this issue there, @copybrief functionName() is working fine for the functions outside the class. If I face any issue again I will open new issue, for now you can close this.

Just to know more info about the issue refer the attachment. def printmsg(a) is a outside function that do not belong to any class.I want to copy its brief as mentioned at the top of the file.I tried several ways as mentioned in the file but it was throwing error as below:

WARNING: path/calc.py:15: @copybrief or @copydoc target 'calc.printmsg' not found

WARNING: path/calc.py:15: @copybrief or @copydoc target 'printmsg()' not found

WARNING: path/calc.py:15: @copybrief or @copydoc target 'printmsg' not found

calc.zip