Index: trunk/archive/pslib/include/psArray.h
===================================================================
--- trunk/archive/pslib/include/psArray.h	(revision 181)
+++ trunk/archive/pslib/include/psArray.h	(revision 196)
@@ -3,5 +3,5 @@
 
 #include <stdlib.h>
-/*
+/**
  * Declare TYPEArray
  */
@@ -19,5 +19,5 @@
 
 /*****************************************************************************/
-/*
+/**
  * Generate the code TYPEArray's constructors/destructors
  */
@@ -78,6 +78,6 @@
 
 /*****************************************************************************/
-/*
- * Support for pointer types
+/**
+ * Declare array of pointers
  */
 #define PS_DECLARE_ARRAY_PTR_TYPE(TYPE) \
@@ -85,4 +85,7 @@
     PS_DECLARE_ARRAY_TYPE(PS_CONCAT(TYPE, Ptr))
 
+/**
+ * Create constructors/destructors for array of pointers
+ */
 #define PS_CREATE_ARRAY_PTR_TYPE(TYPE); \
     P_PS_CREATE_ARRAY_TYPE(static, my_, P_PS_CONCAT(TYPE, Ptr)) \
@@ -117,6 +120,6 @@
 
 /*****************************************************************************/
-/*
- * Declare some common types of arrays
+/**
+ * Array of pointers to void.
  *
  * psVoidPtrArray is special, as it needs to have a destructor that
@@ -125,12 +128,21 @@
  */
 typedef struct {
-   int n, size;
-   void **arr;
+    int n;				//!< Number of elements in use 
+    int size;				//!< Number of total elements
+    void **arr;				//!< The elements
 } psVoidPtrArray;
 
-psVoidPtrArray *psVoidPtrArrayAlloc(int n, int s);
-psVoidPtrArray *psVoidPtrArrayRealloc(psVoidPtrArray *arr, int n);
-void psVoidPtrArrayFree(psVoidPtrArray *arr,
-			void (*elemFree)(void *)); // destructor for array data
+/** Constructor */
+psVoidPtrArray *psVoidPtrArrayAlloc(int n, //!< Number of elements to use
+				    int s //!< Total number of elements
+				    );
+/** Reallocate */
+psVoidPtrArray *psVoidPtrArrayRealloc(psVoidPtrArray *arr, //!< Array to reallocate
+				      int n //!< Number of elements
+				      );
+/** Destructor */
+void psVoidPtrArrayFree(psVoidPtrArray *arr, //!< array to destroy
+			void (*elemFree)(void *) //!< destructor for array data
+			);