summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMalcolm Tredinnick <malcolm.tredinnick@gmail.com>2008-10-06 08:31:32 +0000
committerMalcolm Tredinnick <malcolm.tredinnick@gmail.com>2008-10-06 08:31:32 +0000
commitfa63f1642d3899324a6d051e964ce4b878170ff9 (patch)
tree240e373ab92b4554ef3c61348921d8b35f31aca3
parentcddece2db12c28e4f87f7c4d1819461f573d157f (diff)
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
-rw-r--r--docs/topics/http/urls.txt14
1 files changed, 14 insertions, 0 deletions
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()
-----------