X-Git-Url: http://developer.intra2net.com/git/?p=libt2n;a=blobdiff_plain;f=src%2Fsocket_wrapper.hxx;h=067931ef8f1d40925b17eefd035ff5e95ffd1ed5;hp=ebb85f6a8ff6000e9ae99cc2e260fbca0f0dd16b;hb=9a5d7790b094439b9a6f16983e20493c0e43ee02;hpb=393e7b700efffc748e593661b365ead414a341c1

diff --git a/src/socket_wrapper.hxx b/src/socket_wrapper.hxx
index ebb85f6..067931e 100644
--- a/src/socket_wrapper.hxx
+++ b/src/socket_wrapper.hxx
@@ -32,6 +32,12 @@
 namespace libt2n
 {
 
+/** @brief a basic implementation of ConnectionWrapper
+
+    This is a basic version of a ConnectionWrapper which does not do any fancy
+    error handling or anything, it justs executes the regular calls. Use this
+    wrapper if you only want to use the singleton-feature of T2nSingletonWrapper.
+*/
 class BasicSocketWrapper : public ConnectionWrapper
 {
     protected:
@@ -69,6 +75,11 @@ class BasicSocketWrapper : public ConnectionWrapper
         void set_logging(std::ostream *_logstream, log_level_values _log_level);
 };
 
+/** @brief a wrapper implementing reconnect-then-throw
+
+    This ConnectionWrapper tries to reconnect to the server if something with the connection
+    goes wrong. If even reconnecting max_retries times does not help, an exception is thrown.
+*/
 class ReconnectSocketWrapper : public BasicSocketWrapper
 {
     public:
@@ -87,6 +98,7 @@ class ReconnectSocketWrapper : public BasicSocketWrapper
         bool handle(command_client* stubBase, boost::function< void() > f);
 };
 
+/// a placeholder-client_connection which is closed all the time
 class dummy_client_connection : public client_connection
 {
     private:
@@ -102,6 +114,12 @@ class dummy_client_connection : public client_connection
             { return false; }
 };
 
+/** @brief a wrapper implementing reconnect-then-ignore
+
+    This ConnectionWrapper tries to reconnect to the server if something with the connection
+    goes wrong. If even reconnecting max_retries times does not help, the complete t2n-call is
+    ignored. The return value of the call will be created with the default constructor.
+*/
 class ReconnectIgnoreFailureSocketWrapper : public ReconnectSocketWrapper
 {
     private: