Skip to content

Commit 22bc9aa

Browse files
committed
personal review fixes
1 parent c637402 commit 22bc9aa

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

Doc/library/io.rst

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -592,10 +592,10 @@ I/O Base Classes
592592

593593
.. method:: read1(size=-1, /)
594594

595-
Read and return up to *size* bytes, calilng ``raw.readinto``,
596-
retrying if :py:const:`~errno.EINTR` is encountered per :pep:`475`. If
597-
*size* is ``-1`` or not provided, the implementation will choose an
598-
arbitrary value for *size*.
595+
Read and return up to *size* bytes, calling :meth:`~RawIOBase.readinto`
596+
which may retry if :py:const:`~errno.EINTR` is encountered per
597+
:pep:`475`. If *size* is ``-1`` or not provided, the implementation will
598+
choose an arbitrary value for *size*.
599599

600600
.. note::
601601

@@ -748,14 +748,14 @@ than raw I/O does.
748748

749749
.. method:: read1(size=-1, /)
750750

751-
In :class:`BytesIO`, this is the same as :meth:`io.BufferedIOBase.read`.
751+
In :class:`BytesIO`, this is the same as :meth:`~BufferedIOBase.read`.
752752

753753
.. versionchanged:: 3.7
754754
The *size* argument is now optional.
755755

756756
.. method:: readinto1(b, /)
757757

758-
In :class:`BytesIO`, this is the same as :meth:`io.BufferedIOBase.readinto`.
758+
In :class:`BytesIO`, this is the same as :meth:`~BufferedIOBase.readinto`.
759759

760760
.. versionadded:: 3.5
761761

@@ -854,7 +854,7 @@ than raw I/O does.
854854
:data:`DEFAULT_BUFFER_SIZE`.
855855

856856
:class:`BufferedRWPair` implements all of :class:`BufferedIOBase`\'s methods
857-
except for :meth:`io.BufferedIOBase.detach`, which raises
857+
except for :meth:`~BufferedIOBase.detach`, which raises
858858
:exc:`UnsupportedOperation`.
859859

860860
.. warning::
@@ -1004,8 +1004,8 @@ Text I/O
10041004
If *line_buffering* is ``True``, :meth:`~IOBase.flush` is implied when a call to
10051005
write contains a newline character or a carriage return.
10061006

1007-
If *write_through* is ``True``, calls to :meth:`io.BufferedIOBase.write` are
1008-
guaranteed not to be buffered: any data written on the :class:`TextIOWrapper`
1007+
If *write_through* is ``True``, calls to :meth:`~BufferedIOBase.write` are guaranteed
1008+
not to be buffered: any data written on the :class:`TextIOWrapper`
10091009
object is immediately handled to its underlying binary *buffer*.
10101010

10111011
.. versionchanged:: 3.3

0 commit comments

Comments
 (0)