Index: docs/model-api.txt
===================================================================
--- docs/model-api.txt	(revision 4680)
+++ docs/model-api.txt	(working copy)
@@ -1757,14 +1757,15 @@
 in the URLConf file and in the model.
 
 You can further decouple your models from the URLconf using the ``permalink``
-decorator. This decorator is passed the view function and any parameters you
-would use for accessing this instance directly. Django then works out the
-correct full URL path using the URLconf. For example::
+decorator. This decorator is passed the view function, a list of ordered
+parameters and (optionally) a dictionary of named parameters you would use for
+accessing this instance directly. Django then works out the correct full URL
+path using the URLconf. For example::
 
     from django.db.models import permalink
 
     def get_absolute_url(self):
-        return ('people.views.details', str(self.id))
+        return ('people.views.details', [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