Bug 467005

Summary:	KApiDox substitutes “@ref options” with a link to KConfig, which is not always appropriate.
Product:	[Frameworks and Libraries] frameworks-kapidox	Reporter:	Lukas Sommer <sommerluk>
Component:	general	Assignee:	kdelibs bugs <kdelibs-bugs-null>
Status:	REPORTED ---
Severity:	normal
Priority:	NOR
Version First Reported In:	unspecified
Target Milestone:	---
Platform:	Other
OS:	Linux
Latest Commit:		Version Fixed/Implemented In:
Sentry Crash Report:

Description Lukas Sommer 2023-03-07 12:04:35 UTC

SUMMARY
KApiDox substitutes “@ref options” with a link to KConfig, which is not always appropriate.


STEPS TO REPRODUCE
1. Consider the following Doxygen comment: https://invent.kde.org/libraries/perceptualcolor/-/blob/ef3906f6400861e841b711df70211126c075b93d/src/colordialog.cpp#L1739

OBSERVED RESULT
The resulting API documentation substitues “@ref options” with a link with the text “KConfig Entry Options”, which is not the correct context here:
https://api.kde.org/perceptualcolor/html/classPerceptualColor_1_1ColorDialog.html#aa82b2369fe5376262e494ef0b509656c

EXPECTED RESULT
 “@ref options” is processed like on local Doxygen instances: It generates in internal link.