diff --git a/include/boost/asio/basic_datagram_socket.hpp b/include/boost/asio/basic_datagram_socket.hpp
index 618cc2ee..8560d34d 100644
--- a/include/boost/asio/basic_datagram_socket.hpp
+++ b/include/boost/asio/basic_datagram_socket.hpp
@@ -733,8 +733,8 @@ public:
    * completes. Copies will be made of the handler as required. The function
    * signature of the handler must be:
    * @code void handler(
-   *   const boost::system::system_error& error, // Result of operation.
-   *   std::size_t bytes_transferred             // Number of bytes received.
+   *   const boost::system::error_code& error, // Result of operation.
+   *   std::size_t bytes_transferred           // Number of bytes received.
    * ); @endcode
    * Regardless of whether the asynchronous operation completes immediately or
    * not, the handler will not be invoked from within this function. Invocation
diff --git a/include/boost/asio/ssl/stream.hpp b/include/boost/asio/ssl/stream.hpp
index 4acac39e..00d7529a 100644
--- a/include/boost/asio/ssl/stream.hpp
+++ b/include/boost/asio/ssl/stream.hpp
@@ -98,7 +98,7 @@ public:
     service_.destroy(impl_, next_layer_);
   }
 
-  /// [Deprecated: use get_io_service().] Get the io_service associated with
+  /// (Deprecated: use get_io_service().) Get the io_service associated with
   /// the object.
   /**
    * This function may be used to obtain the io_service object that the stream