diff --git a/uppsrc/Core/src.tpp/TcpSocket$en-us.tpp b/uppsrc/Core/src.tpp/TcpSocket$en-us.tpp
index b8f18ee74..5939c6fff 100644
--- a/uppsrc/Core/src.tpp/TcpSocket$en-us.tpp
+++ b/uppsrc/Core/src.tpp/TcpSocket$en-us.tpp
@@ -153,7 +153,9 @@ switches SO`_LINGER off.&]
 [s2;%% Waits for at most timeout for [%-*@3 events], which can be a 
 combination of WAIT`_READ (wait for more input bytes available), 
 WAIT`_WRITE (wait till it is possible to write something to socket). 
-Wait also always returns when socket exception happens.&]
+Wait also always returns when socket exception happens. Returns 
+true if wait was successful (data can be written/read after the 
+wait), false on timeout.&]
 [s3;%% &]
 [s4;%% &]
 [s5;:TcpSocket`:`:WaitRead`(`): [@(0.0.255) bool]_[* WaitRead]()&]