homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eric.araujo
Recipients eric.araujo, mcjeff, orsenthil
Date 2012年03月13日.14:29:55
SpamBayes Score 2.449092e-08
Marked as misclassified No
Message-id <1331648996.98.0.856331588607.issue12365@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2012年03月13日 14:29:57eric.araujosetrecipients: + eric.araujo, orsenthil, mcjeff
2012年03月13日 14:29:56eric.araujosetmessageid: <1331648996.98.0.856331588607.issue12365@psf.upfronthosting.co.za>
2012年03月13日 14:29:55eric.araujolinkissue12365 messages
2012年03月13日 14:29:55eric.araujocreate

AltStyle によって変換されたページ (->オリジナル) /