[New-bugs-announce] [issue31065] Documentation for Popen.poll is unclear

[Mark Dickinson]

New submission from Mark Dickinson:

The documentation for Popen.poll says:

> Check if child process has terminated. Set and return returncode attribute.

This requires the reader to guess that if the child process has not terminated, the call returns immediately, with a return value of ``None``. It would be good to be explicit about this.

----------
assignee: docs at python
components: Documentation
messages: 299378
nosy: docs at python, mark.dickinson
priority: normal
severity: normal
status: open
title: Documentation for Popen.poll is unclear
versions: Python 2.7, Python 3.6, Python 3.7

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