From b6d8957356fd7f23e806c65657a72f7316d66b61 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Tue, 2 Jul 2019 11:20:53 +0200 Subject: [PATCH] [2.2.x] Fixed #28588 -- Doc'd User.has_perm() & co. behavior for active superusers. Equivalent note for PermissionsMixin was added in d33864ed138f65070049a3ac20ee98e03a1442b9. Backport of 4b32d039dbb59b3c3e76587df5c58150e752d9ac from master --- docs/ref/contrib/auth.txt | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/ref/contrib/auth.txt b/docs/ref/contrib/auth.txt index 375831be0e1..7be5b55ee3e 100644 --- a/docs/ref/contrib/auth.txt +++ b/docs/ref/contrib/auth.txt @@ -220,7 +220,8 @@ Methods Returns ``True`` if the user has the specified permission, where perm is in the format ``"."``. (see documentation on :ref:`permissions `). If the user is - inactive, this method will always return ``False``. + inactive, this method will always return ``False``. For an active + superuser, this method will always return ``True``. If ``obj`` is passed in, this method won't check for a permission for the model, but for this specific object. @@ -230,7 +231,8 @@ Methods Returns ``True`` if the user has each of the specified permissions, where each perm is in the format ``"."``. If the user is inactive, - this method will always return ``False``. + this method will always return ``False``. For an active superuser, this + method will always return ``True``. If ``obj`` is passed in, this method won't check for permissions for the model, but for the specific object. @@ -239,7 +241,8 @@ Methods Returns ``True`` if the user has any permissions in the given package (the Django app label). If the user is inactive, this method will - always return ``False``. + always return ``False``. For an active superuser, this method will + always return ``True``. .. method:: email_user(subject, message, from_email=None, **kwargs)