BIND 10 trac1542, updated. b4cc4325aaef9d57ecfe39e7cda0cac83773980b [1542] Documentation update

[BIND 10 source code commits]

The branch, trac1542 has been updated
       via  b4cc4325aaef9d57ecfe39e7cda0cac83773980b (commit)
      from  28cd9c1145fd52f2729f1f9f4d28c263ca2cc0d4 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit b4cc4325aaef9d57ecfe39e7cda0cac83773980b
Author: Michal 'vorner' Vaner <michal.vaner at nic.cz>
Date:   Thu Jan 26 16:47:42 2012 +0100

    [1542] Documentation update

-----------------------------------------------------------------------

Summary of changes:
 src/lib/server_common/socket_request.h |   12 +++++++-----
 1 files changed, 7 insertions(+), 5 deletions(-)

-----------------------------------------------------------------------
diff --git a/src/lib/server_common/socket_request.h b/src/lib/server_common/socket_request.h
index ea22fa6..7f513b8 100644
--- a/src/lib/server_common/socket_request.h
+++ b/src/lib/server_common/socket_request.h
@@ -169,11 +169,13 @@ public:
     /// \throw InvalidParameter protocol or share_mode is invalid
     /// \throw CCSessionError when we have a problem talking over the CC
     ///     session.
-    /// \throw SocketError in case the other side doesn't want to give us
-    ///     the socket for some reason (common cases are when the socket
-    ///     can't be allocated or bound, or when the socket is claimed by
-    ///     some other application and the sharing parameters don't allow
-    ///     sharing it).
+    /// \throw SocketError in case we have some other problems receiving the
+    ///     socket (eg. inconsistency in the protocol, the socket got stuck
+    ///     in the transport, etc). If the exception is not of the following
+    ///     derived ones, it usualy means something serious happened.
+    /// \throw SocketAllocateError if the other side can't create the socket.
+    /// \throw ShareError if the socket is used by other bind10 module and
+    ///     that one doesn't want to share it with us.
     virtual SocketID requestSocket(Protocol protocol,
                                    const std::string& address,
                                    uint16_t port, ShareMode share_mode,