Bug 2322116

Summary: Broken markdown links to anchors
Product: [Fedora] Fedora Reporter: Attila Kovacs <attipaci>
Component: doxygenAssignee: Than Ngo <than>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: high Docs Contact:
Priority: unspecified    
Version: 41CC: than
Target Milestone: ---Keywords: BuildBlocker, Regression
Target Release: ---   
Hardware: All   
OS: Linux   
URL: https://github.com/doxygen/doxygen/issues/11207
Whiteboard:
Fixed In Version: doxygen-1.12.0-2.fc41 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2024-11-06 03:52:03 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Test markdown file none

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.