From: wolf <wolf@0785d39b-7218-0410-832d-ea1e28bc413d>
Date: Fri, 16 Apr 2004 16:11:50 +0000 (+0000)
Subject: Document one more function.
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b070a2b3166f9368f48214145a9ee13f1e01be6c;p=dealii-svn.git

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 ee84e31fce..ad5167a691 100644
--- 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 () 
 {