X-Git-Url: http://developer.intra2net.com/git/?p=libt2n;a=blobdiff_plain;f=src%2Fsocket_client.hxx;h=d680813b15cc04bdea2b393abeba6644e6cd2317;hp=a17ec88ad2119416ae8d795153c0159ab82cf447;hb=cc68aabb16ec32278df8b071c4c9efec7e9f0dce;hpb=07e98688a1a8c3e915ce923f79261a88251a9edd

diff --git a/src/socket_client.hxx b/src/socket_client.hxx
index a17ec88..d680813 100644
--- a/src/socket_client.hxx
+++ b/src/socket_client.hxx
@@ -24,10 +24,14 @@
 
 namespace libt2n
 {
+/** @brief a connection from client to server using sockets.
 
+    Use this class to connect from a client to a server.
+ */
 class socket_client_connection : public client_connection, public socket_handler
 {
-    static const int max_retries_default=3;
+    public:
+        static const int max_retries_default=3;
 
     private:
         void real_write(const std::string& data)
@@ -45,6 +49,13 @@ class socket_client_connection : public client_connection, public socket_handler
         socket_client_connection(const std::string& _server, int _port, int _max_retries=max_retries_default);
         socket_client_connection(const std::string& _path, int _max_retries=max_retries_default);
 
+        /** @brief read data from the socket and copy it into buffer
+            @param usec_timeout wait until new data is found, max timeout usecs.
+                    -1: wait endless
+                    NULL: no timeout
+            @retval true if new data was found (does not mean that the received data 
+                    is a complete packet though)
+        */
         bool fill_buffer(long long usec_timeout=-1)
             { return socket_handler::fill_buffer(buffer,usec_timeout); }