Doc update.

git-svn-id: https://svn.dealii.org/trunk@2259 0785d39b-7218-0410-832d-ea1e28bc413d

diff --git a/deal.II/lac/include/lac/solver_control.h b/deal.II/lac/include/lac/solver_control.h
index 7ddecac70655d79f66d14ab9d33db97d0333ae9e..4e24bcd645e9d9bcf6a7670e99c58c887b701597 100644 (file)
--- a/deal.II/lac/include/lac/solver_control.h
+++ b/deal.II/lac/include/lac/solver_control.h
@@ -45,9 +45,11 @@ class SolverControl : public Subscriptor
   public:
 
                                     /**
-                                     * #Enum# denoting the different states
-                                     * a solver can be in. See the general
-                                     * documentation for more information.
+                                     * #Enum# denoting the different
+                                     * states a solver can be in. See
+                                     * the general documentation of
+                                     * this class for more
+                                     * information.
                                      */
     enum State {
       iterate = 0, success, failure
@@ -164,11 +166,17 @@ class SolverControl : public Subscriptor
 
 
 /**
- * Specialization  of #SolverControl# which returns #success# if either
- * the specified tolerance is achieved or if the
- * initial residual (or whatever criterion was chosen by the solver
- * class) is reduced by a given factor. This is useful in cases where
- * you don't want to solve exactly, but rather want to gain two digits.
+ * Specialization of #SolverControl# which returns #success# if either
+ * the specified tolerance is achieved or if the initial residual (or
+ * whatever criterion was chosen by the solver class) is reduced by a
+ * given factor. This is useful in cases where you don't want to solve
+ * exactly, but rather want to gain two digits or if the maximal
+ * number of iterations is achived.  For exemple: The maximal number
+ * of iterations is 20, the reduction factor is 1% und the tolerance
+ * is 0.1%. The initial residual is 2.5. The process will break if 20
+ * iteration are comleted or the new residual is less then 2.5*1% or
+ * if it is less then 0.1%.
+ 
  */
 class ReductionControl : public SolverControl
 {