(original) (raw)

changeset: 103233:1ed37f6e91bb branch: 3.5 parent: 103231:3bf2f6818719 user: R David Murray rdmurray@bitdance.com date: Wed Sep 07 14:01:23 2016 -0400 files: Doc/library/smtpd.rst Doc/library/socket.rst description: #26209: Clarify type of *localaddr*/*remoteadr* in smtpd docs. diff -r 3bf2f6818719 -r 1ed37f6e91bb Doc/library/smtpd.rst --- a/Doc/library/smtpd.rst Wed Sep 07 13:39:36 2016 -0400 +++ b/Doc/library/smtpd.rst Wed Sep 07 14:01:23 2016 -0400 @@ -32,9 +32,10 @@ map=None, enable_SMTPUTF8=False, decode_data=True) Create a new :class:`SMTPServer` object, which binds to local address - *localaddr*. It will treat *remoteaddr* as an upstream SMTP relayer. It - inherits from :class:`asyncore.dispatcher`, and so will insert itself into - :mod:`asyncore`'s event loop on instantiation. + *localaddr*. It will treat *remoteaddr* as an upstream SMTP relayer. Both + *localaddr* and *remoteaddr* should be a :ref:`(host, port) ` + tuple. The object inherits from :class:`asyncore.dispatcher`, and so will + insert itself into :mod:`asyncore`'s event loop on instantiation. *data_size_limit* specifies the maximum number of bytes that will be accepted in a ``DATA`` command. A value of ``None`` or ``0`` means no diff -r 3bf2f6818719 -r 1ed37f6e91bb Doc/library/socket.rst --- a/Doc/library/socket.rst Wed Sep 07 13:39:36 2016 -0400 +++ b/Doc/library/socket.rst Wed Sep 07 14:01:23 2016 -0400 @@ -63,6 +63,8 @@ .. versionchanged:: 3.5 Writable :term:`bytes-like object` is now accepted. +.. _host_port: + - A pair ``(host, port)`` is used for the :const:`AF_INET` address family, where *host* is a string representing either a hostname in Internet domain notation like ``'daring.cwi.nl'`` or an IPv4 address like ``'100.50.200.5'``,/rdmurray@bitdance.com