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
25229	Docs for permission_required decorator don't describe behavior for multiple permission arguments	Brendan Jurd	nobody	"The docs for permission_required say that you may pass in an iterable of permissions, but don't say anything about what that actually means.  Does it require ANY of the listed permissions, or ALL?

To figure this out, the user has to look up the source code for permission_required, see that it calls has_perms(), and then look up the docs for has_perms to see that it requires ALL the listed permissions to be held.  Sad trombone.

https://docs.djangoproject.com/en/1.8/topics/auth/default/#the-permission-required-decorator"	Cleanup/optimization	closed	Documentation	1.8	Normal	fixed			Accepted	1	0	0	0	0	0