Some documentation clean-up

src/sage/libs/eclib/interface.py

@@ -267,21 +267,12 @@ def two_descent(self, verbose=True, selmer_only=False, first_limit=20,
 
         - ``selmer_only`` -- boolean (default: ``False``); ``selmer_only`` switch
 
-        - ``first_limit`` -- integer (default: 20); bound on `|x|+|z|` in
-          quartic point search
+        - ``first_limit``, ``second_limit``, ``n_aux``, ``second_descent`` --
+          see ``firstlim``, ``secondlim``, ``n_aux`` and ``second_descent``
+          respectively in :meth:`~sage.libs.eclib.mwrank._two_descent.do_descent`
 
-        - ``second_limit`` -- integer (default: 8); bound on
-          `\log \max(|x|,|z|)`, i.e. logarithmic
-
-        - ``n_aux`` -- integer (default: -1); (only relevant for general
-          2-descent when 2-torsion trivial) number of primes used for
-          quartic search.  ``n_aux=-1`` causes default (8) to be used.
-          Increase for curves of higher rank.
-
-        - ``second_descent`` -- boolean (default: ``True``); (only relevant
-          for curves with 2-torsion, where mwrank uses descent via
-          2-isogeny) flag determining whether or not to do second
-          descent.  *Default strongly recommended.*
+        .. SEEALSO::
+            :meth:`sage.libs.eclib.mwrank._two_descent.do_descent`
 
         OUTPUT: nothing
 

src/sage/modules/free_module_element.pyx

@@ -4047,7 +4047,7 @@ cdef class FreeModuleElement(Vector):   # abstract base class
         Differentiate with respect to var by differentiating each element
         with respect to var.
 
-        .. seealso:
+        .. SEEALSO::
 
            :meth:`derivative`
 

src/sage/schemes/elliptic_curves/ell_rational_field.py

@@ -808,16 +808,9 @@ def two_descent(self, verbose=True,
 
         - ``selmer_only`` -- boolean (default: ``False``); selmer_only switch
 
-        - ``first_limit`` -- (default: 20) firstlim is bound
-          on x+z second_limit- (default: 8) secondlim is bound on log max
-          x,z , i.e. logarithmic
-
-        - ``n_aux`` -- (default: -1) n_aux only relevant for
-          general 2-descent when 2-torsion trivial; n_aux=-1 causes default
-          to be used (depends on method)
-
-        - ``second_descent`` -- (default: ``True``)
-          second_descent only relevant for descent via 2-isogeny
+        - ``first_limit``, ``second_limit``, ``n_aux``, ``second_descent`` --
+          see ``firstlim``, ``secondlim``, ``n_aux`` and ``second_descent``
+          respectively in :meth:`~sage.libs.eclib.mwrank._two_descent.do_descent`
 
         OUTPUT:
 
@@ -2256,9 +2249,9 @@ def gens(self, proof=None, **kwds):
 
         - ``algorithm`` -- one of the following:
 
-          - ``'mwrank_shell'`` -- default; call mwrank shell command
+          - ``'mwrank_lib'`` -- default; call mwrank C library
 
-          - ``'mwrank_lib'`` -- call mwrank C library
+          - ``'mwrank_shell'`` -- call mwrank shell command
 
           - ``'pari'`` -- use ellrank in pari
 
@@ -2268,7 +2261,8 @@ def gens(self, proof=None, **kwds):
         - ``use_database`` -- boolean (default: ``True``); if ``True``, attempts to
           find curve and gens in the (optional) database
 
-        - ``descent_second_limit`` -- (default: 12) used in 2-descent
+        - ``descent_second_limit`` -- (default: 12) used in 2-descent.
+          See ``secondlim`` in :meth:`~sage.libs.eclib.mwrank._two_descent.do_descent`
 
         - ``sat_bound`` -- (default: 1000) bound on primes used in
           saturation.  If the computed bound on the index of the