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 stutzbach
Recipients benjamin.peterson, docs@python, ezio.melotti, fdrake, georg.brandl, pitrou, stutzbach
Date 2010-11-30.22:36:23
SpamBayes Score 2.0778481e-08
Marked as misclassified No
Message-id <1291156586.97.0.696738327069.issue10589@psf.upfronthosting.co.za>
In-reply-to
Content
> What does "unsupported" mean? "Abstract" would look more exact.

It means they raise io.UnsupportedOperation when called (unless the subclass overrides them to do something else).  

They are not marked with @abstractmethod, so "Abstract" would be wrong.

It should be a bit more clear in context.  Here's a link to the point in the documentation where the table would fit:
http://docs.python.org/dev/py3k/library/io.html#class-hierarchy

The most relevant bit is: "implementations are allowed to raise UnsupportedOperation if they do not support a given operation."

> E.g. "readinto" is listed as provided by RawIOBase in the doc text.

The doc text describes the API.  That is, it describes what the readinto method should do if a subclass of RawIOBase decides to implement it.  The existing text doesn't contain any clues as to which methods contain useful implementations versus which will raise io.UnsupportedOperation if not overridden.  Hence the need for the table.
History
Date User Action Args
2010-11-30 22:36:27stutzbachsetrecipients: + stutzbach, fdrake, georg.brandl, pitrou, benjamin.peterson, ezio.melotti, docs@python
2010-11-30 22:36:26stutzbachsetmessageid: <1291156586.97.0.696738327069.issue10589@psf.upfronthosting.co.za>
2010-11-30 22:36:23stutzbachlinkissue10589 messages
2010-11-30 22:36:23stutzbachcreate