Attached patches document get_event_loop() and BaseEventLoop; and add two "hello world" examples copied from:
http://code.google.com/p/tulip/source/browse/#hg%2Fexamples

I know that the documentation contains a lot of XXX, but it documents at least the prototype of the methods. I may provide more patches fixing XXX later ;-)

I hesitated to document the Handle class, but it looks like Guido prefers to not document it?

Since there are many event loop methods, I structured the doc so that methods are grouped in different sections: see the existing "delayed calls" and "creating connections" sections.

I'm not saying it's the best solution (is it?), but I think it would be nice to be consistent :)

> Since there are many event loop methods, I structured the doc so that methods are grouped in different sections: see the existing "delayed calls" and "creating connections" sections.

Seriously, I read the documentation three times (HTML and the source), but I didn't notice that asyncio.call_later() is not a function, but a method of an object.

> I'm not saying it's the best solution (is it?), but I think it would be nice to be consistent :)

There are too many methods, it's a good solution. I will rewrite asyncio_doc_eventloop.patch to group the methods.

Before that, here is a patch to mention the class for methods.

I would much rather review the docs after they've been committed.

One reason I originally didn't add the class names to the methods is that I don't know if we want to document the inheritance hierarchy. Guido, what do you think?

New changeset 7b4d046dbf56 by Victor Stinner in branch 'default':
Issue #19833: asyncio doc: add class name to methods
http://hg.python.org/cpython/rev/7b4d046dbf56

New changeset b25458022965 by Victor Stinner in branch 'default':
Issue #19833: add 2 examples to asyncio doc (hello world)
http://hg.python.org/cpython/rev/b25458022965

New changeset 5e4ea92f9a9b by Victor Stinner in branch 'default':
Issue #19833: Document more asyncio.BaseEventLoop methods
http://hg.python.org/cpython/rev/5e4ea92f9a9b

I documented many new classes. I read the source code and copied classes to extract docstrings.

Instead of BaseXXX classes, it's maybe better to document AbstractXXX classes.