X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=Socket%2FSocketProtocol.hh;h=ba2b5ed28371f8148bef57f7ef4b83ba23ddf4db;hb=33157146abaca548e145c577a0840cd1bd427789;hp=95e38e8810095d39d6f77d98d22e79925fc8e13b;hpb=5a5c6d7f0fae7ad6c0af49d7742955cb6cf618cf;p=senf.git

diff --git a/Socket/SocketProtocol.hh b/Socket/SocketProtocol.hh
index 95e38e8..ba2b5ed 100644
--- a/Socket/SocketProtocol.hh
+++ b/Socket/SocketProtocol.hh
@@ -21,6 +21,7 @@
 // 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 /** \file
+    \brief SocketProtocol and ConcreteSocketProtocol public header
     
     \idea We should optimize the protocol handling. Allocating a protocol instance for every socket
 	body seems quite wasteful. We could derive SocketPolicy from SocketBody (probably privately,
@@ -56,6 +57,9 @@
     \see 
 	\ref handle_group \n
 	\ref policy_group
+
+    \todo Complete the protocol interface implementations. Better distribution of members to
+	protocol facets and more precise distribution of functionality among the facets.
  */
 
 /** \defgroup concrete_protocol_group Protocol Implementations (Concrete Protocol Classes)
@@ -72,6 +76,15 @@
     of the protocol class to find the complete policy interface.
  */
 
+/** \defgroup protocol_facets_group Protocol Facets
+    \ingroup protocol_group
+
+    The protocol facets are classes used as building blocks to build concrete protocol classes. Each
+    protocol facet will implement some functional part of the protocol interface. The protocol
+    facets all inherit from SocketProtocol by public \e virtual inheritance. This ensures the
+    accessibility of the socket body from all facets.
+ */
+
 #ifndef HH_SocketProtocol_
 #define HH_SocketProtocol_ 1