Docs: ToC Tweaks

This commit bumps the docs theme version to get support for deeper
nesting on the nav bar.  It increases the ToC depth to 3, and hides
the ToC from the intro page to avoid redundancy.

New headings were added to the high-level API docs to take advantage of
the increased ToC depth.

Author: DirectXMan12

docs-requirements.txt

@@ -1,3 +1,3 @@
 Sphinx >= 1.3.1
-sphinx-rtd-theme >= 0.1.7
+sphinx-rtd-theme >= 0.1.9
 sphinxcontrib-napoleon >= 0.2.8

docs/source/gssapi.rst

@@ -21,14 +21,23 @@ representing the primary abstractions that GSSAPI provides:
 Main Classes
 ------------
 
+Names
+"""""
+
 .. automodule:: gssapi.names
     :members:
     :undoc-members:
 
+Credentials
+"""""""""""
+
 .. automodule:: gssapi.creds
     :members:
     :undoc-members:
 
+Security Contexts
+"""""""""""""""""
+
 .. automodule:: gssapi.sec_contexts
     :members:
     :undoc-members:

docs/source/index.rst

@@ -19,10 +19,9 @@ corresponding C functions.  The high-level API makes use of the low-level API
 to access underlying GSSAPI functionality.  Additionally certain extensions
 are currently only available from the low-level API.
 
-Contents:
-
 .. toctree::
-   :maxdepth: 2
+   :hidden:
+   :maxdepth: 3
 
    gssapi.rst
    gssapi.raw.rst