[krbdev.mit.edu #7466] SVN Commit

[Tom Yu via RT]

Do not generate unused parts of toctree

Our css only displays up to depth 3 of the toctree, partially
because the API reference content explodes at depth 4 and that would
not be pretty to see in the sidebar.  However, we would previously
always generate HTML for the full toctree and hide parts with CSS.
For the apiref, this proved to be about 65k per html file, and we
have one html file per function/type/macro.

Limit the depth of the toctree that gets generated to save on space
in the release tarball.

Unfortunately, there seems to be a Sphinx bug wherein the toctree
will only be generated to depth 1 for a document at a depth greater
than the maxdepth of the toctree, so the sidebar table of contents
on individual apiref pages will just be the toplevel toctree.
This issue is being tracked at
https://bitbucket.org/birkenfeld/sphinx/issue/1046/

(cherry picked from commit 81fc0331cdf8a41b346daaee32977d76ab645139)

https://github.com/krb5/krb5/commit/8022a7dfc81eede09a52b5c19249a94a2400362d
Author: Ben Kaduk <kaduk at mit.edu>
Committer: Tom Yu <tlyu at mit.edu>
Commit: 8022a7dfc81eede09a52b5c19249a94a2400362d
Branch: krb5-1.11
 doc/_templates/layout.html |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)