From: Ben Darnell Date: Sat, 11 Jun 2011 21:48:46 +0000 (-0700) Subject: Add titles to table of contents X-Git-Tag: v2.0.0~20^2~2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8fd9413f40be6c4f2c10653654a64e48629f4662;p=thirdparty%2Ftornado.git Add titles to table of contents --- diff --git a/website/sphinx/auth.rst b/website/sphinx/auth.rst index b0f9ebf87..46065945c 100644 --- a/website/sphinx/auth.rst +++ b/website/sphinx/auth.rst @@ -1,5 +1,5 @@ -``tornado.auth`` -====================== +``tornado.auth`` --- Third-party login with OpenID and OAuth +============================================================ .. automodule:: tornado.auth :members: diff --git a/website/sphinx/autoreload.rst b/website/sphinx/autoreload.rst index 01ab31483..4e1c9871f 100644 --- a/website/sphinx/autoreload.rst +++ b/website/sphinx/autoreload.rst @@ -1,5 +1,5 @@ -``tornado.autoreload`` -====================== +``tornado.autoreload`` --- Automatically detect code changes in development +=========================================================================== .. automodule:: tornado.autoreload :members: diff --git a/website/sphinx/database.rst b/website/sphinx/database.rst index 7a7dc8153..f6debdc9c 100644 --- a/website/sphinx/database.rst +++ b/website/sphinx/database.rst @@ -1,5 +1,5 @@ -``tornado.database`` -====================== +``tornado.database`` --- Simple MySQL client wrapper +==================================================== .. automodule:: tornado.database :members: diff --git a/website/sphinx/escape.rst b/website/sphinx/escape.rst index d67ec5898..6a434f3f1 100644 --- a/website/sphinx/escape.rst +++ b/website/sphinx/escape.rst @@ -1,5 +1,5 @@ -``tornado.escape`` -====================== +``tornado.escape`` --- Escaping and string manipulation +======================================================= .. automodule:: tornado.escape :members: diff --git a/website/sphinx/httpclient.rst b/website/sphinx/httpclient.rst index 4022a63f8..b1f28009c 100644 --- a/website/sphinx/httpclient.rst +++ b/website/sphinx/httpclient.rst @@ -1,5 +1,5 @@ -``tornado.httpclient`` -====================== +``tornado.httpclient`` --- Non-blocking HTTP client +=================================================== .. automodule:: tornado.httpclient :members: diff --git a/website/sphinx/httpserver.rst b/website/sphinx/httpserver.rst index 11e5c3efb..41f7e1d33 100644 --- a/website/sphinx/httpserver.rst +++ b/website/sphinx/httpserver.rst @@ -1,5 +1,5 @@ -``tornado.httpserver`` -====================== +``tornado.httpserver`` --- Non-blocking HTTP server +=================================================== .. automodule:: tornado.httpserver :members: diff --git a/website/sphinx/httputil.rst b/website/sphinx/httputil.rst index 804177594..4befc6552 100644 --- a/website/sphinx/httputil.rst +++ b/website/sphinx/httputil.rst @@ -1,5 +1,5 @@ -``tornado.httputil`` -====================== +``tornado.httputil`` --- Manipulate HTTP headers and URLs +========================================================= .. automodule:: tornado.httputil :members: diff --git a/website/sphinx/index.rst b/website/sphinx/index.rst index 23f26d3ad..98cf1afe5 100644 --- a/website/sphinx/index.rst +++ b/website/sphinx/index.rst @@ -1,7 +1,10 @@ Tornado API Reference ===================== -Contents: +The following documents are automatically generated from docstrings +in the source code. A separate +`overview `_ document is also +available. .. toctree:: :maxdepth: 2 diff --git a/website/sphinx/ioloop.rst b/website/sphinx/ioloop.rst index 03f9072c0..1c23171c9 100644 --- a/website/sphinx/ioloop.rst +++ b/website/sphinx/ioloop.rst @@ -1,5 +1,5 @@ -``tornado.ioloop`` -====================== +``tornado.ioloop`` --- Main event loop +====================================== .. automodule:: tornado.ioloop :members: diff --git a/website/sphinx/iostream.rst b/website/sphinx/iostream.rst index e65ca27ec..28de480b3 100644 --- a/website/sphinx/iostream.rst +++ b/website/sphinx/iostream.rst @@ -1,5 +1,5 @@ -``tornado.iostream`` -====================== +``tornado.iostream`` --- Convenient wrappers for non-blocking sockets +===================================================================== .. automodule:: tornado.iostream :members: diff --git a/website/sphinx/locale.rst b/website/sphinx/locale.rst index 41b8bf274..57fdca54b 100644 --- a/website/sphinx/locale.rst +++ b/website/sphinx/locale.rst @@ -1,5 +1,5 @@ -``tornado.locale`` -====================== +``tornado.locale`` --- Internationalization support +=================================================== .. automodule:: tornado.locale :members: diff --git a/website/sphinx/options.rst b/website/sphinx/options.rst index c6a3e10a6..a201bc2c8 100644 --- a/website/sphinx/options.rst +++ b/website/sphinx/options.rst @@ -1,5 +1,5 @@ -``tornado.options`` -====================== +``tornado.options`` --- Command-line parsing +============================================ .. automodule:: tornado.options :members: diff --git a/website/sphinx/stack_context.rst b/website/sphinx/stack_context.rst index 95a14f810..489a37fdc 100644 --- a/website/sphinx/stack_context.rst +++ b/website/sphinx/stack_context.rst @@ -1,5 +1,5 @@ -``tornado.stack_context`` -========================= +``tornado.stack_context`` --- Exception handling across asynchronous callbacks +============================================================================== .. automodule:: tornado.stack_context :members: diff --git a/website/sphinx/template.rst b/website/sphinx/template.rst index d9d549403..11c2ea574 100644 --- a/website/sphinx/template.rst +++ b/website/sphinx/template.rst @@ -1,5 +1,5 @@ -``tornado.template`` -====================== +``tornado.template`` --- Flexible output generation +=================================================== .. automodule:: tornado.template :members: diff --git a/website/sphinx/testing.rst b/website/sphinx/testing.rst index 65caf0161..9378d927c 100644 --- a/website/sphinx/testing.rst +++ b/website/sphinx/testing.rst @@ -1,5 +1,5 @@ -``tornado.testing`` -====================== +``tornado.testing`` --- Unit testing support for asynchronous code +================================================================== .. automodule:: tornado.testing :members: diff --git a/website/sphinx/web.rst b/website/sphinx/web.rst index 5f0370073..5ea2927b4 100644 --- a/website/sphinx/web.rst +++ b/website/sphinx/web.rst @@ -1,5 +1,5 @@ -``tornado.web`` -=============== +``tornado.web`` --- ``RequestHandler`` and ``Application`` classes +================================================================== .. automodule:: tornado.web diff --git a/website/sphinx/webframework.rst b/website/sphinx/webframework.rst index d1dab0ca2..cf0935361 100644 --- a/website/sphinx/webframework.rst +++ b/website/sphinx/webframework.rst @@ -2,6 +2,7 @@ Core web framework ================== .. toctree:: + :maxdepth: 2 web httpserver diff --git a/website/sphinx/websocket.rst b/website/sphinx/websocket.rst index 6c064feef..c4bd0ed5a 100644 --- a/website/sphinx/websocket.rst +++ b/website/sphinx/websocket.rst @@ -1,5 +1,5 @@ -``tornado.websocket`` -====================== +``tornado.websocket`` --- Bidirectional communication to the browser +==================================================================== .. automodule:: tornado.websocket :members: diff --git a/website/sphinx/wsgi.rst b/website/sphinx/wsgi.rst index 37876b878..489e85d9b 100644 --- a/website/sphinx/wsgi.rst +++ b/website/sphinx/wsgi.rst @@ -1,5 +1,5 @@ -``tornado.wsgi`` -====================== +``tornado.wsgi`` --- Interoperability with other Python frameworks and servers +============================================================================== .. automodule:: tornado.wsgi :members: