X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=Socket%2FBufferingPolicy.hh;h=1c63523f4a3df97e603f9961a6b15b02b965757b;hb=cf4ebe486e7e0543ac8568d3043f43d95f197a96;hp=9dccd88ac8a3f57d74507b0fa83d3296fd24468a;hpb=c52cd7d87dbb525c1267aad27391b8b7365dbb57;p=senf.git

diff --git a/Socket/BufferingPolicy.hh b/Socket/BufferingPolicy.hh
index 9dccd88..1c63523 100644
--- a/Socket/BufferingPolicy.hh
+++ b/Socket/BufferingPolicy.hh
@@ -20,6 +20,10 @@
 // Free Software Foundation, Inc.,
 // 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
+/** \file
+    \brief BufferingPolicy public header
+ */
+
 #ifndef HH_BufferingPolicy_
 #define HH_BufferingPolicy_ 1
 
@@ -30,20 +34,41 @@
 //#include "BufferingPolicy.mpp"
 ///////////////////////////////hh.p////////////////////////////////////////
 
-namespace satcom {
-namespace lib {
+namespace senf {
+
+    /// \addtogroup policy_impl_group
+    /// @{
+
+    /** \brief BufferingPolicy implementing standard socket buffering
 
-    // TODO: Should this be dependent on Read / WritePolicy ?
+	This policy class implements standard BSD socket buffering.
+
+	\todo Shouldn't this be dependent on Read / WritePolicy ?
+     */
     struct SocketBufferingPolicy : public BufferingPolicyBase
     {
         static unsigned rcvbuf(FileHandle handle);
+                                        ///< Check receive buffer size
+                                        /**< \param[in] handle socket handle to check 
+					     \returns size of receive buffer in bytes */
         static void rcvbuf(FileHandle handle, unsigned size);
+                                        ///< Change receive buffer size
+                                        /**< \param[in] handle socket handle
+					     \param[in] size new receive buffer size */
 
         static unsigned sndbuf(FileHandle handle);
+                                        ///< Check send buffer size
+                                        /**< \param[in] handle socket handle to check
+					     \returns size of send buffer in bytes */
         static void sndbuf(FileHandle handle, unsigned size);
+                                        ///< Change size of send buffer
+                                        /**< \param[in] handle socket handle
+					     \param[in] size new send buffer size */
     };
 
-}}
+    /// @}
+
+}
 
 ///////////////////////////////hh.e////////////////////////////////////////
 //#include "BufferingPolicy.cci"
@@ -55,5 +80,6 @@ namespace lib {
 
 // Local Variables:
 // mode: c++
-// c-file-style: "satcom"
+// c-file-style: "senf"
+// fill-column: 100
 // End: