diff Doc/lib/libsocket.tex @ 36126:23eb8677bdad legacy-trunk

Bug #756104: document that bufsize in socket.recv() should be small
author Georg Brandl <georg@python.org>
date Mon, 26 Dec 2005 23:07:46 +0000
parents 5d5236eae8bd
children 42312e5f11fd ae4480935016
line wrap: on
line diff
--- a/Doc/lib/libsocket.tex	Mon Dec 26 22:53:56 2005 +0000
+++ b/Doc/lib/libsocket.tex	Mon Dec 26 23:07:46 2005 +0000
@@ -557,6 +557,8 @@
 at once is specified by \var{bufsize}.  See the \UNIX{} manual page
 \manpage{recv}{2} for the meaning of the optional argument
 \var{flags}; it defaults to zero.
+\note{For best match with hardware and network realities, the value of 
+\var{bufsize} should be a relatively small power of 2, for example, 4096.}
 \end{methoddesc}
 
 \begin{methoddesc}[socket]{recvfrom}{bufsize\optional{, flags}}