Ticket #11545: default-permissions.diff

docs/topics/auth.txt

@@ -209 +209 @@
     .. method:: models.User.has_perm(perm)
 
         Returns ``True`` if the user has the specified permission, where perm is
-        in the format ``"<application name>.<lowercased model name>"``. If the
-        user is inactive, this method will always return ``False``.
+        in the format ``"<application name>.<permission name>"`` (see
+        `permissions`_ section below). If the user is inactive, this method will
+        always return ``False``.
 
     .. method:: models.User.has_perms(perm_list)
 
@@ -1085 +1086 @@
     def limited_object_detail(*args, **kwargs):
         return object_detail(*args, **kwargs)
 
+.. _permissions:
+
 Permissions
 ===========
 
@@ -1114 +1117 @@
 Default permissions
 -------------------
 
+Three default permissions are named after the application and the model.
+Assuming you have ``foo`` application with ``Bar`` model, in order to test
+for basic permissions you should use:
+
+    * add: ``user.has_perm('foo.add_bar')``
+    * change: ``user.has_perm('foo.change_bar')``
+    * delete: ``user.has_perm('foo.delete_bar')``
+
 When ``django.contrib.auth`` is listed in your :setting:`INSTALLED_APPS`
 setting, it will ensure that three default permissions -- add, change and
 delete -- are created for each Django model defined in one of your installed