[krbdev.mit.edu #8952] git commit

[Greg Hudson via RT]

Mon Sep 28 22:42:03 2020: Request 8952 was acted upon.
 Transaction: Ticket created by ghudson at mit.edu
       Queue: krb5
     Subject: git commit
       Owner: ghudson at mit.edu
  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 <ghudson at mit.edu>
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(-)