Fixed #9465 -- Simplified API Reference documentation titles for easier 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

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>`.

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

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

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

docs/ref/forms/index.txt

@@ -1,5 +1,6 @@
 .. _ref-forms-index:
 
+=====
 Forms
 =====
 
@@ -7,8 +8,8 @@ Detailed form API reference. For introductory material, see :ref:`topics-forms-i
 
 .. toctree::
    :maxdepth: 1
-   
+
    api
    fields
    widgets
-   validation
+   validation

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``.
-

docs/ref/index.txt

@@ -1,5 +1,6 @@
 .. _ref-index:
 
+=============
 API Reference
 =============
 
@@ -20,4 +21,3 @@ API Reference
    signals
    templates/index
    unicode
-

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

docs/ref/models/index.txt

@@ -1,5 +1,6 @@
 .. _ref-models-index:
 
+======
 Models
 ======
 

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.
-

docs/ref/settings.txt

@@ -1,5 +1,13 @@
 .. _ref-settings:
 
+========
+Settings
+========
+
+.. contents::
+    :local:
+    :depth: 1
+
 Available settings
 ==================
 

docs/ref/signals.txt

@@ -1,8 +1,8 @@
 .. _ref-signals:
 
-=========================
-Built-in signal reference
-=========================
+=======
+Signals
+=======
 
 A list of all the signals that Django sends.
 

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`.

docs/ref/unicode.txt

@@ -1,8 +1,8 @@
 .. _ref-unicode:
 
-======================
-Unicode data in Django
-======================
+============
+Unicode data
+============
 
 .. versionadded:: 1.0