Ticket #11124: 11124-ModelAdmin_has_x_permission_docstrings-r10793.diff

django/contrib/admin/options.py

@@ -272 +272 @@
 
     def has_change_permission(self, request, obj=None):
         """
-        Returns True if the given request has permission to change the given
-        Django model instance.
+        A subclass-provided version of this method can return True if the given
+        request has permission to change the given Django model instance `obj`.
 
-        If `obj` is None, this should return True if the given request has
-        permission to change *any* object of the given type.
+        If `obj` is None, it should return True if the given request has
+        permission to change *any* object of the model associated with this
+        ModelAdmin.  This default implementation does exactly that and simply
+        ignores `obj`.
         """
         opts = self.opts
         return request.user.has_perm(opts.app_label + '.' + opts.get_change_permission())
 
     def has_delete_permission(self, request, obj=None):
         """
-        Returns True if the given request has permission to change the given
-        Django model instance.
+        A subclass-provided version of this method can return True if the given
+        request has permission to delete the given Django model instance `obj`.
 
-        If `obj` is None, this should return True if the given request has
-        permission to delete *any* object of the given type.
+        If `obj` is None, it should return True if the given request has
+        permission to delete *any* object of the model associated with this
+        ModelAdmin. This default implementation does exactly that and simply
+        ignores `obj`.
         """
         opts = self.opts
         return request.user.has_perm(opts.app_label + '.' + opts.get_delete_permission())