Skip Menu |
 

Subject: Import remaining content from texinfo to reST
Most of the documentation content has been converted to
restructuredtext, but a few bits remain to convert. We need to finish
moving the content over before the 1.11 release.
From: kaduk@MIT.EDU
Subject: SVN Commit

Document DejaGnu dependency and manual tests

The Texinfo install guide had a separate subsection about the DejaGnu
tests which did not get converted to the RST source.

In the testing section, also link to the wiki page on manual testing.

https://github.com/krb5/krb5/commit/fd136728de5b603974e3ec21bc5856406c4e814d
Author: Ben Kaduk <kaduk@mit.edu>
Commit: fd136728de5b603974e3ec21bc5856406c4e814d
Branch: master
doc/rst_source/krb_build/doing_build.rst | 11 +++++++++++
1 files changed, 11 insertions(+), 0 deletions(-)
From: kaduk@MIT.EDU
Subject: SVN Commit

Add a kdb5_util examples for old KDC upgrades

It's a slightly less-contrived use case of the utility than the
other example, which reads more like a usage statement.
Give a motivating sentence before each example, and note that this
new example is not needed in the general upgrade case.

The need to dump/load for upgrades prior to 1.2 was documented in
the texinfo install guide, but not in any RST sources until now.

https://github.com/krb5/krb5/commit/92eafef8b949dd59db8cfdf319852d53e24fe2e5
Author: Ben Kaduk <kaduk@mit.edu>
Commit: 92eafef8b949dd59db8cfdf319852d53e24fe2e5
Branch: master
doc/rst_source/krb_admins/database.rst | 20 ++++++++++++++++++++
1 files changed, 20 insertions(+), 0 deletions(-)
From: kaduk@MIT.EDU
Subject: SVN Commit

Document TXT records for realm lookup

Even though they are subject to vulnerabilities via DNS spoofing
and we accordingly don't recommend their use, we do have the code
to use them. Just as we document dns_lookup_realm in krb5.conf(5),
document them here.

https://github.com/krb5/krb5/commit/89465b37e226f75e5685aae1d3848f8c467f9d02
Author: Ben Kaduk <kaduk@mit.edu>
Commit: 89465b37e226f75e5685aae1d3848f8c467f9d02
Branch: master
doc/rst_source/krb_admins/realm_config.rst | 23 ++++++++++++++++++++++-
1 files changed, 22 insertions(+), 1 deletions(-)
From: kaduk@MIT.EDU
Subject: SVN Commit

Add notice.rst

To replace the texinfo sources previously used to generate NOTICE.

When compiled to HTML, compares well against the original NOTICE;
use notice.rst in mitK5license.rst instead of using a literal
include of the old NOTICE file.

https://github.com/krb5/krb5/commit/986a5759d97ef5eb5b874412b33ccbb0214a4d53
Author: Ben Kaduk <kaduk@mit.edu>
Commit: 986a5759d97ef5eb5b874412b33ccbb0214a4d53
Branch: master
doc/rst_source/mitK5license.rst | 3 +-
doc/rst_source/notice.rst | 1124 +++++++++++++++++++++++++++++++++++++++
2 files changed, 1125 insertions(+), 2 deletions(-)
From: kaduk@MIT.EDU
Subject: SVN Commit
Download (untitled) / with headers
text/plain 1.2KiB

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@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(-)