[docs] [issue21700] Missing mention of DatagramProtocol having connection_made and connection_lost methods

Allen Riddell report at bugs.python.org
Tue Jun 10 02:19:35 CEST 2014


New submission from Allen Riddell:

The following important information from PEP 3156 does not appear in the asyncio library documentation:

"""Datagram protocols have connection_made() and connection_lost() methods with the same signatures as stream protocols."""

Indeed, reading the docs it looks like only ``Protocol`` and ``SubprocessProtocol`` have these methods. (See https://docs.python.org/3.4/library/asyncio-protocol.html#connection-callbacks)

The quick fix is to change the lines 275-276 in ``Doc/library/asyncio-protocol.rst`` from:

    These callbacks may be called on Protocol and SubprocessProtocol instances:

to

    These callbacks may be called on Protocol, DatagramProtocol, and SubprocessProtocol instances:

----------
assignee: docs at python
components: Documentation, asyncio
messages: 220130
nosy: ariddell, docs at python, gvanrossum, haypo, yselivanov
priority: normal
severity: normal
status: open
title: Missing mention of DatagramProtocol having connection_made and connection_lost methods
type: enhancement
versions: Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21700>
_______________________________________


More information about the docs mailing list