Bug 2322116 - Broken markdown links to anchors
Summary: Broken markdown links to anchors
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: doxygen
Version: 41
Hardware: All
OS: Linux
unspecified
high
Target Milestone: ---
Assignee: Than Ngo
QA Contact: Fedora Extras Quality Assurance
URL: https://github.com/doxygen/doxygen/is...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2024-10-28 10:52 UTC by Attila Kovacs
Modified: 2024-11-06 03:52 UTC (History)
1 user (show)

Fixed In Version: doxygen-1.12.0-2.fc41
Clone Of:
Environment:
Last Closed: 2024-11-06 03:52:03 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)
Test markdown file (117 bytes, text/markdown)
2024-10-28 10:55 UTC, Attila Kovacs
no flags Details


Links
System ID Private Priority Status Summary Last Updated
Github 11135 0 None None None 2024-10-28 11:00:34 UTC
Github 11140 0 None None None 2024-10-28 11:00:34 UTC
Github 11207 0 None None None 2024-10-28 11:00:34 UTC

Description Attila Kovacs 2024-10-28 10:52:48 UTC
This is an upstream bug of Doxygen 1.12.0, which breaks the processing of anchors in markdown files. It has been fixed by commit 0ff684f to the doxygen repo since. See https://github.com/doxygen/doxygen/issues/11207

As doxygen is often used to generate documentation for Fedora packages, the issue can prevent updating f41 packages until the fix is available on Fedora also. For example, the supernovas package now fails to build under f41 as a result of the bug.

Reproducible: Always

Steps to Reproduce:
1. Create a markdown source with the example in the specified URL demonstrating the problem.
2. Create a Doxyfile with the above markdown document as the main page
3. run doxygen
Actual Results:  
error: unable to resolve reference to 'section-link' for \ref command

Expected Results:  
Markdown source compiles with a link to the referenced section

To fix, I suggest to include commit 0ff684f in an updated fedora 1.12.0 package (e.g. doxygen-1.12.0-2).

Comment 1 Attila Kovacs 2024-10-28 10:55:36 UTC
Created attachment 2054052 [details]
Test markdown file

Comment 2 Than Ngo 2024-10-28 14:15:12 UTC
It should be fixed in doxygen-1.12.0-2.fc41
https://koji.fedoraproject.org/koji/taskinfo?taskID=125290444

I'm preparing the update for this fix. Thanks for your report

Comment 3 Attila Kovacs 2024-10-28 14:48:51 UTC
Thanks YOU for the quick response!
-- A.

Comment 4 Fedora Update System 2024-10-28 15:15:46 UTC
FEDORA-2024-ffde113ff1 (doxygen-1.12.0-2.fc41) has been submitted as an update to Fedora 41.
https://bodhi.fedoraproject.org/updates/FEDORA-2024-ffde113ff1

Comment 5 Fedora Update System 2024-10-29 01:31:52 UTC
FEDORA-2024-ffde113ff1 has been pushed to the Fedora 41 testing repository.
Soon you'll be able to install the update with the following command:
`sudo dnf upgrade --enablerepo=updates-testing --refresh --advisory=FEDORA-2024-ffde113ff1`
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2024-ffde113ff1

See also https://fedoraproject.org/wiki/QA:Updates_Testing for more information on how to test updates.

Comment 6 Fedora Update System 2024-11-06 03:52:03 UTC
FEDORA-2024-ffde113ff1 (doxygen-1.12.0-2.fc41) has been pushed to the Fedora 41 stable repository.
If problem still persists, please make note of it in this bug report.


Note You need to log in before you can comment on or make changes to this bug.