[krbdev.mit.edu #7407] SVN Commit

Benjamin Kaduk via RT rt-comment at krbdev.mit.edu
Mon Oct 15 18:53:44 EDT 2012


Make rules for building NOTICE from RST

Sphinx-build wants to scan over all the sources in the source dir,
and its text output engine does not handle the spanning row cells
used in some of our fancy tables, so it will crash if we attempt
to generate text output from our full suite of documents.
We could work around this by attempting to just compile the one
source file as an additional argument to sphinx-build, but this
seems to insist on producing an index.txt as well as a notice.txt.
Furthermore, we cannot use the same conf.py as in rst_composite because
the paths substitutions are not available with just the minimal
contents of rst_notice.  Make a copy and remove the irrelevant parts,
for now, changing only the master_doc field as appropriate.

For the HTML build, we use the standard |copy| macro from isonum.txt
to get the unicode copyright symbol glyph, but for ASCII output we
prefer to just use the literal "(C)".

https://github.com/krb5/krb5/commit/e9dc672b8b3af28fa8ea71e866a7c376b4c443d7
Author: Ben Kaduk <kaduk at mit.edu>
Commit: e9dc672b8b3af28fa8ea71e866a7c376b4c443d7
Branch: master
 doc/rst_source/txt_conf.py |   88 ++++++++++++++++++++++++++++++++++++++++++++
 src/doc/Makefile.in        |   25 ++++++++++--
 2 files changed, 108 insertions(+), 5 deletions(-)



More information about the krb5-bugs mailing list