*** empty log message ***

1 files changed, 54 insertions, 31 deletions

diff --git a/ace/SOCK_IO.h b/ace/SOCK_IO.h
index 147403c018e..9c582d97e88 100644
--- a/ace/SOCK_IO.h
+++ b/ace/SOCK_IO.h
@@ -22,51 +22,74 @@
 
 class ACE_Export ACE_SOCK_IO : public ACE_SOCK
   // = TITLE
-  //     Defines the methods for the ACE_SOCK I/O routines (i.e., send/recv). 
+  //     Defines the methods for the ACE socket wrapper I/O routines
+  //     (e.g., send/recv).
 {
 public:
-  ssize_t send (const void *buf, size_t n, int flags) const;
-  // Send an n byte buffer to the connected socket (uses send(3)).
-
-  ssize_t recv (void *buf, size_t n, int flags) const;
-  // Recv an n byte buffer from the connected socket (uses recv(3)).
-
-  ssize_t send (const void *buf, size_t n) const;
-  // Send an n byte buffer to the connected socket (uses write(2)).  
-
-  ssize_t recv (void *buf, size_t n) const;
-  // Recv an n byte buffer from the connected socket (uses read(2)).
-
-  ssize_t send (const iovec iov[], size_t n) const;
-  // Send a vector of n byte messages to the connected socket. 
-
-  ssize_t recv (iovec iov[], size_t n) const;
-  // Recv a vector of n byte messages to the connected socket. 
-
-  ssize_t send (const void *buf, size_t len, int flags,
+  ssize_t send (const void *buf,
+                size_t n,
+                int flags) const;
+  // Send an <n> byte buffer to the connected socket (uses
+  // <send(3n)>).
+
+  ssize_t recv (void *buf,
+                size_t n,
+                int flags) const;
+  // Recv an <n> byte buffer from the connected socket (uses
+  // <recv(3n)>).
+
+  ssize_t send (const void *buf,
+                size_t n) const;
+  // Send an <n> byte buffer to the connected socket (uses
+  // <write(2)>).
+
+  ssize_t recv (void *buf,
+                size_t n) const;
+  // Recv an <n> byte buffer from the connected socket (uses
+  // <read(2)>).
+
+  ssize_t send (const iovec iov[],
+                size_t n) const;
+  // Send a vector of an <n> byte messages to the connected socket.
+
+  ssize_t recv (iovec iov[],
+                size_t n) const;
+  // Recv a vector of an <n> byte messages to the connected socket.
+
+  ssize_t send (const void *buf,
+                size_t n, 
+                int flags,
 		const ACE_Time_Value *timeout);
-  // Wait to to <timeout> amount of time to send up to <len> bytes
-  // into <buf> from <handle> (uses the <send> call).  If <send> times
-  // out a -1 is returned with <errno == ETIME>.  If it succeeds the
+  // Wait to to <timeout> amount of time to send up to <n> bytes into
+  // <buf> from <handle> (uses the <send> call).  If <send> times out
+  // a -1 is returned with <errno == ETIME>.  If it succeeds the
   // number of bytes sent is returned.
 
-  ssize_t recv (void *buf, size_t len, int flags, 
+  ssize_t recv (void *buf,
+                size_t n,
+                int flags, 
 		const ACE_Time_Value *timeout);
-  // Wait up to <timeout> amount of time to receive up to <len> bytes
+  // Wait up to <timeout> amount of time to receive up to <n> bytes
   // into <buf> from <handle> (uses the <recv> call).  If <recv> times
   // out a -1 is returned with <errno == ETIME>.  If it succeeds the
   // number of bytes received is returned.
 
-  ssize_t send (size_t n, ...) const;
-  // Send varargs messages to the connected socket. 
+  ssize_t send (size_t n,
+                ...) const;
+  // Send <n> varargs messages to the connected socket.
 
-  ssize_t recv (size_t n, ...) const;
-  // Recv varargs messages to the connected socket. 
+  ssize_t recv (size_t n,
+                ...) const;
+  // Recv <n> varargs messages to the connected socket.
 
-  ssize_t send (const void *buf, size_t n, ACE_OVERLAPPED *overlapped) const;
+  ssize_t send (const void *buf,
+                size_t n,
+                ACE_OVERLAPPED *overlapped) const;
   // Send <n> bytes via Win32 WriteFile using overlapped I/O.
 
-  ssize_t recv (void *buf, size_t n, ACE_OVERLAPPED *overlapped) const;
+  ssize_t recv (void *buf,
+                size_t n,
+                ACE_OVERLAPPED *overlapped) const;
   // Recv <n> bytes via Win32 ReadFile using overlapped I/O.
 
   ssize_t recv (iovec *io_vec);