Fixed #9465 -- Simplified API Reference documentation titles for easi…

…er lookup and made first-level heading styles consistent. Thanks, adamnelson. git-svn-id: http://code.djangoproject.com/svn/django/trunk@11990 bcc190cf-cafb-0310-a4f2-bffc1f526a37
django · Dec 26, 2009 · c6fa493 · c6fa493
1 parent 39122c8
commit c6fa493
Show file tree

Hide file tree

Showing 14 changed files with 43 additions and 33 deletions.
diff --git a/docs/ref/authbackends.txt b/docs/ref/authbackends.txt
@@ -1,14 +1,14 @@
 .. _ref-authentication-backends:
 
-==========================================
+=======================
-Built-in authentication backends reference
+Authentication backends
-==========================================
+=======================
 
 .. module:: django.contrib.auth.backends
    :synopsis: Django's built-in authentication backend classes.
 
 This document details the authentication backends that come with Django. For
-information on how how to use them and how to write your own authentication
+information on how to use them and how to write your own authentication
 backends, see the :ref:`Other authentication sources section
 <authentication-backends>` of the :ref:`User authentication guide
 <topics-auth>`.

diff --git a/docs/ref/contrib/index.txt b/docs/ref/contrib/index.txt
@@ -1,8 +1,8 @@
 .. _ref-contrib-index:
 
-============================
+====================
-The "django.contrib" add-ons
+``contrib`` packages
-============================
+====================
 
 Django aims to follow Python's `"batteries included" philosophy`_. It ships
 with a variety of extra, optional tools that solve common Web-development

diff --git a/docs/ref/databases.txt b/docs/ref/databases.txt
@@ -1,8 +1,8 @@
 .. _ref-databases:
 
-===============================
+=========
-Notes about supported databases
+Databases
-===============================
+=========
 
 Django attempts to support as many features as possible on all database
 backends. However, not all database backends are alike, and we've had to make

diff --git a/docs/ref/files/index.txt b/docs/ref/files/index.txt
@@ -1,13 +1,14 @@
 .. _ref-files-index:
 
-File handling reference
+=============
-=======================
+File handling
+=============
 
 .. module:: django.core.files
    :synopsis: File handling and storage
 
 .. toctree::
    :maxdepth: 1
-   
+
    file
-   storage
+   storage
diff --git a/docs/ref/forms/index.txt b/docs/ref/forms/index.txt
@@ -1,14 +1,15 @@
 .. _ref-forms-index:
 
+=====
 Forms
 =====
 
 Detailed form API reference. For introductory material, see :ref:`topics-forms-index`.
 
 .. toctree::
    :maxdepth: 1
-   
+
    api
    fields
    widgets
-   validation
+   validation
diff --git a/docs/ref/generic-views.txt b/docs/ref/generic-views.txt
@@ -1088,4 +1088,3 @@ In addition to ``extra_context``, the template's context will be:
       variable's name depends on the ``template_object_name`` parameter, which
       is ``'object'`` by default. If ``template_object_name`` is ``'foo'``,
       this variable's name will be ``foo``.
-
diff --git a/docs/ref/index.txt b/docs/ref/index.txt
@@ -1,5 +1,6 @@
 .. _ref-index:
 
+=============
 API Reference
 =============
 
@@ -20,4 +21,3 @@ API Reference
    signals
    templates/index
    unicode
-
diff --git a/docs/ref/middleware.txt b/docs/ref/middleware.txt
@@ -1,8 +1,8 @@
 .. _ref-middleware:
 
-=============================
+==========
-Built-in middleware reference
+Middleware
-=============================
+==========
 
 .. module:: django.middleware
    :synopsis: Django's built-in middleware classes.
@@ -149,8 +149,8 @@ Message middleware
 
 .. versionadded:: 1.2
    ``MessageMiddleware`` was added.
-   
+
-Enables cookie- and session-based message support. See the 
+Enables cookie- and session-based message support. See the
 :ref:`messages documentation <ref-contrib-messages>`.
 
 Session middleware

diff --git a/docs/ref/models/index.txt b/docs/ref/models/index.txt
@@ -1,5 +1,6 @@
 .. _ref-models-index:
 
+======
 Models
 ======
 

diff --git a/docs/ref/request-response.txt b/docs/ref/request-response.txt
@@ -598,4 +598,3 @@ types of HTTP responses. Like ``HttpResponse``, these subclasses live in
 .. class:: HttpResponseServerError
 
     Acts just like :class:`HttpResponse` but uses a 500 status code.
-
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
@@ -1,5 +1,13 @@
 .. _ref-settings:
 
+========
+Settings
+========
+
+.. contents::
+    :local:
+    :depth: 1
+
 Available settings
 ==================
 

diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt
@@ -1,8 +1,8 @@
 .. _ref-signals:
 
-=========================
+=======
-Built-in signal reference
+Signals
-=========================
+=======
 
 A list of all the signals that Django sends.
 

diff --git a/docs/ref/templates/index.txt b/docs/ref/templates/index.txt
@@ -1,7 +1,8 @@
 .. _ref-templates-index:
 
-Template reference
+=========
-==================
+Templates
+=========
 
 Django's template engine provides a powerful mini-language for defining the
 user-facing layer of your application, encouraging a clean separation of
@@ -17,4 +18,4 @@ an understanding of HTML; no knowledge of Python is required.
 .. seealso::
 
     For information on writing your own custom tags and filters, see
-    :ref:`howto-custom-template-tags`.
+    :ref:`howto-custom-template-tags`.
diff --git a/docs/ref/unicode.txt b/docs/ref/unicode.txt
@@ -1,8 +1,8 @@
 .. _ref-unicode:
 
-======================
+============
-Unicode data in Django
+Unicode data
-======================
+============
 
 .. versionadded:: 1.0