diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index 5ac44991397..23d6c6d32bf 100644
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -708,11 +708,13 @@ Text I/O
       Read and return at most *n* characters from the stream as a single
       :class:`str`.  If *n* is negative or ``None``, reads until EOF.
 
-   .. method:: readline()
+   .. method:: readline(limit=-1)
 
       Read until newline or EOF and return a single ``str``.  If the stream is
       already at EOF, an empty string is returned.
 
+      If *limit* is specified, at most *limit* characters will be read.
+
    .. method:: seek(offset, whence=SEEK_SET)
 
       Change the stream position to the given *offset*.  Behaviour depends