Index: trunk/archive/pslib/include/psMath.h
===================================================================
--- trunk/archive/pslib/include/psMath.h	(revision 238)
+++ trunk/archive/pslib/include/psMath.h	(revision 247)
@@ -2,10 +2,19 @@
 #define PS_MATH_H
 
-/** in this method, the data types (psImage, psVector) include embedded information about their data type in
- * the structure.  The constant value is then handled by calling the psScalar function which returns a private
- * scalar data type which is always freed by the code.  This forces the layout of the data structures to be
- * consistent, with the type information as the first entry.  We can then define a data type which is
- * completely flat and can be used to check on the data type of the data.
+/** \file psMath.h
+ *  \brief math operators between PSLib data types
+ *  \ingroup MathGroup
  */
+
+/** private structure used to pass constant values into the math operators. */
+typedef struct {
+    psType type;			///< data type information
+    union {			       
+	int i;				///< integer value entry
+	float f;			///< float value entry
+	double d;			///< double value entry
+	complex float c;		///< complex value entry
+    }
+} p_psScalar;
 
 /** Perform a binary operation on two data items (psImage, psVector, psScalar). */
@@ -24,5 +33,5 @@
 );
 
-/** create a psType-ed structure from a constant value. */
+/** create a psType-ed structure from a constant double value. */
 p_ps_Scalar *
 psScalar (double value);
@@ -34,13 +43,10 @@
 );
 
-typedef struct {
-    psType type;
-    union {
-	int i;
-	float f;
-	double d;
-	complex float c;
-    }
-} p_psScalar;
+/** the functions defined here can operate on the basic PSLib data types: psImage, psVector, XXX.  These data
+ *  types include embedded information about their type in the structure.  Constant values are handled by
+ *  wrapping the value in the psScalar function, which returns a private scalar data type, p_ps_Scalar, which
+ *  is always freed by the function.  The return value type can be determined by casting the return to psType
+ *  and checking the type entry.  
+ */
 
 /* examples of usage:
@@ -66,5 +72,4 @@
 
 */
-
 
 #endif