#9913: authentication method docs wrong or confusing WRT returned value
------------------------------------+---------------------------------------
Reporter: ptone | Owner: nobody
Status: new | Milestone:
Component: Documentation | Version: SVN
Resolution: | Keywords:
Stage: Accepted | Has_patch: 0
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |
------------------------------------+---------------------------------------
Changes (by gwilson):
* needs_better_patch: => 0
* stage: Unreviewed => Accepted
* needs_tests: => 0
* needs_docs: => 0
Comment:
The documentation you are looking at is for the User model, in which case
the "Always returns True/False" statements are correct. In the
AnonymousUser's methods these values are opposite. I do agree however,
that the documentation for `is_authenticated` could be clearer and also
mention the fact that it's really only there to distinguish between a User
and an AnonymousUser. The mention of "it only indicates that the user has
provided a valid username and password" should also be clarified because
the `is_authenticated` method itself does not check this either. We
should mention the AuthenticationMiddleware here.
--
Ticket URL: <http://code.djangoproject.com/ticket/9913#comment:1>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to django-updates@googlegroups.com
To unsubscribe from this group, send email to
django-updates+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
