Message155615
Thanks for the patch.
- This function returns a file-like object with two additional methods from
+ This function returns a file-like object that supports the Context Manager
+ protocol, with two additional methods from
The capitalization seems unneeded to me. Also, in my opinion saying “file-like” implies support for the context manager protocol, even if not all file-likes do, and anyway not all users share my assumption. What do you think about this wording:
This function returns a file-like object that works as a :term:`context manager`
and has two additional methods from the :mod:`urllib.response` module
The term role creates a link to the glossary. (BTW the entry for context manager could be improved to give open as example; I’ll do that.)
+It is also possible to achieve the same result using a context manager
+approach. ::
I would rather use with statements everywhere, or if it makes sense to have examples both with and without with, to put the example with with first. |
|
Date |
User |
Action |
Args |
2012-03-13 14:29:57 | eric.araujo | set | recipients:
+ eric.araujo, orsenthil, mcjeff |
2012-03-13 14:29:56 | eric.araujo | set | messageid: <1331648996.98.0.856331588607.issue12365@psf.upfronthosting.co.za> |
2012-03-13 14:29:55 | eric.araujo | link | issue12365 messages |
2012-03-13 14:29:55 | eric.araujo | create | |
|