Changeset 7110

Timestamp:

02/13/08 22:54:03 (8 months ago)

Author:

mtredinnick

Message:

Updated the documentation for patterns() to note Python's 255 argument limit.

Files:

• django/trunk/docs/url_dispatch.txt (modified) (1 diff)

django/trunk/docs/url_dispatch.txt

@@ -191 +191 @@
-`Passing extra options to view functions`_ below.)
-
+.. note::
+    Since `patterns()` is a function call, it accepts a maximum of 255
+    arguments (URL patterns, in this case). This is a limit for all Python
+    function calls. This will rarely be  problem in practice, since you'll
+    typically structure your URL patterns modularly by using `include()`
+    sections. However, on the off-chance you do hit the 255-argument limit,
+    realise that `patterns()` returns a Python list, so you can split up the
+    construction of the list.
+
+    ::
+
+        urlpatterns = patterns('',
+            ...
+            )
+        urlpatterns += patterns('',
+            ...
+            )
+
+    Python lists have unlimited size, so there's no limit to how many URL
+    patterns you can construct; merely that you may only create 254 at a time
+    (the 255-th argument is the initial prefix argument).
+
-url
----