diff --git a/README.md b/README.md
index 8ba76cd..1a4e0b7 100644
--- a/README.md
+++ b/README.md
@@ -348,6 +348,8 @@ read(size, timeout)
 
       Returns number of bytes read on success, 0 on timeout, or -1 on error.
 
+      On success, returns read string as second return value.
+
 set{line=state, ...}
       Set state of one or multiple tty modem lines.
 
diff --git a/man/tio.1.in b/man/tio.1.in
index b305d07..7dd7bc2 100644
--- a/man/tio.1.in
+++ b/man/tio.1.in
@@ -457,6 +457,8 @@ until data is ready to read.
 
 Returns number of bytes read on success, 0 on timeout, or -1 on error.
 
+On success, returns read string as second return value.
+
 .IP "\fBset{line=state, ...}"
 Set state of one or multiple tty modem lines.