Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Fixed #14228 -- Added additional information on what the APPEND_SLASH…

… setting does. Thanks to ttencate for the report and draft text.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@14110 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 888168003a78577290094d3c0f290fe87f18342e 1 parent 06bad9e
Gabriel Hurley authored
Showing with 10 additions and 5 deletions.
  1. +10 −5 docs/ref/settings.txt
15 docs/ref/settings.txt
View
@@ -96,9 +96,14 @@ APPEND_SLASH
Default: ``True``
-Whether to append trailing slashes to URLs. This is only used if
-``CommonMiddleware`` is installed (see :doc:`/topics/http/middleware`). See also
-``PREPEND_WWW``.
+When set to ``True``, if the request URL does not match any of the patterns
+in the URLconf and it doesn't end in a slash, an HTTP redirect is issued to the
+same URL with a slash appended. Note that the redirect may cause any data
+submitted in a POST request to be lost.
+
+The ``APPEND_SLASH`` setting is only used if
+:class:`~django.middleware.common.CommonMiddleware` is installed
+(see :doc:`/topics/http/middleware`). See also :setting:`PREPEND_WWW`.
.. setting:: AUTHENTICATION_BACKENDS
@@ -1214,8 +1219,8 @@ PREPEND_WWW
Default: ``False``
Whether to prepend the "www." subdomain to URLs that don't have it. This is only
-used if ``CommonMiddleware`` is installed (see :doc:`/topics/http/middleware`).
-See also ``APPEND_SLASH``.
+used if :class:`~django.middleware.common.CommonMiddleware` is installed
+(see :doc:`/topics/http/middleware`). See also :setting:`APPEND_SLASH`.
.. setting:: PROFANITIES_LIST
Please sign in to comment.
Something went wrong with that request. Please try again.