Added 'Multiple view prefixes' section to docs/url_dispatch.txt. Thanks, Slowness Chen

git-svn-id: http://code.djangoproject.com/svn/django/trunk@2816 bcc190cf-cafb-0310-a4f2-bffc1f526a37

1 files changed, 31 insertions, 0 deletions

diff --git a/docs/url_dispatch.txt b/docs/url_dispatch.txt
index 3b83a98804..fe09fe18cd 100644
--- a/docs/url_dispatch.txt
+++ b/docs/url_dispatch.txt
@@ -288,6 +288,37 @@ that in automatically.
 
 .. _Django overview: http://www.djangoproject.com/documentation/overview/
 
+Multiple view prefixes
+----------------------
+
+In practice, you'll probably end up mixing and matching views to the point
+where the views in your ``urlpatterns`` won't have a common prefix. However,
+you can still take advantage of the view prefix shortcut to remove duplication.
+Just add multiple ``patterns()`` objects together, like this:
+
+Old::
+
+    from django.conf.urls.defaults import *
+
+    urlpatterns = patterns( ''
+        (r'^/?$', 'django.views.generic.date_based.archive_index'),
+        (r'^(?P<year>\d{4})/(?P<month>[a-z]{3})/$', 'django.views.generic.date_based.archive_month'),
+        (r'^tag/(?P<tag>\w+)/$', 'weblog.views.tag'),
+    )
+
+New::
+
+    from django.conf.urls.defaults import *
+
+    urlpatterns = patterns('django.views.generic.date_based'
+        (r'^/?$', 'archive_index'),
+        (r'^(?P<year>\d{4})/(?P<month>[a-z]{3})/$','archive_month'),
+    )
+
+    urlpatterns += patterns('weblog.views',
+        (r'^tag/(?P<tag>\w+)/$', 'tag'),
+    )
+
 Including other URLconfs
 ========================