update doc

- add properties, parameters and commands to the doc string autoatically
- change names to "Frappy"
- started tutorial
- changed doc structure slightly

Change-Id: I87bef91384d138c738d12ddcf3a1de7f758a0973

secop/stringio.py

@@ -49,8 +49,10 @@ class StringIO(Communicator):
             Property('used encoding', datatype=StringType(),
                 default='ascii', settable=True),
         'identification':
-            Property('a list of tuples with commands and expected responses as regexp',
-                datatype=ArrayOf(TupleOf(StringType(),StringType())), default=[], export=False),
+            Property('identification\n\n'
+                     'a list of tuples with commands and expected responses as regexp, '
+                     'to be sent on connect',
+                datatype=ArrayOf(TupleOf(StringType(), StringType())), default=[], export=False),
     }
     parameters = {
         'timeout':
@@ -65,7 +67,7 @@ class StringIO(Communicator):
     commands = {
         'multicomm':
             Command('execute multiple commands in one go',
-                argument=ArrayOf(StringType()), result= ArrayOf(StringType()))
+                argument=ArrayOf(StringType()), result=ArrayOf(StringType()))
     }
 
     _reconnectCallbacks = None
@@ -221,7 +223,7 @@ class HasIodev(Module):
     """
     properties = {
         'iodev': Attached(),
-        'uri': Property('uri for auto creation of iodev', StringType(), default=''),
+        'uri': Property('uri for automatic creation of the attached communication module', StringType(), default=''),
     }
 
     iodevDict = {}