First stab at segmented TOCtrees.

Makes sidebar TOC a little funny tho.

sites/docs/api/transport.rst

@@ -1,4 +1,4 @@
-Transport (core protocol)
+Transport
-=========================
+=========
 
 .. automodule:: paramiko.transport

sites/docs/index.rst

@@ -5,7 +5,46 @@ This site covers Paramiko's usage & API documentation. For basic info on what
 Paramiko is, including its public changelog & how the project is maintained,
 please see `the main website <http://paramiko.org>`_.
 
-.. toctree::
-    :glob:
 
-    api/*
+API documentation
+=================
+
+Core SSH protocol classes
+-------------------------
+
+.. toctree::
+    api/channel
+    api/client
+    api/message
+    api/packet
+    api/transport
+
+
+Authentication & key handling
+-----------------------------
+
+.. toctree::
+    api/agent
+    api/hostkeys
+    api/keys
+    api/win_pageant
+
+
+Other primary functions
+-----------------------
+
+.. toctree::
+    api/config
+    api/proxy
+    api/server
+    api/sftp
+
+
+Miscellany
+----------
+
+.. toctree::
+    api/buffered_pipe
+    api/file
+    api/pipe
+    api/ssh_exception