X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=Socket%2FTCPProtocol.hh;h=721a6d771403266704f198f014b316a04b938689;hb=e9230af25004d2e3eb041778afc493c5b300c43b;hp=adf029fea9e108f38646969b0fa4bed38375e6a1;hpb=c52cd7d87dbb525c1267aad27391b8b7365dbb57;p=senf.git

diff --git a/Socket/TCPProtocol.hh b/Socket/TCPProtocol.hh
index adf029f..721a6d7 100644
--- a/Socket/TCPProtocol.hh
+++ b/Socket/TCPProtocol.hh
@@ -20,6 +20,10 @@
 // Free Software Foundation, Inc.,
 // 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
+/** \file
+    \brief TCPProtocol public header
+ */
+
 #ifndef HH_TCPProtocol_
 #define HH_TCPProtocol_ 1
 
@@ -29,23 +33,43 @@
 //#include "TCPProtocol.mpp"
 ///////////////////////////////hh.p////////////////////////////////////////
 
-namespace satcom {
-namespace lib {
+namespace senf {
+
+    /// \addtogroup protocol_facets_group
+    /// @{
 
+    /** \brief Protocol facat to support TCP operations
+	
+	This protocol facet provides all those protocol functions,
+	which are available on any TCP socket.
+     */
     class TCPProtocol
         : public virtual SocketProtocol
     {
     public:
-        bool nodelay() const;
-        void nodelay(bool value) const;
+        bool nodelay() const;           ///< Check current \c SO_NODELAY status
+        void nodelay(bool value) const; ///< Set \c SO_NODELAY status
+                                        /**< Enabling \c SO_NODELAY will disable the NAGLE
+					     algorithm (which aggregates multiple writes into a
+					     single network packet). Enabling nodelay() optimizes
+					     the repsonse time at the expense of the bandwidth
+					     efficiency.
+					     \param[in] value \c SO_NODELAY state */
+
+        unsigned siocinq() const;       ///< Return current size of the input queue
+        unsigned siocoutq() const;      ///< Return current size of the output queue
+
+	///\name Abstract Interface Implementation
+	///@{
 
-        unsigned siocinq() const;
-        unsigned siocoutq() const;
         unsigned available() const;
         bool eof() const;
+
+	///@}
     };
 
-}}
+    /// @}
+}
 
 ///////////////////////////////hh.e////////////////////////////////////////
 //#include "TCPProtocol.cci"
@@ -56,5 +80,6 @@ namespace lib {
 
 // Local Variables:
 // mode: c++
-// c-file-style: "satcom"
+// c-file-style: "senf"
+// fill-column: 100
 // End: