Index: trunk/archive/pslib/include/psStats.h
===================================================================
--- trunk/archive/pslib/include/psStats.h	(revision 257)
+++ trunk/archive/pslib/include/psStats.h	(revision 344)
@@ -39,32 +39,32 @@
 /** generic statistics structure */
 typedef struct {
-    double sampleMean;			//<! formal mean of sample
-    double sampleMedian;		//<! formal median of sample
-    double sampleMode;			//!< Formal mode of sample
-    double sampleStdev;			//<! standard deviation of sample
-    double sampleUQ;			//<! upper quartile of sample
-    double sampleLQ;			//<! lower quartile of sample
-    double robustMean;			//<! robust mean of array
-    double robustMeanError;		//<! error on robust mean
-    int    robustMeanNvalues;		//<! number of measurements used for robust mean
-    double robustMedian;		//<! robust median of array
-    double robustMedianError;		//<! error on robust median
-    int    robustMedianNvalues;		//<! number of measurements used for robust median
-    double robustMode;			//!< Robust mode of array
-    double robustModeErr;		//!< Error in robust mode
-    int    robustModeNvalues;		//!< Number of measurements used for robust mode
-    double robustStdev;			//<! robust standard deviation of array
-    double robustUQ;			//<! robust upper quartile
-    double robustLQ;			//<! robust lower quartile
-    double clippedMean;			//<! Nsigma clipped mean
-    double clippedMeanError;		//<! error on clipped mean
-    int    clippedMeanNvalues;		//<! number of data points used for clipped mean
-    double clippedStdev;		//!< standard deviation after clipping
-    double clipSigma;			//<! Nsigma used for clipping; user input
-    int    clipIter;			//!< Number of clipping iterations; user input
-    double min;				//<! minimum data value in array
-    double max;				//<! maximum data value in array
-    int    nValues;			//<! number of data values in array
-    psStatsOptions options;		//<! bitmask of calculated values
+    double sampleMean;			///< formal mean of sample
+    double sampleMedian;		///< formal median of sample
+    double sampleMode;			///< Formal mode of sample
+    double sampleStdev;			///< standard deviation of sample
+    double sampleUQ;			///< upper quartile of sample
+    double sampleLQ;			///< lower quartile of sample
+    double robustMean;			///< robust mean of array
+    double robustMeanError;		///< error on robust mean
+    int    robustMeanNvalues;		///< number of measurements used for robust mean
+    double robustMedian;		///< robust median of array
+    double robustMedianError;		///< error on robust median
+    int    robustMedianNvalues;		///< number of measurements used for robust median
+    double robustMode;			///< Robust mode of array
+    double robustModeErr;		///< Error in robust mode
+    int    robustModeNvalues;		///< Number of measurements used for robust mode
+    double robustStdev;			///< robust standard deviation of array
+    double robustUQ;			///< robust upper quartile
+    double robustLQ;			///< robust lower quartile
+    double clippedMean;			///< Nsigma clipped mean
+    double clippedMeanError;		///< error on clipped mean
+    int    clippedMeanNvalues;		///< number of data points used for clipped mean
+    double clippedStdev;		///< standard deviation after clipping
+    double clipSigma;			///< Nsigma used for clipping; user input
+    int    clipIter;			///< Number of clipping iterations; user input
+    double min;				///< minimum data value in array
+    double max;				///< maximum data value in array
+    int    nValues;			///< number of data values in array
+    psStatsOptions options;		///< bitmask of calculated values
 } psStats;
 
@@ -72,9 +72,9 @@
 /** Do Statistics on an array.  Returns a status value. \ingroup MathGroup */
 psStats *
-psArrayStats(const psFloatArray *restrict myArray, //!< Array to be analysed
-	     const psIntArray *restrict maskArray, //!< Ignore elements where (maskArray & maskVal) != 0
-						   //!< May be NULL
-	     unsigned int maskVal,	//!< Only mask elements with one of these bits set in maskArray
-	     psStats *stats		//!< stats structure defines stats to be calculated and how
+psArrayStats(const psFloatArray *restrict myArray, ///< Array to be analysed
+	     const psIntArray *restrict maskArray, ///< Ignore elements where (maskArray & maskVal) != 0
+						   ///< May be NULL
+	     unsigned int maskVal,	///< Only mask elements with one of these bits set in maskArray
+	     psStats *stats		///< stats structure defines stats to be calculated and how
     );
 
@@ -83,29 +83,29 @@
 /** Histograms  */
 typedef struct {
-    const psFloatArray *restrict lower;	//!< Lower bounds for the bins
-    const psFloatArray *restrict upper; //!< Upper bounds for the bins
-    psIntArray *nums;			//!< Number in each of the bins
-    const float minVal, maxVal;		//!< Minimum and maximum values
-    int minNum, maxNum;			//!< Number below the minimum and above the maximum
+    const psFloatArray *restrict lower;	///< Lower bounds for the bins
+    const psFloatArray *restrict upper; ///< Upper bounds for the bins
+    psIntArray *nums;			///< Number in each of the bins
+    const float minVal, maxVal;		///< Minimum and maximum values
+    int minNum, maxNum;			///< Number below the minimum and above the maximum
 } psHistogram;
 
 /** Constructor \ingroup MathGroup */
 psHistogram *
-psHistogramAlloc(float lower,		//!< Lower limit for the bins
-		 float upper,		//!< Upper limit for the bins
-		 float size		//!< Size of the bins
+psHistogramAlloc(float lower,		///< Lower limit for the bins
+		 float upper,		///< Upper limit for the bins
+		 float size		///< Size of the bins
     );
 
 /** Generic constructor \ingroup MathGroup */
 psHistogram *
-psHistogramAllocGeneric(const psFloatArray *restrict lower, //!< Lower bounds for the bins
-			const psFloatArray *restrict upper, //!< Upper bounds for the bins
-			float minVal,	//!< Minimum value
-			float maxVal	//!< Maximum value
+psHistogramAllocGeneric(const psFloatArray *restrict lower, ///< Lower bounds for the bins
+			const psFloatArray *restrict upper, ///< Upper bounds for the bins
+			float minVal,	///< Minimum value
+			float maxVal	///< Maximum value
     );
 
 /** Destructor \ingroup MathGroup **/
 void
-psHistogramFree(psHistogram *restrict myHist //!< Histogram to destroy
+psHistogramFree(psHistogram *restrict myHist ///< Histogram to destroy
     );
 
@@ -113,6 +113,6 @@
 /** Calculate a histogram \ingroup MathGroup **/
 psHistogram *
-psGetArrayHistogram(psHistogram *restrict myHist, //!< Histogram data
-		    const psFloatArray *restrict myArray //!< Array to analyse
+psGetArrayHistogram(psHistogram *restrict myHist, ///< Histogram data
+		    const psFloatArray *restrict myArray ///< Array to analyse
     );