[krbdev.mit.edu #8952] git commit
"Greg Hudson via RT" <[email protected]>
| Newsgroups | gmane.comp.encryption.kerberos.bugs |
|---|---|
| Message-ID | <[email protected]> |
Mon Sep 28 22:42:03 2020: Request 8952 was acted upon. Transaction: Ticket created by [email protected] Queue: krb5 Subject: git commit Owner: [email protected] Requestors: Status: new Ticket <URL: https://krbdev.mit.edu/rt/Ticket/Display.html?id=8952 > Fix doc issues with newer Doxygen and Sphinx In krb5.hin, fix some apparently harmless whitespace nits in comments which cause newer Doxygen versions to generate <detaileddescription> content containing <linebreak/> tags. Also remove the explicit "@n" linebreaks in the responder JSON schemas, instead relying on Doxygen markup support (added in Doxygen 1.8). Add a verbatim handler in doxybuilder_types.py to translate the resulting section, replacing the linebreak handler which is no longer needed. css_files is deprecated in Sphinx. Instead use app.add_stylesheet() in a setup function in conf.py. (Sphinx 1.8 has a slightly simpler method, but that is currently too recent to depend on.) Also remove the obsolete html_use_smartypants setting. In func_document.tmpl, fix an incorrent use of "is". https://github.com/krb5/krb5/commit/281210909beef4683be3b63bc1ac1e75c2c9c7eb Author: Greg Hudson <[email protected]> Commit: 281210909beef4683be3b63bc1ac1e75c2c9c7eb Branch: master doc/_templates/layout.html | 1 - doc/conf.py | 7 ++-- doc/tools/doxybuilder_types.py | 7 +++- doc/tools/func_document.tmpl | 2 +- src/include/krb5/krb5.hin | 70 ++++++++++++++++++++-------------------- 5 files changed, 44 insertions(+), 43 deletions(-)