From bd73eaf952b65b17580498fee846e8fddace68db Mon Sep 17 00:00:00 2001 From: James Bennett Date: Wed, 28 May 2008 20:31:03 +0000 Subject: [PATCH] Big glaring warning in docs/flatpages.txt to remind people how response middleware works git-svn-id: http://code.djangoproject.com/svn/django/trunk@7555 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/flatpages.txt | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/flatpages.txt b/docs/flatpages.txt index b6fa8e035f..a538217642 100644 --- a/docs/flatpages.txt +++ b/docs/flatpages.txt @@ -66,6 +66,17 @@ resort. For more on middleware, read the `middleware docs`_. +.. admonition:: Ensure that your 404 template works + + Note that the ``FlatpageFallbackMiddleware`` only steps in once + another view has successfully produced a 404 response. If another + view or middleware class attempts to produce a 404 but ends up + raising an exception instead (such as a ``TemplateDoesNotExist`` + exception if your site does not have an appropriate template to + use for HTTP 404 responses), the response will become an HTTP 500 + ("Internal Server Error") and the ``FlatpageFallbackMiddleware`` + will not attempt to serve a flat page. + .. _SITE_ID: ../settings/#site-id .. _RequestContext: ../templates_python/#subclassing-context-djangocontext .. _middleware docs: ../middleware/