Document one more function.

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

diff --git a/deal.II/examples/step-15/step-15.cc b/deal.II/examples/step-15/step-15.cc
index ee84e31fcefb8550edaae839675423c60b62d76d..ad5167a691924bf0a375beee7d0e904d22e043a2 100644 (file)
--- a/deal.II/examples/step-15/step-15.cc
+++ b/deal.II/examples/step-15/step-15.cc
@@ -1057,7 +1057,21 @@ MinimizationProblem<dim>::energy (const DoFHandler<dim> &dof_handler,
 }
 
 
-
+                                 // So here is the driver function,
+                                 // ``run()''. It generate a coarse mesh,
+                                 // refines it a couple of times, and
+                                 // initializes the starting values. It then
+                                 // goes into a loop in which we first set up
+                                 // the member variables for the new mesh, and
+                                 // then do a fixed number of five gradient
+                                 // steps. If after this the energy has not
+                                 // significantly decreased compares to the
+                                 // last time we checked, we assume that we
+                                 // have converged and exit, otherwise we
+                                 // refine the mesh and start over. Once we
+                                 // have determined that the computations have
+                                 // converged somewhere, we output the
+                                 // results.
 template <int dim>
 void MinimizationProblem<dim>::run () 
 {