From: Gurusamy Sarathy <gsar@cpan.org>
Date: Sun, 10 Oct 1999 00:51:48 +0000 (+0000)
Subject: better documentation for recv() (from Anton Berezin
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=478234b44aea7800ebba14003c0ebc1817d65a58;p=p5sagit%2Fp5-mst-13.2.git

better documentation for recv() (from Anton Berezin
<tobez@plab.ku.dk>)

p4raw-id: //depot/perl@4326
---

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index c69c1cb..450dd4b 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -3257,12 +3257,13 @@ operator is discussed in more detail in L<perlop/"I/O Operators">.
 =item recv SOCKET,SCALAR,LENGTH,FLAGS
 
 Receives a message on a socket.  Attempts to receive LENGTH bytes of
-data into variable SCALAR from the specified SOCKET filehandle.
-Actually does a C C<recvfrom>, so that it can return the address of the
-sender.  Returns the undefined value if there's an error.  SCALAR will
-be grown or shrunk to the length actually read.  Takes the same flags
-as the system call of the same name.
-See L<perlipc/"UDP: Message Passing"> for examples.
+data into variable SCALAR from the specified SOCKET filehandle.  SCALAR
+will be grown or shrunk to the length actually read.  Takes the same
+flags as the system call of the same name.  Returns the address of the
+sender if SOCKET's protocol supports this; returns an empty string
+otherwise.  If there's an error, returns the undefined value.  This call
+is actually implemented in terms of recvfrom(2) system call.  See
+L<perlipc/"UDP: Message Passing"> for examples.
 
 =item redo LABEL