[issue11203] gzip doc is behind

[K Richard Pixley]

K Richard Pixley <rich at noir.com> added the comment:

My point was for python-2.7.  I haven't stumbled into the buffer protocol yet.  So no, it doesn't really.

I still think the documentation, especially the 2.7 doc, could be more explicit.

My concern here is with the use of close() becoming obscure, a second class citizen, or an afterthought.  While I greatly appreciate the context manager, there are times when I want an enduring open channel for which the context manager just isn't appropriate.  Even in a world with context manager, open and close need to be available and presented as a pair.

It isn't clear to me from reading the doc or looking at the examples that gzip is expected to support a close call.  Yes, I concur that there is an implication, but I would prefer to see it stated explicitly along with the explicit statement that it supports an open call.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11203>
_______________________________________