Index: trunk/pswarp/src/pswarpMapGrid.c
===================================================================
--- trunk/pswarp/src/pswarpMapGrid.c	(revision 18839)
+++ trunk/pswarp/src/pswarpMapGrid.c	(revision 21323)
@@ -1,8 +1,22 @@
+/** @file pswarpMapGrid.c
+ *
+ *  @brief
+ *
+ *  @ingroup pswarp
+ *
+ *  @author IfA
+ *  @version $Revision: 1.7 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2009-02-05 20:44:04 $
+ *  Copyright 2009 Institute for Astronomy, University of Hawaii
+ */
+
 # include "pswarp.h"
 
-// pswarpMapGridFromImage builds a set (a grid) of locally-linear maps which convert the source
-// coordinates (src) to destination coordinates (dest).  we construct a grid with superpixel
-// spacing of nXpix, nYpix.  The transformation for each grid cell is valid for the superpixel.
-// The grid over-fills the source image so every source image pixel is guaranteed to have a map.
+/**
+ * pswarpMapGridFromImage builds a set (a grid) of locally-linear maps which convert the source
+ * coordinates (src) to destination coordinates (dest).  we construct a grid with superpixel
+ * spacing of nXpix, nYpix.  The transformation for each grid cell is valid for the superpixel.
+ * The grid over-fills the source image so every source image pixel is guaranteed to have a map.
+ */
 pswarpMapGrid *pswarpMapGridFromImage (pmReadout *dest, pmReadout *src, int nXpix, int nYpix) {
 
@@ -41,6 +55,8 @@
 }
 
-// set the grid coordinate (gridX,gridY) for the given source image coordinate (ix,iy)
-// XXX return true if the result is on the src image, false otherwise (???)
+/**
+ * set the grid coordinate (gridX,gridY) for the given source image coordinate (ix,iy)
+ * XXX return true if the result is on the src image, false otherwise (???)
+ */
 bool pswarpMapGridSetGrid (pswarpMapGrid *grid, int ix, int iy, int *gridX, int *gridY) {
 
@@ -51,5 +67,7 @@
 }
 
-// given the specified grid coordinate (gridX, gridY), return the min and max coordinates for the tile
+/**
+ * given the specified grid coordinate (gridX, gridY), return the min and max coordinates for the tile
+ */
 bool pswarpMapGridCoordRange (pswarpMapGrid *grid, int gridX, int gridY, psPlane *min, psPlane *max) {
 
@@ -63,6 +81,8 @@
 }
 
-// given the specified grid coordinate (gridX), return the x-coordinate for the source image
-// corresponding to the next grid cell
+/**
+ * given the specified grid coordinate (gridX), return the x-coordinate for the source image
+ * corresponding to the next grid cell
+ */
 int pswarpMapGridNextGrid_X (pswarpMapGrid *grid, int gridX) {
 
@@ -71,6 +91,8 @@
 }
 
-// given the specified grid coordinate (gridY), return the y-coordinate for the source image
-// corresponding to the next grid cell
+/**
+ * given the specified grid coordinate (gridY), return the y-coordinate for the source image
+ * corresponding to the next grid cell
+ */
 int pswarpMapGridNextGrid_Y (pswarpMapGrid *grid, int gridY) {
 
@@ -79,6 +101,8 @@
 }
 
-// measure the max error accumulated in applying one grid point to its neighbors
-// XXX double-check this
+/**
+ * measure the max error accumulated in applying one grid point to its neighbors
+ * XXX double-check this
+ */
 double pswarpMapGridMaxError (pswarpMapGrid *grid) {
 
@@ -102,5 +126,7 @@
 }
 
-// given the source coordinate (inX,inY), return the destination coordinate (outX,outY)
+/**
+ * given the source coordinate (inX,inY), return the destination coordinate (outX,outY)
+ */
 bool pswarpMapApply (double *outX, double *outY, pswarpMap *map, double inX, double inY) {
 
@@ -111,7 +137,9 @@
 }
 
-// determine the (linear) map for the given pixel (ix,iy) from source image (src) to the destination image (dest)
-// pixel is in src coords. input and output pixel coordinates are in the parent frame of the image (Note that the
-// astrometric transformations are supplied for the parent image coordinate frame.
+/**
+ * determine the (linear) map for the given pixel (ix,iy) from source image (src) to the destination image (dest)
+ * pixel is in src coords. input and output pixel coordinates are in the parent frame of the image (Note that the
+ * astrometric transformations are supplied for the parent image coordinate frame.
+ */
 bool pswarpMapSetLocalModel (pswarpMap *map, pmReadout *dest, pmReadout *src, int ix, int iy) {
 
@@ -139,5 +167,5 @@
     // XXX need to include readout->cell->chip offsets
 
-    // V(0,0) position
+    /** V(0,0) position */
     offset->x = ix;
     offset->y = iy;
@@ -149,5 +177,5 @@
     psPlaneTransformApply (V00, chipDest->fromFPA, FP);
     
-    // V(1,0) position
+    /** V(1,0) position */
     offset->x = ix + 1;
     offset->y = iy;
@@ -159,5 +187,5 @@
     psPlaneTransformApply (V10, chipDest->fromFPA, FP);
     
-    // V(0,1) position
+    /** V(0,1) position */
     offset->x = ix;
     offset->y = iy + 1;