diff -r 04db33c299a1 docs/url_dispatch.txt
--- a/docs/url_dispatch.txt	Wed Mar 19 01:04:19 2008 -0300
+++ b/docs/url_dispatch.txt	Wed Mar 19 11:24:11 2008 -0300
@@ -528,6 +528,24 @@ Note that if you use this technique -- p
 Note that if you use this technique -- passing objects rather than strings --
 the view prefix (as explained in "The view prefix" above) will have no effect.
 
+One useful application of the callable object syntax can be seen when using
+decorators; this allows you to apply decorators to views *in your URLconf*::
+
+    from django.conf.urls.defaults import *
+    from django.contrib.auth.decorators import login_required
+    from django.views.decorators.cache import cache_page
+    from mysite.views import archive, about, contact
+
+    urlpatterns = patterns('',
+        (r'^archive/$', login_required(archive)),
+        (r'^about/$', cache_page(about, 600)),
+        (r'^contact/$', contact),
+    )
+
+Note that in this case you can't use the string syntax to specify the view
+parameter to the decorator itself, you must use the callable object
+syntax.
+
 Naming URL patterns
 ===================