in read1 refer to EINTR retrying

python · gpshead · May 21, 2025 · Feb 27, 2025 · Feb 27, 2025 · Feb 27, 2025
commit 7c4ef7ea360e4b5025d50fde024383151e0872da
diff --git a/Doc/library/io.rst b/Doc/library/io.rst
@@ -592,11 +592,10 @@

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

-      Read and return up to *size* bytes, with at most one call to the
-      underlying raw stream's :meth:`~RawIOBase.read` (or
-      :meth:`~RawIOBase.readinto`) method. If *size* is ``-1`` or not provided,
-      the implementation will decide a size to use and at most one call will be
-      made.
+      Read and return up to *size* bytes, calilng :meth:`~raw.readinto`,
+      retrying if :py:const:`~errno.EINTR` is encountered per  :pep:`475`. If
+      *size* is ``-1`` or not provided, the implementation will choose an
+      arbitrary value for *size*.

      .. note::