Suggestions by kwankyu

src/sage/matroids/basis_matroid.pyx

@@ -136,7 +136,7 @@ cdef class BasisMatroid(BasisExchangeMatroid):
     """
     def __init__(self, M=None, groundset=None, bases=None, nonbases=None, rank=None):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         EXAMPLES::
 
@@ -1086,9 +1086,9 @@ cdef class BasisMatroid(BasisExchangeMatroid):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should (and in
-            Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/circuit_closures_matroid.pyx

@@ -127,7 +127,7 @@ cdef class CircuitClosuresMatroid(Matroid):
 
     def __init__(self, M=None, groundset=None, circuit_closures=None):
         """
-        Initialization of the matroid. See class docstring for full
+        Initialization of the matroid. See the class docstring for full
         documentation.
 
         EXAMPLES::
@@ -427,9 +427,9 @@ cdef class CircuitClosuresMatroid(Matroid):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should
-            (and in Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/circuits_matroid.pyx

@@ -57,7 +57,7 @@ cdef class CircuitsMatroid(Matroid):
 
     def __init__(self, M=None, groundset=None, circuits=None, nsc_defined=False):
         """
-        Initialization of the matroid. See class docstring for full
+        Initialization of the matroid. See the class docstring for full
         documentation.
 
         TESTS::
@@ -320,9 +320,9 @@ cdef class CircuitsMatroid(Matroid):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should
-            (and in Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/dual_matroid.py

@@ -83,7 +83,7 @@ class DualMatroid(Matroid):
 
     def __init__(self, matroid):
         """
-        See class definition for documentation.
+        See the class definition for documentation.
 
         EXAMPLES::
 
@@ -400,9 +400,9 @@ def __hash__(self):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should (and in
-            Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/extension.pyx

@@ -301,7 +301,7 @@ cdef class LinearSubclasses:
     """
     def __init__(self, M, line_length=None, subsets=None, splice=None):
         """
-        See class docstring for full documentation.
+        See the class docstring for full documentation.
 
         EXAMPLES::
 
@@ -466,7 +466,7 @@ cdef class MatroidExtensions(LinearSubclasses):
     """
     def __init__(self, M, e, line_length=None, subsets=None, splice=None, orderly=False):
         """
-        See class docstring for full documentation.
+        See the class docstring for full documentation.
 
         EXAMPLES::
 

src/sage/matroids/flats_matroid.pyx

@@ -55,7 +55,7 @@ cdef class FlatsMatroid(Matroid):
 
     def __init__(self, M=None, groundset=None, flats=None):
         """
-        Initialization of the matroid. See class docstring for full
+        Initialization of the matroid. See the class docstring for full
         documentation.
 
         TESTS::
@@ -279,9 +279,9 @@ cdef class FlatsMatroid(Matroid):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should
-            (and in Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/gammoid.py

@@ -59,7 +59,7 @@ class Gammoid(Matroid):
 
     INPUT:
 
-    - ``D`` -- a loopless DiGraph representing the gammoid
+    - ``D`` -- a loopless digraph representing the gammoid
     - ``roots`` -- a subset of the vertices
     - ``groundset`` -- (optional) a subset of the vertices
 
@@ -89,7 +89,7 @@ class Gammoid(Matroid):
 
     def __init__(self, D, roots, groundset=None):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         EXAMPLES::
 
@@ -203,9 +203,9 @@ def __hash__(self):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should (and in
-            Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 
@@ -319,7 +319,7 @@ def __reduce__(self):
 
     def digraph(self):
         """
-        Return the DiGraph associated with the gammoid.
+        Return the digraph associated with the gammoid.
 
         EXAMPLES::
 

src/sage/matroids/graphic_matroid.pyx

@@ -152,7 +152,7 @@ cdef class GraphicMatroid(Matroid):
 
     def __init__(self, G, groundset=None):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         EXAMPLES::
 
@@ -342,9 +342,9 @@ cdef class GraphicMatroid(Matroid):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should (and in
-            Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/lean_matrix.pyx

@@ -673,7 +673,7 @@ cdef class GenericMatrix(LeanMatrix):
 
     def __init__(self, long nrows, long ncols, M=None, ring=None):
         """
-        See class docstring for full information.
+        See the class docstring for full information.
 
         EXAMPLES::
 
@@ -982,7 +982,7 @@ cdef class BinaryMatrix(LeanMatrix):
 
     def __init__(self, long m, long n, object M=None, object ring=None):
         """
-        See class docstring for full specification.
+        See the class docstring for full specification.
 
         EXAMPLES::
 
@@ -1605,7 +1605,7 @@ cdef class TernaryMatrix(LeanMatrix):
 
     def __init__(self, long m, long n, M=None, ring=None):
         """
-        See class docstring for full specification.
+        See the class docstring for full specification.
 
         EXAMPLES::
 
@@ -2157,7 +2157,7 @@ cdef class QuaternaryMatrix(LeanMatrix):
 
     def __init__(self, long m, long n, M=None, ring=None):
         """
-        See class docstring for full specification.
+        See the class docstring for full specification.
 
         EXAMPLES::
 
@@ -2775,7 +2775,7 @@ cdef class PlusMinusOneMatrix(LeanMatrix):
 
     def __init__(self, long nrows, long ncols, M=None, ring=None):
         """
-        See class docstring for full information.
+        See the class docstring for full information.
 
         EXAMPLES::
 
@@ -3209,7 +3209,7 @@ cdef class RationalMatrix(LeanMatrix):
 
     def __init__(self, long nrows, long ncols, M=None, ring=None):
         """
-        See class docstring for full information.
+        See the class docstring for full information.
 
         EXAMPLES::
 

src/sage/matroids/linear_matroid.pyx

@@ -259,7 +259,7 @@ cdef class LinearMatroid(BasisExchangeMatroid):
     """
     def __init__(self, matrix=None, groundset=None, reduced_matrix=None, ring=None, keep_initial_representation=True):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         EXAMPLES::
 
@@ -1285,9 +1285,9 @@ cdef class LinearMatroid(BasisExchangeMatroid):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should (and in
-            Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 
@@ -3078,7 +3078,7 @@ cdef class BinaryMatroid(LinearMatroid):
     """
     def __init__(self, matrix=None, groundset=None, reduced_matrix=None, ring=None, keep_initial_representation=True, basis=None):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         .. NOTE::
 
@@ -4111,7 +4111,7 @@ cdef class TernaryMatroid(LinearMatroid):
     """
     def __init__(self, matrix=None, groundset=None, reduced_matrix=None, ring=None, keep_initial_representation=True, basis=None):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         .. NOTE::
 
@@ -4989,7 +4989,7 @@ cdef class QuaternaryMatroid(LinearMatroid):
     """
     def __init__(self, matrix=None, groundset=None, reduced_matrix=None, ring=None, keep_initial_representation=True, basis=None):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         .. NOTE::
 
@@ -5694,7 +5694,7 @@ cdef class RegularMatroid(LinearMatroid):
     """
     def __init__(self, matrix=None, groundset=None, reduced_matrix=None, ring=None, keep_initial_representation=True):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         .. NOTE::
 

src/sage/matroids/matroid.pyx

@@ -3944,9 +3944,9 @@ cdef class Matroid(SageObject):
 
         .. WARNING::
 
-            This method is linked to ``__richcmp__`` (in Cython) and
-            ``__cmp__`` or ``__eq__``/``__ne__`` (in Python). If you override
-            one, you should (and in Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/minor_matroid.py

@@ -127,7 +127,7 @@ class wraps around any matroid to provide an abstract minor. It
 
     def __init__(self, matroid, contractions=None, deletions=None):
         """
-        See class docstring for documentation.
+        See the class docstring for documentation.
 
         EXAMPLES::
 
@@ -372,9 +372,9 @@ def __hash__(self):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should (and in
-            Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/rank_matroid.py

@@ -142,9 +142,9 @@ def __hash__(self):
 
         .. WARNING::
 
-            This method is linked to __richcmp__ (in Cython) and __cmp__ or
-            __eq__/__ne__ (in Python). If you override one, you should (and in
-            Cython: MUST) override the other!
+            This method is linked to ``__richcmp__`` (in Cython) and ``__cmp__``
+            or ``__eq__``/``__ne__`` (in Python). If you override one, you
+            should (and, in Cython, \emph{must}) override the other!
 
         EXAMPLES::
 

src/sage/matroids/transversal_matroid.pyx

@@ -3,7 +3,7 @@ Transversal matroids
 
 A transversal matroid arises from a groundset `E` and a collection `A` of sets
 over the groundset. This can be modeled as a bipartite graph `B`, where the
-vertices the left are groundset elements, the vertices on the right are the
+vertices on the left are groundset elements, the vertices on the right are the
 sets, and edges represent containment. Then a set `X` from the groundset is
 independent if and only if `X` has a matching in `B`.
 
@@ -100,7 +100,7 @@ cdef class TransversalMatroid(BasisExchangeMatroid):
 
     def __init__(self, sets, groundset=None, set_labels=None, matching=None):
         """
-        See class definition for full documentation.
+        See the class definition for full documentation.
 
         EXAMPLES::
 
@@ -850,8 +850,6 @@ cdef class TransversalMatroid(BasisExchangeMatroid):
         parameter. This checks that the matching provided is indeed a matching, fits in
         the set system, and is maximal.
 
-        OUTPUT: boolean
-
         EXAMPLES::
 
             sage: from sage.matroids.transversal_matroid import *