<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">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 class="im"><br>
On Fri, 30 Aug 2013 14:51:42 +0200 (CEST)<br>
eli.bendersky <<a href="mailto:python-checkins@python.org">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>Makes sense. I'll change it to non-blocking, since this doc already uses "blocking" here and there to refer to the opposite effect.<br>

<br></div><div>Eli<br></div><div><br> </div></div><br></div></div>