[krbdev.mit.edu #7447] Fix warnings in doc build

[Benjamin Kaduk via RT]

On Wed, 28 Nov 2012, Zhanna Tsitkova via RT wrote:

> [kaduk at MIT.EDU - Tue Nov 27 18:02:34 2012]:
>
>>
>> Remove last "document not in toctree" warnings
>>
>> There were two of them, for notice.rst and mitK5license.rst.
>> The former is included in the latter, which is linked to from
>> the mitK5features document but not listed in a table of contents
>> otherwise.  Includes are processed unconditionally, so we can
>> add notice.rst to the exclude_patterns array (formerly unused_docs)
>> and its content will still be included.
>>
>> If we attempt to do the same for mitK5license.rst, it is not processed
>> at all, and the attempt to link to it will fail.  Instead, put a dummy
>> table of contents in the mitK5features document (which links to the
>> license document), with the "hidden" attribute.  This satisfies the
>> Sphinx need to know where all the input documents are without changing
>> the displayed table of contents.
>>
>> https://github.com/krb5/krb5/commit/b358b505be4502a71495ce58b8444027121726ee
>> Author: Ben Kaduk <kaduk at mit.edu>
>> Commit: b358b505be4502a71495ce58b8444027121726ee
>> Branch: master
>>  doc/conf.py           |    1 +
>>  doc/mitK5features.rst |    5 +++++
>>  2 files changed, 6 insertions(+), 0 deletions(-)
>
> Now MIT Kerberos License information appears in the sidebar which is undesirable behavior.

Hmm, this may be a Sphinx bug, I'll try to look and see.

Why is it undesirable to have the license information in the sidebar?

-Ben