Index: trunk/psLib/src/collections/psArray.h
===================================================================
--- trunk/psLib/src/collections/psArray.h	(revision 1441)
+++ trunk/psLib/src/collections/psArray.h	(revision 1471)
@@ -12,6 +12,6 @@
  *  @author Ross Harman, MHPCC
  *
- *  @version $Revision: 1.15 $ $Name: not supported by cvs2svn $
- *  @date $Date: 2004-08-09 23:40:55 $
+ *  @version $Revision: 1.16 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2004-08-11 19:47:31 $
  *
  *  Copyright 2004 Maui High Performance Computing Center, University of Hawaii
@@ -54,6 +54,7 @@
  *
  */
-psArray* psArrayAlloc(unsigned int nalloc       ///< Total number of elements to make available.
-                     );
+psArray* psArrayAlloc(
+    unsigned int nalloc                ///< Total number of elements to make available.
+);
 
 /** Reallocate an array.
@@ -65,7 +66,8 @@
  *
  */
-psArray* psArrayRealloc(unsigned int nalloc,    ///< Total number of elements to make available.
-                        psArray* restrict psArr        ///< array to reallocate.
-                       );
+psArray* psArrayRealloc(
+    unsigned int nalloc,               ///< Total number of elements to make available.
+    psArray* restrict psArr            ///< array to reallocate.
+);
 
 /** Deallocate/Dereference elements of an array.
@@ -76,6 +78,7 @@
  *
  */
-void psArrayElementFree(psArray* restrict psArr        ///< Void pointer array to destroy.
-                       );
+void psArrayElementFree(
+    psArray* restrict psArr            ///< Void pointer array to destroy.
+);
 
 /** Sort the array according to an external compare function.
@@ -84,7 +87,17 @@
  *  to specify how the objects on the array should be sorted.
  *
+ *  The comparison function must return an integer less than, equal to, or 
+ *  greater than zero if the first argument is considered to be respectively 
+ *  less than, equal to, or greater than the second. 
+ *
+ *  If two members compare as equal, their order in the sorted array is 
+ *  undefined.
+ *
  *  @return psArray* The sorted array.
  */
-psArray* psArraySort(psArray* in, psComparePtrFcn compare);
+psArray* psArraySort(
+    psArray* in,                       ///< input array to sort.
+    psComparePtrFcn compare            ///< the compare function
+);
 
 /// @}