-

cool-RR · cool-RR · commit 1a79223ca161 · 2014-10-18T23:52:50.000+03:00
diff --git a/source_py3/python_toolbox/combi/perming/perm.py b/source_py3/python_toolbox/combi/perming/perm.py
@@ -35,7 +35,10 @@ class PermItems(sequence_tools.CuteSequenceMixin, _BasePermView,
     '''
     A viewer of a perm's items, similar to `dict.items()`.
     
-    This lets you access the perm (both index access and iteration) where 
+    This is useful for dapplied perms; it lets you view the perm (both index
+    access and iteration) as a sequence where each item is a 2-tuple, where the
+    first item is from the domain and the second item is its corresponding item
+    from the sequence.
     '''
     
     def __getitem__(self, i):
@@ -44,6 +47,14 @@ def __getitem__(self, i):
 
 class PermAsDictoid(sequence_tools.CuteSequenceMixin, _BasePermView,
                     collections.Mapping):
+    '''blocktododoc
+    A viewer of a perm's items, similar to `dict.items()`.
+    
+    This is useful for dapplied perms; it lets you view the perm (both index
+    access and iteration) as a sequence where each item is a 2-tuple, where the
+    first item is from the domain and the second item is its corresponding item
+    from the sequence.
+    '''    
     def __getitem__(self, key):
         return self.perm[key]
     def __iter__(self):
