https://bugs.kde.org/show_bug.cgi?id=411690
Bug ID: 411690
Summary: QCH build fails with doxygen 1.8.16
Product: frameworks-kdeclarative
Version: unspecified
Platform: Compiled Sources
OS: Linux
Status: REPORTED
Severity: normal
Priority: NOR
Component: general
Assignee: notm...@gmail.com
Reporter: aro...@archlinux.org
CC: kdelibs-b...@kde.org
Target Milestone: ---
Created attachment 122527
--> https://bugs.kde.org/attachment.cgi?id=122527&action=edit
broken index.qhp
SUMMARY
If kconfig and kpackage are both compiled with doxygen 1.8.16, QCH docs fail to
build for kdeclarative, with error
Error in line 233: Opening and ending tag mismatch.
And indeed, index.qhp (attached) contains a spurious </section> tag.
Looking at the tags files for kconfig and kpackage, these are the diffs when
compiled with doxygen 1.8.16 vs old doxygen (modulo permutation of the <member>
blocks):
diff -ru kpackage-old/usr/share/doc/qt/KF5Package.tags
kpackage-new/usr/share/doc/qt/KF5Package.tags
--- kpackage-old/usr/share/doc/qt/KF5Package.tags 2019-08-09
17:13:20.000000000 +0200
+++ kpackage-new/usr/share/doc/qt/KF5Package.tags 2019-09-07
22:52:01.000000000 +0200
@@ -645,5 +645,11 @@
<name>index</name>
<title>KPackage Framework</title>
<filename>index</filename>
+ <docanchor file="index" title="Introduction">autotoc_md1</docanchor>
+ <docanchor file="index" title="Using KPackage">autotoc_md2</docanchor>
+ <docanchor file="index" title="Package class">autotoc_md3</docanchor>
+ <docanchor file="index" title="Package structures">autotoc_md4</docanchor>
+ <docanchor file="index" title="Package loader">autotoc_md5</docanchor>
+ <docanchor file="index" title="Note for packagers">autotoc_md6</docanchor>
</compound>
</tagfile>
diff -ru kconfig-old/usr/share/doc/qt/KF5Config.tags
kconfig-new/usr/share/doc/qt/KF5Config.tags
--- kconfig-old/usr/share/doc/qt/KF5Config.tags 2019-08-09 16:34:02.000000000
+0200
+++ kconfig-new/usr/share/doc/qt/KF5Config.tags 2019-09-07 22:49:53.000000000
+0200
@@ -4117,10 +4117,13 @@
<name>options</name>
<title>KConfig Entry Options</title>
<filename>options</filename>
+ <docanchor file="options" title="Immutable
Entries">autotoc_md0</docanchor>
+ <docanchor file="options" title="Shell Expansion">autotoc_md1</docanchor>
</compound>
<compound kind="page">
<name>index</name>
<title>KConfig</title>
<filename>index</filename>
+ <docanchor file="index" title="Introduction">autotoc_md3</docanchor>
</compound>
</tagfile>
Removing these docanchor lines from either of them fixes the issue.
There's probably some doxygen bug involved here, but I don't understand the
internals of QCH generation well enough to figure it out.
--
You are receiving this mail because:
You are watching all bug changes.
