Fix documentation error where an asynchronous function was described as

having synchronous behaviour.

Author: chriskohlhoff

asio/include/asio/basic_datagram_socket.hpp

@@ -349,9 +349,8 @@ class basic_datagram_socket
 
   /// Start an asynchronous send on a connected socket.
   /**
-   * This function is used to send data on the datagram socket. The function
-   * call will block until the data has been sent successfully or an error
-   * occurs.
+   * This function is used to asynchronously send data on the datagram socket.
+   * The function call always returns immediately.
    *
    * @param buffers One or more data buffers to be sent on the socket. Although
    * the buffers object may be copied as necessary, ownership of the underlying

asio/src/doc/reference.qbk

@@ -3842,7 +3842,7 @@ Start an asynchronous send on a connected socket.
       WriteHandler handler);
 
 
-This function is used to send data on the datagram socket. The function call will block until the data has been sent successfully or an error occurs.
+This function is used to asynchronously send data on the datagram socket. The function call always returns immediately.
 
 
 [heading Parameters]
@@ -106159,4 +106159,4 @@ The initiating function (async\_read\_some in the above example) suspends the cu
 [endsect]
 
 
-[endsect]
+[endsect]