This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author sandro.tosi
Recipients docs@python, sandro.tosi
Date 2012-06-06.07:44:21
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1338968663.18.0.754320203153.issue15013@psf.upfronthosting.co.za>
In-reply-to
Content
In the smtplib doc I read:

  Low-level methods corresponding to the standard SMTP/ESMTP commands HELP, RSET, NOOP, MAIL, RCPT, and DATA are also supported. Normally these do not need to be called directly, so they are not documented here. For details, consult the module code.

Well, I think the documentation should include also those low-level apis (maybe in a separate subsection).

From my POV, smtplib should implement the protocol, and give the programmers the tools to use the protocol as they prefers, and as a plus some companion methods to easy the most common operations.

I'm in need to use the low-level apis, and not finding them in the doc is a disservice to me (with my user hat on ;)) and just say "go read the source" is kinda rude and unexpected.

What do you think?
History
Date User Action Args
2012-06-06 07:44:23sandro.tosisetrecipients: + sandro.tosi, docs@python
2012-06-06 07:44:23sandro.tosisetmessageid: <1338968663.18.0.754320203153.issue15013@psf.upfronthosting.co.za>
2012-06-06 07:44:22sandro.tosilinkissue15013 messages
2012-06-06 07:44:21sandro.tosicreate