New submission from A.M. Kuchling:
io.py contains the following to declare ABCs for some of its classes:
class IOBase(_io._IOBase, metaclass=abc.ABCMeta):
pass
(and similarly for RawIOBase, BufferedIOBase, TextIOBase).
_io._IOBase has an extensive docstring, but IOBase doesn't. (Python doesn't
inherit parent-class docstrings, on the theory that the subclass may change
things that make the docstring invalid.)
I propose the attached patch.
----------
files: io-copy-docstrings.patch
keywords: easy, patch
messages: 216210
nosy: akuchling
priority: normal
severity: normal
stage: patch review
status: open
title: io.py: Improve docstrings for classes
type: enhancement
Added file: http://bugs.python.org/file34847/io-copy-docstrings.patch
_______________________________________
Python tracker <[email protected]>
<http://bugs.python.org/issue21225>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com