Fixed user provider docblocks
Added missing request param
Fixed password broker docs
Merge pull request #5053 from GrahamCampbell/4.2-auth

[4.2] Fixed Auth Docblocks