Ticket #7216: permalink_doc.diff

docs/model-api.txt

@@ -2005 +2005 @@
 to display it, without repeating the URL information anywhere. You can still
 use the ``get_absolute_url`` method in templates, as before.
 
+In some cases, such as the use of generic views or the re-use of custom views for multiple models, specifying the view function may confuse the reverse URL matcher (because multiple patterns point to the same view).
+
+For that problem, Django has **named URL patterns**, it's possible to give a name to a pattern (by replacing the pattern tuple by a call to the ``url`` function)::
+
+    from django.conf.urls.defaults import *
+
+    url(r'^people/(\d+)/$', 'django.views.generic.list_detail.object_detail', name='people_view'),
+
+and then use that name to perform the reverse URL resolution instead of the view name::
+
+    from django.db.models import permalink
+
+    def get_absolute_url(self):
+        return ('people_view', [str(self.id)])
+    get_absolute_url = permalink(get_absolute_url)
+
+More complete informations on named URL patterns are available at `url dispatch`_.
+
+.. _url dispatch: ../url_dispatch/#naming-url-patterns
+
 Executing custom SQL
 --------------------