Document BufferedReader.peek and BytesIO.peek similarly

Author: marcelm

Doc/library/io.rst

@@ -731,9 +731,10 @@ than raw I/O does.
    .. method:: peek(size=1, /)
 
       Return bytes from the current position onwards without advancing the position.
+      At least one byte of data is returned if not at EOF.
+      Return an empty :class:`bytes` object at EOF.
       If the size argument is less than one or larger than the number of available bytes,
       a copy of the buffer from the current position until the end is returned.
-      Return an empty bytes object at EOF.
 
       .. versionadded:: 3.13
 
@@ -769,9 +770,12 @@ than raw I/O does.
 
    .. method:: peek(size=0, /)
 
-      Return bytes from the stream without advancing the position.  At most one
-      single read on the raw stream is done to satisfy the call. The number of
-      bytes returned may be less or more than requested.
+      Return bytes from the current position onwards without advancing the position.
+      At least one byte of data is returned if not at EOF.
+      Return an empty :class:`bytes` object at EOF.
+      At most one single read on the underlying raw stream is done to satisfy the call.
+      The exact number of bytes returned is unspecified
+      (*size* is ignored).
 
    .. method:: read(size=-1, /)