On Thu, 06 Dec 2012 04:15:08 +1100
Steven D'Aprano <st...@pearwood.info> wrote:
> On 06/12/12 03:08, Chris Withers wrote:
> 
> > I'd like to change the docs for poll() to say:
> >
> > """
> > Check if child process has terminated.
> > If it has, the returncode attribute will be set and that value will be 
> > returned.
> > If it has not, None will be returned and the returncode attribute will 
> > remain None.
> > """
> >
> > Any objections?
> 
> Possibly because it is 4am here, I had to read this three times to understand 
> it.
> How is this instead?
> 
> """
> Check if child process has terminated. Returns None while the child is still 
> running,
> any non-None value means that the child has terminated. In either case, the 
> return
> value is also available from the instance's returncode attribute.
> """

I like this wording.

Regards

Antoine.


_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to