-

cool-RR · cool-RR · commit 3bba42a4666e · 2014-10-19T21:36:19.000+03:00
diff --git a/source_py3/python_toolbox/combi/perming/_fixed_map_managing_mixin.py b/source_py3/python_toolbox/combi/perming/_fixed_map_managing_mixin.py
@@ -9,10 +9,18 @@
 
 
 class _FixedMapManagingMixin:
+    '''
+    Mixin for `PermSpace` to manage the `fixed_map`. (For fixed perm spaces.)
+    '''
     
     @caching.CachedProperty
     def fixed_indices(self):
-        '''The indices of any fixed items in this `PermSpace`.'''
+        '''
+        The indices of any fixed items in this `PermSpace`.
+        
+        This'll be different from `self.fixed_map.keys()` for dapplied perm
+        spaces.
+        '''
         if not self.fixed_map:
             return ()
         return tuple(map(self.domain.index, self.fixed_map))
diff --git a/source_py3/python_toolbox/combi/perming/variations.py b/source_py3/python_toolbox/combi/perming/variations.py
@@ -32,7 +32,12 @@ class Variation(nifty_collections.CuteEnum):
         
 
 class UnallowedVariationSelectionException(exceptions.CuteException):
-    '''An unallowed selection of variations was attempted.'''
+    '''
+    An unallowed selection of variations was attempted.
+    
+    For example, you can't make dapplied combination spaces, and if you'll try,
+    you'll get an earful of this here exception.
+    '''
     def __init__(self, variation_clash):
         self.variation_clash = variation_clash
         assert variation_clash in variation_clashes
