[20457] in Kerberos_V5_Development
Re: Doxygen changes breaks krb5 documentation build
daemon@ATHENA.MIT.EDU (Greg Hudson)
Wed Sep 13 18:06:02 2023
Message-ID: <56b9c8d2-27f9-8116-601e-7d096bcd91ef@mit.edu>
Date: Wed, 13 Sep 2023 18:04:46 -0400
MIME-Version: 1.0
Content-Language: en-US
To: <paolo.greppi@libpf.com>, <1051523@bugs.debian.org>
CC: Sam Hartman <hartmans@debian.org>, Tianyu Chen <sweetyfish@deepin.org>,
<krbdev@mit.edu>
From: "Greg Hudson" <ghudson@mit.edu>
In-Reply-To: <ccd54644-81a7-6f9a-e1b3-d65c75423dca@libpf.com>
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="us-ascii"; Format="flowed"
Errors-To: krbdev-bounces@mit.edu
On 9/12/23 03:01, Paolo Greppi wrote:
> This may well be a doxygen bug, can anybody tell if there is any pattern?
I believe this is a deliberate behavior change in Doxygen 1.9.7, made to
address a problem affecting a different doxygen-to-RST converter:
https://github.com/doxygen/doxygen/pull/9797
https://github.com/doxygen/doxygen/issues/8790
(doxyrest doesn't appear to be packaged by Debian, or I'd investigate
whether we could use it instead of the current homegrown bridge. But
that would be a longer-term change anyway.)
Although it might be difficult to modify the current scripts to handle
this change, the deduplication only arises because of @group
declarations in krb5.hin, which don't have any effect on the generated
RST files. I have filed a PR to remove these and the associated @ref
declarations:
https://github.com/krb5/krb5/pull/1316
_______________________________________________
krbdev mailing list krbdev@mit.edu
https://mailman.mit.edu/mailman/listinfo/krbdev
