add comments

rdpy/protocols/common/layer.py

@@ -1,25 +1,28 @@
 '''
-Created on 5 sept. 2013
-
-@author: sylvain
+@author: citronneur
 '''
-
 class Layer(object):
     '''
-    classdocs
+    Network abstraction for protocol
+    Try as possible to divide user protocol in layer
+    default implementation is a transparent layer
     '''
     def __init__(self, presentation = None):
         '''
         Constructor
         '''
+        #presentation layer higher layer in model
         self._presentation = presentation
-        self._transport= None
+        #transport layer under layer in model
+        self._transport = None
+        #auto set transport layer of own presentation layer
         if not self._presentation is None:
             self._presentation._transport = self
     
     def connect(self):
         '''
-        signal that the transport layer is OK
+        call when transport layer is connected
+        default is send connect event to presentation layer
         '''
         if not self._presentation is None:
             self._presentation.connect()
@@ -27,12 +30,16 @@ class Layer(object):
     def read(self, data):
         '''
         signal that data is available for this layer
+        call by transport layer
+        default is to pass data to presentation layer
         '''
         if not self._presentation is None:
             self._presentation.read(data)
       
     def write(self, data):
         '''
-        write using transport layer
+        classical use by presentation layer
+        write data for this layer
+        default pass data to transport layer
         '''
         self.transport.write(data)

rdpy/protocols/common/protocolbuffer.py

@@ -1,6 +1,4 @@
 '''
-Created on 17 aout 2013
-
 @author: sylvain
 '''
 from twisted.internet import protocol