From fa63f1642d3899324a6d051e964ce4b878170ff9 Mon Sep 17 00:00:00 2001 From: Malcolm Tredinnick Date: Mon, 6 Oct 2008 08:31:32 +0000 Subject: [PATCH] Fixed #8975 -- Added a note to the documentation for reverse() that all views must be importable for URL reversing to work correctly. git-svn-id: http://code.djangoproject.com/svn/django/trunk@9167 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/topics/http/urls.txt | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/topics/http/urls.txt b/docs/topics/http/urls.txt index aa07826d56..dcb434bf39 100644 --- a/docs/topics/http/urls.txt +++ b/docs/topics/http/urls.txt @@ -620,6 +620,20 @@ vertical bar (``"|"``) character. You can quite happily use such patterns for matching against incoming URLs and sending them off to views, but you cannot reverse such patterns. +.. admonition:: Make sure your views are all correct + + As part of working out which URL names map to which patterns, the + ``reverse()`` function has to import all of your URLConf files and examine + the name of each view. This involves importing each view function. If + there are *any* errors whilst importing any of your view functions, it + will cause ``reverse()`` to raise an error, even if that view function is + not the one you are trying to reverse. + + Make sure that any views you reference in your URLConf files exist and can + be imported correctly. Do not include lines that reference views you + haven't written yet, because those views will not be importable. + + permalink() -----------