Index: trunk/archive/pslib/include/psPosition.h
===================================================================
--- trunk/archive/pslib/include/psPosition.h	(revision 253)
+++ trunk/archive/pslib/include/psPosition.h	(revision 257)
@@ -6,4 +6,6 @@
  *  \ingroup AstroGroup
  */
+
+/** Structures *********************/
 
 /** A point in 2-D space, with errors.
@@ -29,5 +31,5 @@
 
 /** A polynomial transformation between coordinate frames.  This may be a linear relationship, or may
- * represent a higher-order transformation.
+ *  represent a higher-order transformation.
  */
 typedef struct {
@@ -37,5 +39,5 @@
 
 /** The optical distortion terms.  The lowest two terms are the x and y axis of the target system.  The higher
- * two terms represent magnitude and color terms.
+ *  two terms represent magnitude and color terms.
  */
 typedef struct {
@@ -44,11 +46,20 @@
 } psDistortion;
 
-psCoord *psCoordXformApply (psCoordXform *frame, psCoord *coords);
+/** Functions **************************************************************/
+/** \addtogroup AstroGroup Astronomy-Specific Utilities
+ *  \{
+ */
 
-psCoord *psDistortionApply (psCoordXform *frame, psCoord *coords);
+/** apply the coordinate transformation to the given coordinate */
+psCoord *psCoordXformApply (psCoordXform *frame, ///< coordinate transformation
+			    psCoord *coords) ///< input coordiate
+;
 
-/***********************************************************************************************************/
-
-/* Offsets */
+/** apply the optical distortion to the given coordinate, magnitude, color */
+psCoord *psDistortionApply (psDistortion *pattern, ///< optical distortion pattern
+psCoord *coords,			///< input coordinate
+float mag,				///< magnitude of object
+float color)				///< color of object
+;
 
 /** Get offset (RA,Dec) on the sky between two positions position1 and position2 may not be identical */
@@ -56,6 +67,6 @@
 psGetOffset(const psCoord *restrict position1, //!< Position 1
 	    const psCoord *restrict position2, //!< Position 2
-	    char *system
-	    );
+	    char *system)
+;
 
 /** Apply an offset to a position */
@@ -63,8 +74,6 @@
 psApplyOffset(const psCoord *restrict position, //!< Position
 	      const psCoord *restrict offset, //!< Offset
-	      char *system
-    );
-
-/***********************************************************************************************************/
+	      char *system)
+;
 
 /* Positions of well-known objects */
@@ -72,6 +81,6 @@
 /** Get Sun Position */
 psCoord *
-psGetSunPos(float mjd			//!< MJD to get position for
-	    );
+psGetSunPos(float mjd)			//!< MJD to get position for
+;
 
 /** Get Moon position */
@@ -79,17 +88,17 @@
 psGetMoonPos(float mjd,			//!< MJD to get position for
 	     double latitude,		//!< Latitude for apparent position
-	     double longitude		//!< Longitude for apparent position
-	     );
+	     double longitude)		//!< Longitude for apparent position
+;
 
 /** Get Moon phase */
 float
-psGetMoonPhase(float mjd		//!< MJD to get phase for
-	       );
+psGetMoonPhase(float mjd)		//!< MJD to get phase for
+;
 
 /** Get Planet positions */
 psCoord *
 psGetSolarSystemPos(char *solarSystemObject, //!< Named S.S. object
-		    float mjd		//!< MJD to get position for
-    );
+		    float mjd)		//!< MJD to get position for
+;
 
 /***********************************************************************************************************/
@@ -99,22 +108,25 @@
 /** Convert ICRS to Ecliptic */
 psCoord *
-psCoordinatesItoE(const psCoord *restrict coordinates //!< ICRS coordinates to convert
-		  );
+psCoordinatesItoE(const psCoord *restrict coordinates) //!< ICRS coordinates to convert
+;
 
 /** Convert Ecliptic to ICRS */
 psCoord *
-psCoordinatesEtoI(const psCoord *restrict coordinates //!< Ecliptic coordinates to convert
-		  );
+psCoordinatesEtoI(const psCoord *restrict coordinates) //!< Ecliptic coordinates to convert
+;
 
 /** Convert ICRS to Galactic */
 psCoord *
-psCoordinatesItoG(const psCoord *restrict coordinates //!< ICRS coordinates to convert
-		  );
+psCoordinatesItoG(const psCoord *restrict coordinates) //!< ICRS coordinates to convert
+;
 
 /** Convert Galactic to ICRS */
 psCoord *
-psCoordinatesGtoI(const psCoord *restrict coordinates //!< Galactic coordinates to convert
-		  );
+psCoordinatesGtoI(const psCoord *restrict coordinates) //!< Galactic coordinates to convert
+;
 
 /***********************************************************************************************************/
+
+/* \} */ // End of AstroGroup Functions
+
 #endif