From 888168003a78577290094d3c0f290fe87f18342e Mon Sep 17 00:00:00 2001 From: Gabriel Hurley Date: Sun, 10 Oct 2010 06:36:38 +0000 Subject: [PATCH] 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 --- docs/ref/settings.txt | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index c72b171ece..26b5e7cd48 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -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