-

cool-RR · cool-RR · commit 298942bbae49 · 2014-10-18T23:47:22.000+03:00
diff --git a/source_py3/python_toolbox/combi/perming/comb_space.py b/source_py3/python_toolbox/combi/perming/comb_space.py
@@ -7,9 +7,27 @@ class CombSpace(PermSpace):
     '''
     A space of combinations.
     
+    This is a subclass of `PermSpace`; see its documentation for more details.
     
+    Each item in a `CombSpace` is a `Comb`, i.e. a combination. This is similar
+    to `itertools.combinations`, except it offers far, far more functionality.
+    The combinations may be accessed by index number, the combinations can be
+    of a custom type, the space may be sliced, etc.
     
-    Every item in a `CombSpace` is a `Comb`.
+    Here is the simplest possible `CombSpace`:
+    
+        >>> comb_space = CombSpace(4, 2)
+        <CombSpace: 0..3, n_elements=2>
+        >>> comb_space[2]
+        <Comb, n_elements=2: (0, 3)>
+        >>> tuple(comb_space)
+        (<Comb, n_elements=2: (0, 1)>, <Comb, n_elements=2: (0, 2)>,
+         <Comb, n_elements=2: (0, 3)>, <Comb, n_elements=2: (1, 2)>,
+         <Comb, n_elements=2: (1, 3)>, <Comb, n_elements=2: (2, 3)>)
+
+    The members are `Comb` objects, which are sequence-like objects that have
+    extra functionality. (See documentation of `Comb` and `Perm` for more
+    info.)
     '''
     def __init__(self, iterable_or_length, n_elements, *, slice_=None,
                  perm_type=None, _domain_for_checking=None,
@@ -22,7 +40,8 @@ def __init__(self, iterable_or_length, n_elements, *, slice_=None,
         
         
     def __repr__(self):
-        sequence_repr = repr(self.sequence)
+        sequence_repr = self.sequence.short_repr if \
+                  hasattr(self.sequence, 'short_repr') else repr(self.sequence)
         if len(sequence_repr) > 40:
             sequence_repr = \
                       ''.join((sequence_repr[:35], ' ... ', sequence_repr[-1]))
diff --git a/source_py3/python_toolbox/combi/perming/perm_space.py b/source_py3/python_toolbox/combi/perming/perm_space.py
@@ -58,7 +58,6 @@ def __call__(cls, *args, **kwargs):
             return super().__call__(*args, **kwargs)
         
         
-@functools.total_ordering
 class PermSpace(_VariationRemovingMixin, _VariationAddingMixin,
                 _FixedMapManagingMixin, sequence_tools.CuteSequenceMixin,
                 collections.Sequence, metaclass=PermSpaceType):
