/**\r
Receive data from a network connection.\r
\r
- The ::recv routine waits for receive data from a remote network\r
- connection. The\r
+ The recv routine waits for receive data from a remote network\r
+ connection. This routine is typically used for SOCK_STREAM\r
+ because it waits for receive data from the target system specified\r
+ in the ::connect call.\r
+\r
+ The\r
<a href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/recv.html">POSIX</a>\r
documentation is available online.\r
\r
\r
@param [in] flags Message control flags\r
\r
- @return ::recv returns the number of valid bytes in the buffer,\r
+ @return This routine returns the number of valid bytes in the buffer,\r
zero if no data was received, and -1 when an error occurs.\r
- In the case of an error, errno contains more details.\r
+ In the case of an error, ::errno contains more details.\r
\r
**/\r
ssize_t\r