[20455] in Kerberos_V5_Development
Doxygen changes breaks krb5 documentation build
daemon@ATHENA.MIT.EDU (Sam Hartman)
Mon Sep 11 14:58:50 2023
From: Sam Hartman <hartmans@debian.org>
To: Tianyu Chen <sweetyfish@deepin.org>, 1051523@bugs.debian.org,
doxygen@packages.debian.org, krbdev@mit.edu
In-Reply-To: <806128D3B092442B+169424154549.86285.16057686447711500088.reportbug@ut005408-PC>
Date: Mon, 11 Sep 2023 12:57:22 -0600
Message-ID: <tslmsxssfl9.fsf@suchdamage.org>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============0768606315027217849=="
Errors-To: krbdev-bounces@mit.edu
--===============0768606315027217849==
Content-Type: multipart/signed; boundary="=-=-=";
micalg=pgp-sha256; protocol="application/pgp-signature"
--=-=-=
Content-Type: text/plain
>>>>> "Tianyu" == Tianyu Chen <sweetyfish@deepin.org> writes:
Tianyu> During a local rebuild of krb5, your package failed to
Tianyu> build.
So, I'm guessing this is related to the upgrade in Debian from doxygen
1.9.4 to 1.9.8.
The krb5 build process uses doxygen to generate an xml representation of
the documentation from a bunch of C header files. Then it uses a pile
of python scripts which haven't seen much love since the days of python2
to turn that documentation into rst, and then includes it in a sphinx
document.
It expects all the doxygen to be in a file called krb5_8hin.xml.
Unfortunately the new doxygen is breaking up the sources into a bunch of
different files and including <member> elements to refer to them rather
than <memberdef> elements including their definition. And so the python
doesn't find the definitions of the documented functions and the build
fails because not many rst files are generated.
I am hoping for help at this point.
I'll continue to look into it, but I'm not familiar with the innards of
doxygen, nor the xml parser that the krb5 python is using.
--=-=-=
Content-Type: application/pgp-signature; name="signature.asc"
-----BEGIN PGP SIGNATURE-----
iHUEARYIAB0WIQSj2jRwbAdKzGY/4uAsbEw8qDeGdAUCZP9jEgAKCRAsbEw8qDeG
dKd7AP4lEnBS6pTbQVx5wYGIWCwMJ+p3dikXhOyxeEqJWpUMJAD/RpkI1sLumLCg
23JHiAK1MsABc0bjypCmmT9K+vVoVQY=
=MDs7
-----END PGP SIGNATURE-----
--=-=-=--
--===============0768606315027217849==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
_______________________________________________
krbdev mailing list krbdev@mit.edu
https://mailman.mit.edu/mailman/listinfo/krbdev
--===============0768606315027217849==--
