[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2014-01-23 Thread STINNER Victor 

STINNER Victor added the comment:

> I've done a bit of it now, I'll let other people continue.

I continued the work on the documentation. Even if it's not complete, I 
consider that the initial issue "Add docs for asyncio package (Tulip, PEP 
3156)" is done, and so I close the issue.

--
resolution:  -> fixed
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-23 Thread Phil Connell 

Changes by Phil Connell :


--
nosy: +pconnell

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-23 Thread Antoine Pitrou 

Antoine Pitrou added the comment:

I've done a bit of it now, I'll let other people continue.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-22 Thread Roundup Robot 

Roundup Robot added the comment:

New changeset e4b7377a690a by Antoine Pitrou in branch 'default':
Issue #19291: add crude stubs to the asyncio docs
http://hg.python.org/cpython/rev/e4b7377a690a

--
nosy: +python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-22 Thread Guido van Rossum 

Guido van Rossum added the comment:

Thanks -- please just commit, we can iterate.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-22 Thread Antoine Pitrou 

Antoine Pitrou added the comment:

Following patch stubs a couple of things, this is very crude though.

--
Added file: http://bugs.python.org/file32787/asyncio_stub.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-22 Thread Guido van Rossum 

Guido van Rossum added the comment:

OK. I accidentally committed the patch. Will move the three modules to the
ipc section now.

On Fri, Nov 22, 2013 at 11:47 AM, Eric Snow  wrote:

>
> Eric Snow added the comment:
>
> I was thinking the same thing as Antoine.  18 fits in more closely to what
> I understand is the purpose of asyncio (the focus on IO).
>
> --
> nosy: +eric.snow
>
> ___
> Python tracker 
> 
> ___
>

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-22 Thread Eric Snow 

Eric Snow added the comment:

I was thinking the same thing as Antoine.  18 fits in more closely to what I 
understand is the purpose of asyncio (the focus on IO).

--
nosy: +eric.snow

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-22 Thread Antoine Pitrou 

Antoine Pitrou added the comment:

> There is one urgent issue: should the chapter on asyncio go into
> section 17 (Concurrent Execution) or section 18 (Interprocess
> Communication and Networking)???

I'd put it in 18. Also, I'd move select and selectors from 17 to 18, so that 
only purely "execution" modules remain in 17, and anything network-related is 
in the same chapter.

--
nosy: +pitrou

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-22 Thread Guido van Rossum 

Guido van Rossum added the comment:

I need help!

There is one urgent issue: should the chapter on asyncio go into section 17 
(Concurrent Execution) or section 18 (Interprocess Communication and 
Networking)???  It would seem that event loops and coroutines fit better in 
section 17, while transports and protocols fit better in section 18. :-(  HELP!!

After that, I need help writing the docs. Most of it can probably be 
copy-pasted from PEP 3156, but I haven't written Python docs for a long time 
and I could use some help with how to structure it.  Ideally we'd find some 
volunteers who enjoy writing documentation to take over this project.

In the mean time, I have a patch that adds a stub with a reference to the PEP, 
so people can at least navigate to the docs without already knowing the PEP 
number.  It adds it to section 17 for now.

--
keywords: +patch
Added file: http://bugs.python.org/file32780/asynciodoc.patch

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-14 Thread STINNER Victor 

Changes by STINNER Victor :


--
nosy: +haypo

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-11-13 Thread Martin Panter 

Changes by Martin Panter :


--
nosy: +vadmium

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-10-20 Thread Ezio Melotti 

Changes by Ezio Melotti :


--
components: +Documentation
stage:  -> needs patch
type:  -> enhancement

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-10-19 Thread Antoine Pitrou 

Changes by Antoine Pitrou :


--
nosy: +eric.araujo, ezio.melotti, georg.brandl

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-10-18 Thread Giampaolo Rodola' 

Changes by Giampaolo Rodola' :


--
nosy: +giampaolo.rodola

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue19291] Add docs for asyncio package (Tulip, PEP 3156)

2013-10-18 Thread Guido van Rossum 

New submission from Guido van Rossum:

The asyncio module needs documentation.  I'll work on this in time for the beta 
1 release.  Until then, please refer to PEP 3156.

--
assignee: gvanrossum
messages: 200324
nosy: gvanrossum
priority: deferred blocker
severity: normal
status: open
title: Add docs for asyncio package (Tulip, PEP 3156)
versions: Python 3.4

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com