EMAIL_HOST_PASSWORD doc says it's a Username

[Karen Tracey <kmtracey@…>]

The documentation for EMAIL_HOST_PASSWORD states that it is the: "Username to use for the SMTP server defined in EMAIL_HOST. If empty, Django won’t attempt authentication." Shouldn't that be Password? Maybe something like:

Password to use for the SMTP server defined in EMAIL_HOST. This setting is used in conjunction with EMAIL_HOST_USER when authenticating to the SMTP server. If either of these settings is empty, Django won't attempt authenticaion.

(I actually didn't check the code to see if that last sentence is true; I'm not sure what the code does if one of these is empty but the other is not.)

I'd also suggest that it would be helpful if the send_mail documentation (​http://www.djangoproject.com/documentation/email/) pointed to these settings. Not sure if that should be a different ticket?

[Chris Beaven]

Thanks for the report, Karen.

I say this ticket can probably cover both issues. If you have the competence, a patch would be helpful!

[Karen Tracey <kmtracey@…>]

Well I took a shot at it, though I'll admit I'm unfamiliar with the format of the documentation files (is it described somewhere? I couldn't find it.) So I just tried to match what I already saw being done there. Hopefully it's at least useful as a starting idea for what to change.

[Chris Beaven]

Thanks Karen, great job! Better than a starting idea, I reckon that's about ready for checkin.

[Chris Beaven]

PS: The documentation format is ​restructured text

[Karen Tracey <kmtracey@…>]

Thanks for the pointer, that'll come in handy for any future doc changes I might suggest. I also forgot to mention that I did verify that the one sentence I wasn't sure about above is a correct description of how the code works.

[Malcolm Tredinnick]

(In [5111]) Fixed #4163 -- Added some "quick notes" documentation about the configuration
variables required to send email. Thanks, Karen Tracey.