Index: docs/model-api.txt
===================================================================
--- docs/model-api.txt	(revision 7519)
+++ docs/model-api.txt	(working copy)
@@ -2001,10 +2001,22 @@
 Notice that we specify an empty sequence for the second parameter in this case,
 because we only want to pass keyword parameters, not positional ones.
 
+You can also use a `named url pattern`_ like this::
+
+    url(r'^people/(\d+)/$', 'people.views.details', name='people_detail')
+
+...you could reference this using ``permalink()`` as follows::
+
+    def get_absolute_url(self):
+        return ('people_detail', [str(self.id)])
+    get_absolute_url = permalink(get_absolute_url)
+
 In this way, you're tying the model's absolute URL to the view that is used
 to display it, without repeating the URL information anywhere. You can still
 use the ``get_absolute_url`` method in templates, as before.
 
+.. _named url pattern: ../url_dispatch/#naming-url-patterns
+
 Executing custom SQL
 --------------------