Remove lies from API docblock for BasicAuthenticate class.

Add info on how to configure for cookieless/stateless operation without redirection.
Merge pull request #3666 from ADmad/2.5-basic-auth

Remove lies from API docblock for BasicAuthenticate class.