Changeset 21244 for trunk/ppArith/src/ppArithArguments.c

Timestamp:

Feb 1, 2009, 11:43:05 AM (17 years ago)

Author:

eugene

Message:

merging Doxygen templates added by Bill G

File:

• trunk/ppArith/src/ppArithArguments.c (modified) (8 diffs)

trunk/ppArith/src/ppArithArguments.c

@@ +1 @@
+/** @file ppArithArguments.c
+ *
+ *  @brief
+ *
+ *  @ingroup ppArith
+ *
+ *  @author IfA
+ *  @version $Revision: 1.5 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-01 21:40:52 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 #ifdef HAVE_CONFIG_H
 #include <config.h>
@@ -10 +22 @@
 #include "ppArith.h"
 
-// Print usage information and die
-static void usage(const char *program,  // Name of the program
-                  psMetadata *arguments, // Command-line arguments
-                  pmConfig *config      // Configuration
+/**
+ * Print usage information and die
+ */
+static void usage(const char *program,  ///< Name of the program
+                  psMetadata *arguments, ///< Command-line arguments
+                  pmConfig *config      ///< Configuration
     )
 {
@@ -28 +42 @@
 }
 
-// Get a string value from the command-line and add it to the target
-static bool valueArgStr(psMetadata *arguments, // Command-line arguments
-                        const char *argName, // Argument name in the command-line arguments
-                        const char *mdName, // Name for value in the metadata
-                        psMetadata *target // Target metadata to which to add value
+/**
+ * Get a string value from the command-line and add it to the target
+ */
+static bool valueArgStr(psMetadata *arguments, ///< Command-line arguments
+                        const char *argName, ///< Argument name in the command-line arguments
+                        const char *mdName, ///< Name for value in the metadata
+                        psMetadata *target ///< Target metadata to which to add value
                         )
 {
-    psString value = psMetadataLookupStr(NULL, arguments, argName); // Value of interest
+    psString value = psMetadataLookupStr(NULL, arguments, argName); ///< Value of interest 
     if (value && strlen(value) > 0) {
         return psMetadataAddStr(target, PS_LIST_TAIL, mdName, 0, NULL, value);
@@ -42 +58 @@
 }
 
-// Add a single filename to the arguments as an array, so that it can be used with pmFPAfileBindFromArgs, etc
-static void fileList(const char *file, // The symbolic name for the file
-                     const char *name, // The name of the file
-                     const char *comment, // Description of the file
-                     pmConfig *config // Configuration
+/**
+ * Add a single filename to the arguments as an array, so that it can be used with pmFPAfileBindFromArgs, etc
+ */
+static void fileList(const char *file, ///< The symbolic name for the file
+                     const char *name, ///< The name of the file
+                     const char *comment, ///< Description of the file
+                     pmConfig *config ///< Configuration
     )
 {
-    psArray *files = psArrayAlloc(1); // Array with file names
+    psArray *files = psArrayAlloc(1); ///< Array with file names
     files->data[0] = psStringCopy(name);
     psMetadataAddArray(config->arguments, PS_LIST_TAIL, file, 0, comment, files);
@@ -60 +78 @@
     assert(config);
 
-    psMetadata *arguments = psMetadataAlloc(); // Command-line arguments
+    psMetadata *arguments = psMetadataAlloc(); ///< Command-line arguments
     psMetadataAddStr(arguments, PS_LIST_TAIL, "-file1", 0, "First image", NULL);
     psMetadataAddStr(arguments, PS_LIST_TAIL, "-op", 0, "Operation to perform", NULL);
@@ -73 +91 @@
     bool isMask = psMetadataLookupBool(NULL, arguments, "-mask"); // Are we dealing with masks?
     psMetadataAddBool(config->arguments, PS_LIST_TAIL, "MASK", 0, "Produce a mask image?", isMask);
-    const char *inFilerule = isMask ? "PPARITH.INPUT.MASK" : "PPARITH.INPUT.IMAGE"; // Input file rule
-    const char *outFilerule = isMask ? "PPARITH.OUTPUT.MASK" : "PPARITH.OUTPUT.IMAGE"; // Output file rule
+    const char *inFilerule = isMask ? "PPARITH.INPUT.MASK" : "PPARITH.INPUT.IMAGE"; ///< Input file rule
+    const char *outFilerule = isMask ? "PPARITH.OUTPUT.MASK" : "PPARITH.OUTPUT.IMAGE"; ///< Output file rule
     psMetadataAddStr(config->arguments, PS_LIST_TAIL, "FILERULE.INPUT", 0,
                      "File rule for input", inFilerule);
@@ -80 +98 @@
                      "File rule for output", outFilerule);
 
-    bool status = false;                // Status for file definition
+    bool status = false;                ///< Status for file definition 
 
     // First file
-    const char *name1 = psMetadataLookupStr(NULL, arguments, "-file1"); // Name of first image
+    const char *name1 = psMetadataLookupStr(NULL, arguments, "-file1"); ///< Name of first image
     if (!name1 || strlen(name1) == 0) {
         psError(PS_ERR_UNEXPECTED_NULL, true, "No input image specified.");
@@ -100 +118 @@
 
     // Second file is optional (won't be one for unary operations)
-    const char *name2 = psMetadataLookupStr(NULL, arguments, "-file2"); // Name of second image
+    const char *name2 = psMetadataLookupStr(NULL, arguments, "-file2"); ///< Name of second image
     if (name2 && strlen(name2) > 0) {
         fileList("INPUT2", name2, "Name of the second input image", config);