From d33864ed138f65070049a3ac20ee98e03a1442b9 Mon Sep 17 00:00:00 2001 From: Tobias Bengfort Date: Sat, 10 Nov 2018 11:11:00 +0100 Subject: [PATCH] Corrected PermissionsMixin docs regarding User.is_active and is_superuser. --- docs/topics/auth/customizing.txt | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/topics/auth/customizing.txt b/docs/topics/auth/customizing.txt index 517bf05c2f..51d1e2abe5 100644 --- a/docs/topics/auth/customizing.txt +++ b/docs/topics/auth/customizing.txt @@ -919,8 +919,9 @@ methods and attributes: Returns ``True`` if the user has the specified permission, where ``perm`` is in the format ``"."`` (see - :ref:`permissions `). If the user is inactive, this method will - always return ``False``. + :ref:`permissions `). If :attr:`.User.is_active` + and :attr:`~.User.is_superuser` are both ``True``, this method always + returns ``True``. If ``obj`` is passed in, this method won't check for a permission for the model, but for this specific object. @@ -929,8 +930,9 @@ methods and attributes: 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``. + ``"."``. If :attr:`.User.is_active` and + :attr:`~.User.is_superuser` are both ``True``, this method always + returns ``True``. If ``obj`` is passed in, this method won't check for permissions for the model, but for the specific object. @@ -938,8 +940,9 @@ methods and attributes: .. method:: models.PermissionsMixin.has_module_perms(package_name) 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``. + (the Django app label). If :attr:`.User.is_active` and + :attr:`~.User.is_superuser` are both ``True``, this method always + returns ``True``. .. admonition:: ``PermissionsMixin`` and ``ModelBackend``