Doxygen produces wrong link from header file

[hcw70]

Describe the bug

• Process attached header file with attached doxygen config,
• open generated index.html
• open the file "MsgRouter.h"
• Click "go to source code of this file"

You will find a link on line 1 (the link text is empty, but if you hover over the line number, you will see it),
pointing to the first property of the class.

However, the link should not be there, since the property is defined later in the file.

This is also present in the XML output btw.

Expected behavior
No link should be there in the first line of the output.

To Reproduce
See attached header file / doxyfile

Version
Doxygen version 1.9.6 (4586b5c)
Running under ubuntu 22.04

[hcw70]

doxy-bug.zip

[hcw70]

Generated output as a reference:

dox-out.zip

[albert-github]

That nothing is shown on the text part of the line is logical as STRIP_CODE_COMMENTS = YES and thus all doxygen type comment lines are gone.
The fact that there is a link on that line number is not correct, it looks like it is introduced in doxygen version 1.8.18 have to do some bisecting ...

[albert-github]

Result of the bisecting:

43420bd77408559cb66c83e9ce601426b371bc74 is the first bad commit
commit 43420bd77408559cb66c83e9ce601426b371bc74
Date:   Sun Mar 15 11:08:19 2020 +0100

    issue #7635: Incorrect location for enum in XML file (part 2)

Biggest chance is that it is in doxygen.cpp as the q... files are just comment changes and the other files are files just for testing.

@doxygen Any idea?

[albert-github]

It looks like it is also influence by the Q_PROPERTY either content or as first element (i.e. removing READ... or adding MsgRouter(); solves the doxygen issue)

[doxygen]

@albert-github, @hcw70 Please verify if the referenced commit fixes the problem for you. Do not close the issue as this will be done automatically when the next official release is made.

[albert-github]

Based on the example I have it looks like the link problem is fixed but I see some other major problems:

• The documentation of of the looks like that the Folding is moving through the file and doesn't do code folding but folds where it is.
• At the bottom of the file the last part is not shown as code but as one line:
  
• On the Q_PROPERTY line
  
  both the links of forwardMessages point to the variable (the property, whilst I think that the second link is a function and should point to line 113.

This might all have to do with the fix

Commit: 6e9402febe9248a9d233713970b79b49a2336908 [6e9402f]
Date: Tuesday, August 22, 2023 3:58:51 PM

Fixed code folding issue

When STRIP_CODE_COMMENTS=YES and the current code block was directly followed
by a (hidden) comment block, the code block did not end properly.

[albert-github]

With the revert of the mentioned HTML_CODE_FOLDING fix by means of commit ddd687a the results look OK

• the mentioned code folding will be addressed separately
• the link problem in respect to Q_PROPERTY will be done through a separate issue

[hcw70]

I tried 09438a9, and it fixed my problem.
Thanks for the fast solution!

[doxygen]

This issue was previously marked 'fixed but not released',
which means it should be fixed in doxygen version 1.9.8.
Please verify if this is indeed the case. Reopen the
issue if you think it is not fixed and please include any additional information
that you think can be relevant (preferably in the form of a self-contained example).