<div dir="ltr">I still think non-blocking sounds network-related...</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Aug 30, 2013 at 12:23 PM, Eli Bendersky <span dir="ltr"><<a href="mailto:eliben@gmail.com" target="_blank">eliben@gmail.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote"><div class="im">On Fri, Aug 30, 2013 at 10:07 AM, Antoine Pitrou <span dir="ltr"><<a href="mailto:solipsis@pitrou.net" target="_blank">solipsis@pitrou.net</a>></span> wrote:<br>



<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
Hello,<br>
<div><br>
On Fri, 30 Aug 2013 14:51:42 +0200 (CEST)<br>
eli.bendersky <<a href="mailto:python-checkins@python.org" target="_blank">python-checkins@python.org</a>> wrote:<br>
> diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst<br>
> --- a/Doc/library/xml.etree.elementtree.rst<br>
> +++ b/Doc/library/xml.etree.elementtree.rst<br>
> @@ -105,37 +105,42 @@<br>
>     >>> root[0][1].text<br>
>     '2008'<br>
><br>
> -Incremental parsing<br>
> -^^^^^^^^^^^^^^^^^^^<br>
> +Pull API for asynchronous parsing<br>
> +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^<br>
<br>
</div>I think the documentation should use another term than "asynchronous":<br>
"non-blocking" or "event-driven" would be fine. "Asynchronous" is loaded<br>
with various meanings and connotations which IMO make it the wrong term<br>
here.<br>
<br>
For example, in many contexts "asynchronous" means "does the job behind<br>
your back, e.g. in a worker thread". POSIX defines some asynchronous<br>
I/O APIs which are ostensibly not the same as non-blocking I/O:<br>
<a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/aio_read.html" target="_blank">http://pubs.opengroup.org/onlinepubs/9699919799/functions/aio_read.html</a><br></blockquote><div><br></div></div><div>Makes sense. I'll change it to non-blocking, since this doc already uses "blocking" here and there to refer to the opposite effect.<span class="HOEnZb"><font color="#888888"><br>



<br></font></span></div><span class="HOEnZb"><font color="#888888"><div>Eli<br></div><div><br> </div></font></span></div><br></div></div>
<br>_______________________________________________<br>
Python-Dev mailing list<br>
<a href="mailto:Python-Dev@python.org">Python-Dev@python.org</a><br>
<a href="http://mail.python.org/mailman/listinfo/python-dev" target="_blank">http://mail.python.org/mailman/listinfo/python-dev</a><br>
Unsubscribe: <a href="http://mail.python.org/mailman/options/python-dev/rymg19%40gmail.com" target="_blank">http://mail.python.org/mailman/options/python-dev/rymg19%40gmail.com</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br>Ryan
</div>