Transform some comments into the javadoc format for experimentation

Transform some comments into the javadoc format for experimentation
with automatic documentation extraction.

darcs-hash:20030722180905-07bb3-aa4806a4f7d2f178358e6f606d7567e1bf4015e7.gz

2 files changed, 9 insertions, 5 deletions

diff --git a/Carpet/Carpet/src/CallFunction.cc b/Carpet/Carpet/src/CallFunction.cc
index 85b3957c3..8ab15102d 100644
--- a/Carpet/Carpet/src/CallFunction.cc
+++ b/Carpet/Carpet/src/CallFunction.cc
@@ -11,7 +11,7 @@
 #include "carpet.hh"
   
 extern "C" {
-  static const char* rcsid = "$Header: /home/eschnett/C/carpet/Carpet/Carpet/Carpet/src/CallFunction.cc,v 1.10 2003/06/18 18:28:07 schnetter Exp $";
+  static const char* rcsid = "$Header: /home/eschnett/C/carpet/Carpet/Carpet/Carpet/src/CallFunction.cc,v 1.11 2003/07/22 20:09:05 schnetter Exp $";
   CCTK_FILEVERSION(Carpet_Carpet_CallFunction_cc);
 }
 
@@ -21,11 +21,10 @@ namespace Carpet {
   
   using namespace std;
   
+  /** Traverse one function on all components of one refinement level
+      of one multigrid level.  */
   int CallFunction (void* function, cFunctionData* attribute, void* data)
   {
-    // Traverse one function on all components of one refinement level
-    // of one multigrid level
-    
 //     Checkpoint ("%*sStarting CallFunction...", 2*reflevel, "");
     
     cGH* cgh = (cGH*)data;
diff --git a/Carpet/Carpet/src/CarpetParamCheck.cc b/Carpet/Carpet/src/CarpetParamCheck.cc
index 906048c8b..ba3e4ebcd 100644
--- a/Carpet/Carpet/src/CarpetParamCheck.cc
+++ b/Carpet/Carpet/src/CarpetParamCheck.cc
@@ -8,7 +8,7 @@
 #include "carpet.hh"
 
 extern "C" {
-  static const char* rcsid = "$Header: /home/eschnett/C/carpet/Carpet/Carpet/Carpet/src/CarpetParamCheck.cc,v 1.6 2002/10/24 10:39:37 schnetter Exp $";
+  static const char* rcsid = "$Header: /home/eschnett/C/carpet/Carpet/Carpet/Carpet/src/CarpetParamCheck.cc,v 1.7 2003/07/22 20:09:05 schnetter Exp $";
   CCTK_FILEVERSION(Carpet_Carpet_CarpetParamCheck_cc);
 }
 
@@ -18,6 +18,11 @@ namespace Carpet {
   
   using namespace std;
   
+  /** Ensure that the parameters have legal values.
+   *
+   * Note that this checking happens only after most of Carpet has
+   * already been set up.
+   */
   int CarpetParamCheck (CCTK_ARGUMENTS)
   {
     DECLARE_CCTK_ARGUMENTS;