improving docs as suggested by vdukhovni.

Author: kazu-yamamoto

Network/Socket/Buffer.hsc

@@ -196,7 +196,7 @@ mkInvalidRecvArgError loc = ioeSetErrorString (mkIOError
                                     InvalidArgument
                                     loc Nothing Nothing) "non-positive length"
 
--- | Send data from the socket using sendmsg(2).
+-- | Send data to the socket using sendmsg(2).
 sendBufMsg :: SocketAddress sa
            => Socket            -- ^ Socket
            -> sa                -- ^ Destination address

Network/Socket/ByteString/IO.hsc

@@ -286,7 +286,7 @@ withWSABuffromBS cs f = do
 getBufsiz :: ByteString -> IO (Ptr Word8, Int)
 getBufsiz (PS fptr off len) = withForeignPtr fptr $ \ptr -> return (ptr `plusPtr` off, len)
 
--- | Send data from the socket using sendmsg(2).
+-- | Send data to the socket using sendmsg(2).
 sendMsg :: Socket       -- ^ Socket
         -> SockAddr     -- ^ Destination address
         -> [ByteString] -- ^ Data to be sent

Network/Socket/Options.hsc

@@ -290,8 +290,8 @@ instance Storable StructLinger where
         (#poke struct linger, l_linger) p linger
 #endif
 
--- | Executes the given action and ignoring the result only when the specified
--- socket option is valid.
+-- | Execute the given action only when the specified socket option is
+--  supported. Any return value is ignored.
 whenSupported :: SocketOption -> IO a -> IO ()
 whenSupported s action
   | isSupportedSocketOption s = action >> return ()

Network/Socket/Posix/Cmsg.hsc

@@ -83,7 +83,9 @@ filterCmsg cid cmsgs = filter (\cmsg -> cmsgId cmsg == cid) cmsgs
 
 ----------------------------------------------------------------
 
--- | A class to encode and decode control message.
+-- | Control message type class.
+--   Each control message type has a numeric 'CmsgId' and a 'Storable'
+--   data representation.
 class Storable a => ControlMessage a where
     controlMessageId :: a -> CmsgId
 

Network/Socket/SockAddr.hs

@@ -74,7 +74,7 @@ sendBufTo = G.sendBufTo
 recvBufFrom :: Socket -> Ptr a -> Int -> IO (Int, SockAddr)
 recvBufFrom = G.recvBufFrom
 
--- | Send data from the socket using sendmsg(2).
+-- | Send data to the socket using sendmsg(2).
 sendBufMsg :: Socket            -- ^ Socket
            -> SockAddr          -- ^ Destination address
            -> [(Ptr Word8,Int)] -- ^ Data to be sent