id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
20426	note about the AuthenticationForm API	joel.hansson@…	nobody	"On https://docs.djangoproject.com/en/1.5/topics/auth/default/#django.contrib.auth.forms.AuthenticationForm

The django.contrib.auth.forms.AuthenticationForm needs two arguments passed when creating the object in the view.

form = AuthenticationForm(request, request.POST)

I was unable to find this in the documentation anywhere.

Since I didn't know this, I thought it would take the same arguments as documented at https://docs.djangoproject.com/en/1.5/topics/forms/#using-a-form-in-a-view

I initially tried that, but there was no exception raised, nothing in form.errors. However form.is_valid() still returned False.

Discovered the solution by joining #django @ freenode and was pointed to the actual source code which explained the issue.

A Note about this in the docs would have saved me an hour of hair-tearing ;)"	Cleanup/optimization	closed	Documentation	1.5	Normal	fixed			Unreviewed	0	0	0	0	0	1