Index: trunk/psastro/src/gpcModel.c
===================================================================
--- trunk/psastro/src/gpcModel.c	(revision 21390)
+++ trunk/psastro/src/gpcModel.c	(revision 21409)
@@ -1,8 +1,21 @@
+/** @file gpcModel.c
+ *
+ *  @brief
+ *
+ *  @ingroup gpcModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.2 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
+/**
+ * generate model for gpc based on input model for all but chips
+ * USAGE: gpcModel (input) (output)
+ */
 int main (int argc, char **argv) {
-
-    // USAGE: gpcModel (input) (output)
-    // generate model for gpc based on input model for all but chips
 
     if (argc != 3) {
Index: trunk/psastro/src/psastro.c
===================================================================
--- trunk/psastro/src/psastro.c	(revision 21390)
+++ trunk/psastro/src/psastro.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastro.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.28 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
Index: trunk/psastro/src/psastro.h
===================================================================
--- trunk/psastro/src/psastro.h	(revision 21390)
+++ trunk/psastro/src/psastro.h	(revision 21409)
@@ -1,4 +1,16 @@
-/* This file defines the library functions available to external programs.  It must be included
- * by programs which are compiled against psphot functions.
+/** @file psastro.h
+ *
+ *  @brief This file defines the library functions available to external 
+ *  programs.  
+ *
+ *  It must be included by programs which are compiled against 
+ *  psphot functions.
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.48 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
  */
 
@@ -7,5 +19,9 @@
 
 # include "psastroErrorCodes.h"
-# define PSASTRO_RECIPE "PSASTRO" // Name of the recipe to use
+
+/// @addtogroup psastro
+/// @{
+
+# define PSASTRO_RECIPE "PSASTRO" ///< Name of the recipe to use
 
 # define psMemCopy(A)(psMemIncrRefCounter((A)))
@@ -14,14 +30,16 @@
 # define SIGN(X)  (((X) == 0) ? 0 : ((fabs((double)(X))) / (X)))
 
-// this structure represents a fit to the logN / logS curve for a set of stars
-// logN = offset + slope * logS
+/**
+ * this structure represents a fit to the logN / logS curve for a set of stars
+ * logN = offset + slope * logS
+ */
 typedef struct {
-    double mMin;                        // minimum magnitude bin with data
-    double mMax;                        // maximum magnitude bin with data
-    double offset;                      // fitted line offset
-    double slope;                       // fitted line slope
-    double mPeak;                       // mag of peak bin
-    int nPeak;                          // # of stars in peak bin
-    int sPeak;                          // sum of stars to peak bin
+    double mMin;                        ///< minimum magnitude bin with data
+    double mMax;                        ///< maximum magnitude bin with data
+    double offset;                      ///< fitted line offset
+    double slope;                       ///< fitted line slope
+    double mPeak;                       ///< mag of peak bin
+    int nPeak;                          ///< # of stars in peak bin
+    int sPeak;                          ///< sum of stars to peak bin
 } pmLumFunc;
 
@@ -123,3 +141,4 @@
 bool psastroZeroPointFromRecipe (float *zeropt, float *exptime, pmFPA *fpa, psMetadata *recipe);
 
+///@}
 # endif /* PSASTRO_H */
Index: trunk/psastro/src/psastroAnalysis.c
===================================================================
--- trunk/psastro/src/psastroAnalysis.c	(revision 21390)
+++ trunk/psastro/src/psastroAnalysis.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroAnalysis.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.15 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroArguments.c
===================================================================
--- trunk/psastro/src/psastroArguments.c	(revision 21390)
+++ trunk/psastro/src/psastroArguments.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroArguments.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.33 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
Index: trunk/psastro/src/psastroAstromGuess.c
===================================================================
--- trunk/psastro/src/psastroAstromGuess.c	(revision 21390)
+++ trunk/psastro/src/psastroAstromGuess.c	(revision 21409)
@@ -1,11 +1,24 @@
+/** @file psastroAstromGuess.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.34 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 # define DEBUG 0
 
-// this function loads the header WCS astrometry terms into the fpa terms and applies the
-// astrometry to the detected objects.
-
-// this function assumes the initial astrometry arrives in the form of WCS keywords in the
-// headers corresponding to the chips.
-
+/**
+ * \brief This function loads the header WCS astrometry terms into the fpa 
+ * terms and applies the astrometry to the detected objects.
+ * 
+ * This function assumes the initial astrometry arrives in the form of WCS 
+ * keywords in the headers corresponding to the chips.
+ */
 bool psastroAstromGuess (int *nStars, pmConfig *config) {
 
Index: trunk/psastro/src/psastroChipAstrom.c
===================================================================
--- trunk/psastro/src/psastroChipAstrom.c	(revision 21390)
+++ trunk/psastro/src/psastroChipAstrom.c	(revision 21409)
@@ -1,4 +1,16 @@
+/** @file psastroChipAstrom.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.29 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
-# define NONLIN_TOL 0.001 /* tolerance in pixels */
+# define NONLIN_TOL 0.001 ///< tolerance in pixels
 
 bool psastroChipAstrom (pmConfig *config) {
Index: trunk/psastro/src/psastroChooseRefstars.c
===================================================================
--- trunk/psastro/src/psastroChooseRefstars.c	(revision 21390)
+++ trunk/psastro/src/psastroChooseRefstars.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroChooseRefstars.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.21 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroCleanup.c
===================================================================
--- trunk/psastro/src/psastroCleanup.c	(revision 21390)
+++ trunk/psastro/src/psastroCleanup.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroCleanup.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.7 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
Index: trunk/psastro/src/psastroConvert.c
===================================================================
--- trunk/psastro/src/psastroConvert.c	(revision 21390)
+++ trunk/psastro/src/psastroConvert.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroConvert.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.25 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 // leak free 2006.04.27
@@ -157,5 +169,7 @@
 }
 
-// sort by Mag (ascending)
+/**
+ * sort by Mag (ascending)
+ */
 int psastroSortByMag (const void *a, const void *b)
 {
Index: trunk/psastro/src/psastroDataLoad.c
===================================================================
--- trunk/psastro/src/psastroDataLoad.c	(revision 21390)
+++ trunk/psastro/src/psastroDataLoad.c	(revision 21409)
@@ -1,7 +1,15 @@
+/** @file psastroDataLoad.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.12 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
-// this loop loads the data from the input files and selects the
-// brighter stars for astrometry
-// at the end of this function, the complete stellar data is loaded
-// into the correct fpa structure locations (readout.analysis:PSPHOT.SOURCES)
 
 # define ESCAPE { \
@@ -11,5 +19,12 @@
 }
   
-// all of the different astrometry analysis modes use the same data load loop
+/**
+ * \brief this loop loads the data from the input files and selects the
+ * brighter stars for astrometry
+ *
+ * at the end of this function, the complete stellar data is loaded
+ * into the correct fpa structure locations (readout.analysis:PSPHOT.SOURCES)
+ * all of the different astrometry analysis modes use the same data load loop
+ */
 bool psastroDataLoad (pmConfig *config) {
 
Index: trunk/psastro/src/psastroDataSave.c
===================================================================
--- trunk/psastro/src/psastroDataSave.c	(revision 21390)
+++ trunk/psastro/src/psastroDataSave.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroDataSave.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.15 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
@@ -7,5 +19,7 @@
 }
   
-// this loop saves the photometry/astrometry data files
+/**
+ * this loop saves the photometry/astrometry data files
+ */
 bool psastroDataSave (pmConfig *config) {
 
Index: trunk/psastro/src/psastroDefineFiles.c
===================================================================
--- trunk/psastro/src/psastroDefineFiles.c	(revision 21390)
+++ trunk/psastro/src/psastroDefineFiles.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroDefineFiles.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.10 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroDemoDump.c
===================================================================
--- trunk/psastro/src/psastroDemoDump.c	(revision 21390)
+++ trunk/psastro/src/psastroDemoDump.c	(revision 21409)
@@ -1,5 +1,20 @@
+/** @file psastroMosaicDemoDump.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.11 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
-// this function is used for test purposes (-trace psastro.dump.psastroAstromGuess 1)
+/**
+ * this function is used for test purposes 
+ * (-trace psastro.dump.psastroAstromGuess 1)
+ */
 bool psastroDumpStars (psArray *stars, char *filename) {
 
@@ -20,5 +35,7 @@
 }
 
-// this function is used for test purposes (-trace psastro.dump.psastroAstromGuess 1)
+/** this function is used for test purposes 
+ * (-trace psastro.dump.psastroAstromGuess 1)
+ */
 bool psastroDumpRawstars (psArray *rawstars, pmFPA *fpa, pmChip *chip) {
 
@@ -97,5 +114,8 @@
 }
 
-// this function is used for test purposes (-trace psastro.dump.psastroLoadRefstars 1)
+/**
+ * this function is used for test purposes 
+ * (-trace psastro.dump.psastroLoadRefstars 1)
+ */
 bool psastroDumpRefstars (psArray *refstars, char *filename) {
 
@@ -176,5 +196,7 @@
 }
 
-// this function is used for test purposes (-trace psastro.dump 1)
+/**
+ * this function is used for test purposes (-trace psastro.dump 1)
+ */
 bool psastroDumpGradients (psArray *gradients, char *filename) {
 
Index: trunk/psastro/src/psastroDemoPlot.c
===================================================================
--- trunk/psastro/src/psastroDemoPlot.c	(revision 21390)
+++ trunk/psastro/src/psastroDemoPlot.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicDemoPlot.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.12 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroErrorCodes.c.in
===================================================================
--- trunk/psastro/src/psastroErrorCodes.c.in	(revision 21390)
+++ trunk/psastro/src/psastroErrorCodes.c.in	(revision 21409)
@@ -1,2 +1,17 @@
+/** @file psastroErrorCodes.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
+#include "pslib.h"
+#include "psastroErrorCodes.h"
+
 /*
  * The line
@@ -5,7 +20,4 @@
  * will be replaced by values from errorCodes.dat
  */
-#include "pslib.h"
-#include "psastroErrorCodes.h"
-
 void psastroErrorRegister(void)
 {
Index: trunk/psastro/src/psastroErrorCodes.h.in
===================================================================
--- trunk/psastro/src/psastroErrorCodes.h.in	(revision 21390)
+++ trunk/psastro/src/psastroErrorCodes.h.in	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroErrorCodes.h
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 #if !defined(PSASTRO_ERROR_CODES_H)
 #define PSASTRO_ERROR_CODES_H
Index: trunk/psastro/src/psastroFixChips.c
===================================================================
--- trunk/psastro/src/psastroFixChips.c	(revision 21390)
+++ trunk/psastro/src/psastroFixChips.c	(revision 21409)
@@ -1,4 +1,16 @@
+/** @file psastroFixChips.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.8 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
-# define NONLIN_TOL 0.001 /* tolerance in pixels */
+# define NONLIN_TOL 0.001 ///< tolerance in pixels
 # define DEBUG 0
 
Index: trunk/psastro/src/psastroFixChipsTest.c
===================================================================
--- trunk/psastro/src/psastroFixChipsTest.c	(revision 21390)
+++ trunk/psastro/src/psastroFixChipsTest.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroFixChipsTest.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 # define NONLIN_TOL 0.001 /* tolerance in pixels */
Index: trunk/psastro/src/psastroInternal.h
===================================================================
--- trunk/psastro/src/psastroInternal.h	(revision 21390)
+++ trunk/psastro/src/psastroInternal.h	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroInternal.h
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # ifdef HAVE_CONFIG_H
 # include <config.h>
Index: trunk/psastro/src/psastroLoadRefstars.c
===================================================================
--- trunk/psastro/src/psastroLoadRefstars.c	(revision 21390)
+++ trunk/psastro/src/psastroLoadRefstars.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroLoadRefstars.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.35 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 # define ELIXIR_MODE 1
Index: trunk/psastro/src/psastroLuminosityFunction.c
===================================================================
--- trunk/psastro/src/psastroLuminosityFunction.c	(revision 21390)
+++ trunk/psastro/src/psastroLuminosityFunction.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroLuminosityFunction.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.18 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 # define dMag 0.1
Index: trunk/psastro/src/psastroMaskUpdates.c
===================================================================
--- trunk/psastro/src/psastroMaskUpdates.c	(revision 21390)
+++ trunk/psastro/src/psastroMaskUpdates.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMaskUpdates.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.7 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
@@ -17,6 +29,7 @@
 void psastroMaskRectangle (psImage *mask, psImageMaskType value, int x0, int y0, int x1, int y1);
 
-// create a mask or mask regions based on the collection of reference stars that are
-// in the vicinity of each chip
+/**
+ * create a mask or mask regions based on the collection of reference stars that * are in the vicinity of each chip
+ */
 bool psastroMaskUpdates (pmConfig *config) {
 
@@ -327,5 +340,7 @@
 }
 
-// convert chip coords to cell coords, given known cell
+/**
+ * convert chip coords to cell coords, given known cell
+ */
 bool pmCellCoordsForChip (float *xCell, float *yCell, pmCell *cell, float xChip, float yChip) {
 
@@ -351,5 +366,7 @@
 }
 
-// convert chip coords to cell coords, given known cell
+/**
+ * convert chip coords to cell coords, given known cell
+ */
 bool pmChipCoordsForCell (float *xChip, float *yChip, pmCell *cell, float xCell, float yCell) {
 
@@ -412,5 +429,7 @@
 }
 
-// identify the quadrant and draw the correct line
+/**
+ * identify the quadrant and draw the correct line
+ */
 void psastroMaskLine (psImage *mask, psImageMaskType value, double x1, double y1, double x2, double y2, int dW) {
 
@@ -440,6 +459,8 @@
 }
 
-// use the Bresenham line drawing technique
-// integer-only Bresenham line-draw version which is fast
+/**
+ * use the Bresenham line drawing technique
+ * integer-only Bresenham line-draw version which is fast
+ */
 void psastroMaskLineBresen (psImage *mask, psImageMaskType value, int X1, int Y1, int X2, int Y2, int dW, int swapcoords) {
 
Index: trunk/psastro/src/psastroMetadataStats.c
===================================================================
--- trunk/psastro/src/psastroMetadataStats.c	(revision 21390)
+++ trunk/psastro/src/psastroMetadataStats.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMetaDataStats.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroModel.c
===================================================================
--- trunk/psastro/src/psastroModel.c	(revision 21390)
+++ trunk/psastro/src/psastroModel.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroModel.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
Index: trunk/psastro/src/psastroModelAdjust.c
===================================================================
--- trunk/psastro/src/psastroModelAdjust.c	(revision 21390)
+++ trunk/psastro/src/psastroModelAdjust.c	(revision 21409)
@@ -1,4 +1,16 @@
+/** @file psastroModelAdjust.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
-# define NONLIN_TOL 0.001 /* tolerance in pixels */
+# define NONLIN_TOL 0.001 ///< tolerance in pixels 
 # define DEBUG 0
 
Index: trunk/psastro/src/psastroModelAnalysis.c
===================================================================
--- trunk/psastro/src/psastroModelAnalysis.c	(revision 21390)
+++ trunk/psastro/src/psastroModelAnalysis.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroModelAnalysis.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.7 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 # define NONLIN_TOL 0.001
Index: trunk/psastro/src/psastroModelArguments.c
===================================================================
--- trunk/psastro/src/psastroModelArguments.c	(revision 21390)
+++ trunk/psastro/src/psastroModelArguments.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroModelArguments.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
Index: trunk/psastro/src/psastroModelBoresite.c
===================================================================
--- trunk/psastro/src/psastroModelBoresite.c	(revision 21390)
+++ trunk/psastro/src/psastroModelBoresite.c	(revision 21409)
@@ -1,9 +1,23 @@
+/** @file psastroModelBoresite.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.4 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
-// the full chisq is built of two associated sums over coordinates:
-// chisq = sum ((X_obs - X_fit(t))^2 + (Y_obs - Y_fit(t))^2)
-// we use split this into a 2x long vector and use coord[1] to distinguish the X and Y terms:
-// coord[0] = measured X or measured Y
-// coord[1] =          0 or          1
+/**
+ * the full chisq is built of two associated sums over coordinates:
+ * chisq = sum ((X_obs - X_fit(t))^2 + (Y_obs - Y_fit(t))^2)
+ * we use split this into a 2x long vector and use coord[1] to distinguish the X and Y terms:
+ * coord[0] = measured X or measured Y
+ * coord[1] =          0 or          1
+ */
 psF32 psastroModelBoresite (psVector *deriv, const psVector *params, const psVector *coord) {
 
Index: trunk/psastro/src/psastroModelDataLoad.c
===================================================================
--- trunk/psastro/src/psastroModelDataLoad.c	(revision 21390)
+++ trunk/psastro/src/psastroModelDataLoad.c	(revision 21409)
@@ -1,6 +1,15 @@
+/** @file psastroModelDataLoad.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
-
-// this loop loads the header data from the input files, using the output pmFPAfile to guide
-// the chip selection and related issues
 
 # define ESCAPE { \
@@ -10,5 +19,9 @@
 }
   
-// all of the different astrometry analysis modes use the same data load loop
+/**
+ * this loop loads the header data from the input files, using the output 
+ * pmFPAfile to guide the chip selection and related issues
+ * all of the different astrometry analysis modes use the same data load loop
+ */
 bool psastroModelDataLoad (pmConfig *config) {
 
Index: trunk/psastro/src/psastroModelDataSave.c
===================================================================
--- trunk/psastro/src/psastroModelDataSave.c	(revision 21390)
+++ trunk/psastro/src/psastroModelDataSave.c	(revision 21409)
@@ -1,4 +1,16 @@
+/** @file psastroModelDataSave.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
-# define NONLIN_TOL 0.001 /* tolerance in pixels */
+# define NONLIN_TOL 0.001 ///< tolerance in pixels 
 
 # define ESCAPE { \
Index: trunk/psastro/src/psastroModelFit.c
===================================================================
--- trunk/psastro/src/psastroModelFit.c	(revision 21390)
+++ trunk/psastro/src/psastroModelFit.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroModelFit.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
Index: trunk/psastro/src/psastroModelFitBoresite.c
===================================================================
--- trunk/psastro/src/psastroModelFitBoresite.c	(revision 21390)
+++ trunk/psastro/src/psastroModelFitBoresite.c	(revision 21409)
@@ -1,5 +1,19 @@
+/** @file psastroModelFitBoresite.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.5 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroStandAlone.h"
 
-// we now have a set of observed L,M values.  fit these to the boresite model
+/** 
+ * we now have a set of observed L,M values.  fit these to the boresite model
+ */
 psVector *psastroModelFitBoresite (psVector *Xo, psVector *Yo, psVector *Po, char *outroot) {
 
Index: trunk/psastro/src/psastroModelParseCamera.c
===================================================================
--- trunk/psastro/src/psastroModelParseCamera.c	(revision 21390)
+++ trunk/psastro/src/psastroModelParseCamera.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroModelParseCamera.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastroModel
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroMosaicAstrom.c
===================================================================
--- trunk/psastro/src/psastroMosaicAstrom.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicAstrom.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicAstrom.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.30 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 # define NONLIN_TOL 0.001 /* tolerance in pixels */
Index: trunk/psastro/src/psastroMosaicChipAstrom.c
===================================================================
--- trunk/psastro/src/psastroMosaicChipAstrom.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicChipAstrom.c	(revision 21409)
@@ -1,4 +1,16 @@
+/** @file psastroMosaiciChipAstrom.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.15 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
-# define NONLIN_TOL 0.001 /* tolerance in pixels */
+# define NONLIN_TOL 0.001 ///< tolerance in pixels
 
 bool psastroMosaicChipAstrom (pmFPA *fpa, psMetadata *recipe, int iteration) {
Index: trunk/psastro/src/psastroMosaicCorrectDistortion.c
===================================================================
--- trunk/psastro/src/psastroMosaicCorrectDistortion.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicCorrectDistortion.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicCorrectDistortion.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.2 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroMosaicDistortion.c
===================================================================
--- trunk/psastro/src/psastroMosaicDistortion.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicDistortion.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicDistortion.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 # define DEBUG 0
Index: trunk/psastro/src/psastroMosaicFPtoTP.c
===================================================================
--- trunk/psastro/src/psastroMosaicFPtoTP.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicFPtoTP.c	(revision 21409)
@@ -1,5 +1,16 @@
+/** @file psastroMosaicFPtoTP.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
-/************************************************/
 psPlaneTransform *psastroMosaicFitRotAndScale (pmFPA *fpa) {
 
@@ -115,5 +126,4 @@
 }
 
-/*****************************/
 bool psastroMosaicApplyRotAndScale (pmFPA *fpa, psPlaneTransform *TPtoFP) {
 
Index: trunk/psastro/src/psastroMosaicGradients.c
===================================================================
--- trunk/psastro/src/psastroMosaicGradients.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicGradients.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicGradients.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.11 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 static int nPass = 0;
Index: trunk/psastro/src/psastroMosaicOneChip.c
===================================================================
--- trunk/psastro/src/psastroMosaicOneChip.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicOneChip.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicOneChip.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.9 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroMosaicSetAstrom.c
===================================================================
--- trunk/psastro/src/psastroMosaicSetAstrom.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicSetAstrom.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicSetAstrom.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.12 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroMosaicSetMatch.c
===================================================================
--- trunk/psastro/src/psastroMosaicSetMatch.c	(revision 21390)
+++ trunk/psastro/src/psastroMosaicSetMatch.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicSetMatch.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.14 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroOneChipFit.c
===================================================================
--- trunk/psastro/src/psastroOneChipFit.c	(revision 21390)
+++ trunk/psastro/src/psastroOneChipFit.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroOneChipFit.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.4 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroOneChipGrid.c
===================================================================
--- trunk/psastro/src/psastroOneChipGrid.c	(revision 21390)
+++ trunk/psastro/src/psastroOneChipGrid.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroOneChipGrid.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.2 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroParseCamera.c
===================================================================
--- trunk/psastro/src/psastroParseCamera.c	(revision 21390)
+++ trunk/psastro/src/psastroParseCamera.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroParseCamera.c
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.18 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroRefstarSubset.c
===================================================================
--- trunk/psastro/src/psastroRefstarSubset.c	(revision 21390)
+++ trunk/psastro/src/psastroRefstarSubset.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroRefstarSubset.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.13 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
Index: trunk/psastro/src/psastroRemoveClumps.c
===================================================================
--- trunk/psastro/src/psastroRemoveClumps.c	(revision 21390)
+++ trunk/psastro/src/psastroRemoveClumps.c	(revision 21409)
@@ -1,5 +1,19 @@
+/** @file psastroRemoveClumps.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.5 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
-// look for and exclude objects in clumps in the input list
+/**
+ * look for and exclude objects in clumps in the input list
+ */
 psArray *psastroRemoveClumps (psArray *input, int scale) {
 
@@ -75,5 +89,7 @@
 
 # if (0)
-// make a list of the outlier pixels
+/**
+ * make a list of the outlier pixels
+ */
 psArray *badpix = psArrayAllocEmpty (16);
 for (int iy = 0; iy < count->numRows; iy++) {
Index: trunk/psastro/src/psastroStandAlone.h
===================================================================
--- trunk/psastro/src/psastroStandAlone.h	(revision 21390)
+++ trunk/psastro/src/psastroStandAlone.h	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroStandAlone.h
+ *
+ *  @brief
+ *
+ *  @ingroup psastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.7 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # ifdef HAVE_CONFIG_H
 # include <config.h>
Index: trunk/psastro/src/psastroTestFuncs.c
===================================================================
--- trunk/psastro/src/psastroTestFuncs.c	(revision 21390)
+++ trunk/psastro/src/psastroTestFuncs.c	(revision 21409)
@@ -1,5 +1,19 @@
+/** @file psastroTestFuncs.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.7 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
-// write out objects
+/**
+ * write out objects
+ */
 bool psastroWriteStars (char *filename, psArray *sources) {
 
Index: trunk/psastro/src/psastroUseModel.c
===================================================================
--- trunk/psastro/src/psastroUseModel.c	(revision 21390)
+++ trunk/psastro/src/psastroUseModel.c	(revision 21409)
@@ -1,8 +1,22 @@
+/** @file psastroMosiacAstrom.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.5 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
-# define NONLIN_TOL 0.001 /* tolerance in pixels */
+# define NONLIN_TOL 0.001 ///< tolerance in pixels
 # define DEBUG 0
 
-// apply the generic astrometry model to this image.  this assumes the WCS terms either do not
-// exist or are invalid 
+/**
+ * Apply the generic astrometry model to this image.  This assumes the WCS i
+ * terms either do not exist or are invalid 
+ */
 bool psastroUseModel (pmConfig *config, psMetadata *recipe) {
 
Index: trunk/psastro/src/psastroUtils.c
===================================================================
--- trunk/psastro/src/psastroUtils.c	(revision 21390)
+++ trunk/psastro/src/psastroUtils.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroUtils.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.24 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 # define RENORM 0
Index: trunk/psastro/src/psastroVersion.c
===================================================================
--- trunk/psastro/src/psastroVersion.c	(revision 21390)
+++ trunk/psastro/src/psastroVersion.c	(revision 21409)
@@ -1,5 +1,17 @@
+/** @file psastroVersion.c
+ *
+ *  @brief
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 #include "psastroInternal.h"
 
-static const char *cvsTag = "$Name: not supported by cvs2svn $";// CVS tag name
+static const char *cvsTag = "$Name: not supported by cvs2svn $";///< CVS tag name
 
 psString psastroVersion(void)
Index: trunk/psastro/src/psastroVisual.c
===================================================================
--- trunk/psastro/src/psastroVisual.c	(revision 21390)
+++ trunk/psastro/src/psastroVisual.c	(revision 21409)
@@ -1,5 +1,14 @@
-/***********************************/
-/***Diagnostic plots for psastro****/
-/***********************************/
+/** @file psastroVisual.c
+ *
+ *  @brief Diagnostic plots for psastro
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.3 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 #ifdef HAVE_CONFIG_H
 #include <config.h>
@@ -47,5 +56,7 @@
 /*****************************/
 
-/**  start or stop plotting */
+/**  
+ * start or stop plotting 
+ */
 bool psastroSetVisual (bool mode) {
     isVisual = mode;
@@ -54,5 +65,7 @@
 
 
-/** open, name, and resize a window if necessary*/
+/** 
+ * open, name, and resize a window if necessary
+ */
 bool psastroVisualInitWindow( int *kapid, char *name ) {
     if (*kapid == -1) {
@@ -69,5 +82,7 @@
 
 
-/** ask the user how to proceed*/
+/** 
+ * ask the user how to proceed
+ */
 bool psastroVisualAskUser( bool *plotflag ) {
     char key[10];
@@ -87,5 +102,7 @@
 
 
-/** destroy windows at the end of a run*/
+/** 
+ * destroy windows at the end of a run
+ */
 bool psastroVisualClose() {
     if(kapa != -1)
Index: trunk/psastro/src/psastroZeroPoint.c
===================================================================
--- trunk/psastro/src/psastroZeroPoint.c	(revision 21390)
+++ trunk/psastro/src/psastroZeroPoint.c	(revision 21409)
@@ -1,2 +1,14 @@
+/** @file psastroMosaicZeroPoint.c
+ *
+ *  @brief 
+ *
+ *  @ingroup libpsastro
+ *
+ *  @author IfA
+ *  @version $Revision: 1.5 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-07 02:03:34 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "psastroInternal.h"
 
@@ -69,5 +81,7 @@
 }
 
-// we measure <dMag> and \sigma_dMag and write them to the header
+/**
+ * we measure <dMag> and \sigma_dMag and write them to the header
+ */
 bool psastroZeroPointReadout(pmReadout *readout, float zeropt, float exptime) {