Fixed #14141: docs now use the :doc: construct for links between documents.

Thanks, Ramiro Morales.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@13608 bcc190cf-cafb-0310-a4f2-bffc1f526a37

8 files changed, 13 insertions, 29 deletions

diff --git a/docs/faq/admin.txt b/docs/faq/admin.txt
index ed705d5f21..8ee6cc184b 100644
--- a/docs/faq/admin.txt
+++ b/docs/faq/admin.txt
@@ -1,5 +1,3 @@
-.. _faq-admin:
-
 FAQ: The admin
 ==============
 
@@ -32,7 +30,7 @@ How can I prevent the cache middleware from caching the admin site?
 -------------------------------------------------------------------
 
 Set the :setting:`CACHE_MIDDLEWARE_ANONYMOUS_ONLY` setting to ``True``. See the
-:ref:`cache documentation <topics-cache>` for more information.
+:doc:`cache documentation </topics/cache>` for more information.
 
 How do I automatically set a field's value to the user who last edited the object in the admin?
 -----------------------------------------------------------------------------------------------
@@ -91,5 +89,5 @@ We like it, but if you don't agree, you can modify the admin site's
 presentation by editing the CSS stylesheet and/or associated image files. The
 site is built using semantic HTML and plenty of CSS hooks, so any changes you'd
 like to make should be possible by editing the stylesheet. We've got a
-:ref:`guide to the CSS used in the admin <obsolete-admin-css>` to get you started.
+:doc:`guide to the CSS used in the admin </obsolete/admin-css>` to get you started.
 
diff --git a/docs/faq/contributing.txt b/docs/faq/contributing.txt
index 51a9bc2c6a..81c06f365f 100644
--- a/docs/faq/contributing.txt
+++ b/docs/faq/contributing.txt
@@ -1,5 +1,3 @@
-.. _faq-contributing:
-
 FAQ: Contributing code
 ======================
 
@@ -7,7 +5,7 @@ How can I get started contributing code to Django?
 --------------------------------------------------
 
 Thanks for asking! We've written an entire document devoted to this question.
-It's titled :ref:`Contributing to Django <internals-contributing>`.
+It's titled :doc:`Contributing to Django </internals/contributing>`.
 
 I submitted a bug fix in the ticket system several weeks ago. Why are you ignoring my patch?
 --------------------------------------------------------------------------------------------
diff --git a/docs/faq/general.txt b/docs/faq/general.txt
index 1181d261be..1fc0f1882a 100644
--- a/docs/faq/general.txt
+++ b/docs/faq/general.txt
@@ -1,5 +1,3 @@
-.. _faq-general:
-
 FAQ: General
 ============
 
@@ -63,15 +61,15 @@ at any level -- database servers, caching servers or Web/application servers.
 
 The framework cleanly separates components such as its database layer and
 application layer. And it ships with a simple-yet-powerful
-:ref:`cache framework <topics-cache>`.
+:doc:`cache framework </topics/cache>`.
 
 Who's behind this?
 ------------------
 
 Django was originally developed at World Online, the Web department of a
 newspaper in Lawrence, Kansas, USA. Django's now run by an international team of
-volunteers; you can read all about them over at the :ref:`list of committers
-<internals-committers>`
+volunteers; you can read all about them over at the :doc:`list of committers
+</internals/committers>`
 
 Which sites use Django?
 -----------------------
@@ -146,7 +144,7 @@ philosophies 100%.
 Like we said: We're picky.
 
 We've documented our philosophies on the
-:ref:`design philosophies page <misc-design-philosophies>`.
+:doc:`design philosophies page </misc/design-philosophies>`.
 
 Is Django a content-management-system (CMS)?
 --------------------------------------------
diff --git a/docs/faq/help.txt b/docs/faq/help.txt
index 5d7faf6fec..d84b3f529f 100644
--- a/docs/faq/help.txt
+++ b/docs/faq/help.txt
@@ -1,5 +1,3 @@
-.. _faq-help:
-
 FAQ: Getting Help
 =================
 
diff --git a/docs/faq/index.txt b/docs/faq/index.txt
index d357a3ebb0..347cabaabc 100644
--- a/docs/faq/index.txt
+++ b/docs/faq/index.txt
@@ -1,5 +1,3 @@
-.. _faq-index:
-
 ==========
 Django FAQ
 ==========
diff --git a/docs/faq/install.txt b/docs/faq/install.txt
index f5feb98aff..3fbcb3842d 100644
--- a/docs/faq/install.txt
+++ b/docs/faq/install.txt
@@ -1,5 +1,3 @@
-.. _faq-install:
-
 FAQ: Installation
 =================
 
@@ -7,9 +5,9 @@ How do I get started?
 ---------------------
 
     #. `Download the code`_.
-    #. Install Django (read the :ref:`installation guide <intro-install>`).
-    #. Walk through the :ref:`tutorial <intro-tutorial01>`.
-    #. Check out the rest of the :ref:`documentation <index>`, and `ask questions`_ if you
+    #. Install Django (read the :doc:`installation guide </intro/install>`).
+    #. Walk through the :doc:`tutorial </intro/tutorial01>`.
+    #. Check out the rest of the :doc:`documentation </index>`, and `ask questions`_ if you
        run into trouble.
 
 .. _`Download the code`: http://www.djangoproject.com/download/
@@ -26,7 +24,7 @@ For a development environment -- if you just want to experiment with Django --
 you don't need to have a separate Web server installed; Django comes with its
 own lightweight development server. For a production environment, Django
 follows the WSGI_ spec, which means it can run on a variety of server
-platforms.  See :ref:`Deploying Django <howto-deployment-index>` for some
+platforms.  See :doc:`Deploying Django </howto/deployment/index>` for some
 popular alternatives.  Also, the `server arrangements wiki page`_ contains
 details for several deployment strategies.
 
diff --git a/docs/faq/models.txt b/docs/faq/models.txt
index 2732c0b8e1..f00d453d88 100644
--- a/docs/faq/models.txt
+++ b/docs/faq/models.txt
@@ -1,5 +1,3 @@
-.. _faq-models:
-
 FAQ: Databases and models
 =========================
 
@@ -30,7 +28,7 @@ backend, and not all backends provide a way to retrieve the SQL after quoting.
 
 .. versionadded:: 1.2
 
-If you are using :ref:`multiple databases<topics-db-multi-db>`, you can use the
+If you are using :doc:`multiple databases</topics/db/multi-db>`, you can use the
 same interface on each member of the ``connections`` dictionary::
 
     >>> from django.db import connections
@@ -39,7 +37,7 @@ same interface on each member of the ``connections`` dictionary::
 Can I use Django with a pre-existing database?
 ----------------------------------------------
 
-Yes. See :ref:`Integrating with a legacy database <howto-legacy-databases>`.
+Yes. See :doc:`Integrating with a legacy database </howto/legacy-databases>`.
 
 If I make changes to a model, how do I update the database?
 -----------------------------------------------------------
diff --git a/docs/faq/usage.txt b/docs/faq/usage.txt
index 6c3c518bb2..856b97c35c 100644
--- a/docs/faq/usage.txt
+++ b/docs/faq/usage.txt
@@ -1,5 +1,3 @@
-.. _faq-usage:
-
 FAQ: Using Django
 =================