Fix docstrings

Author: TheBlupper

src/sage/matrix/matrix_integer_dense.pyx

@@ -2743,7 +2743,8 @@ cdef class Matrix_integer_dense(Matrix_dense):
     def BKZ(self, delta=None, algorithm="fpLLL", fp=None, block_size=10, prune=0,
             use_givens=False, precision=0, proof=None, **kwds):
         """
-        Block Korkin-Zolotarev reduction.
+        Run Block Korkin-Zolotarev reduction on ``self`` interpreted
+        as a lattice, and return the result.
 
         INPUT:
 

src/sage/matrix/matrix_rational_dense.pyx

@@ -2929,7 +2929,8 @@ cdef class Matrix_rational_dense(Matrix_dense):
 
     def BKZ(self, *args, **kwargs):
         """
-        Block Korkin-Zolotarev reduction.
+        Return the result of running Block Korkin-Zolotarev reduction on
+        ``self`` interpreted as a lattice.
 
         For details on input parameters, see
         :meth:`sage.matrix.matrix_integer_dense.Matrix_integer_dense.BKZ`.
@@ -2970,7 +2971,8 @@ cdef class Matrix_rational_dense(Matrix_dense):
         For a definition of LLL reduction, see
         :meth:`sage.matrix.matrix_integer_dense.Matrix_integer_dense.LLL`.
 
-        EXAMPLES:
+        EXAMPLES::
+
             sage: A = random_matrix(QQ, 10, 10)
             sage: L = A.LLL()
             sage: A.is_LLL_reduced()