Index: trunk/archive/pslib/include/psTrace.h
===================================================================
--- trunk/archive/pslib/include/psTrace.h	(revision 196)
+++ trunk/archive/pslib/include/psTrace.h	(revision 247)
@@ -2,5 +2,11 @@
 #define PS_TRACE_H 1
 
+/** \file psTrace.h
+ *  \brief basic run-time trace facilities
+ *  \ingroup SystemGroup
+ */
+
 //#define PS_NTRACE 1			//!< to turn off all tracing
+
 #if defined(PS_NTRACE)
 #  define psTrace(facil, level, ...)	/* do nothing */
@@ -11,14 +17,17 @@
 
 /** Send a trace message */
-void p_psTrace(const char *facil, int level, ...);
+void p_psTrace(const char *facil, 	//!< facilty of interest
+	       int level,		//!< desired trace level
+	       ...			//!< trace message arguments 
+);
 
 /** Set trace level */
 int psSetTraceLevel(const char *facil,	//!< facilty of interest
 		    int level		//!< desired trace level
-    );
+);
 
 /** Get the trace level */
 int psGetTraceLevel(const char *name	//!< facilty of interest
-    );
+);
 
 /** turn off all tracing, and free trace's allocated memory */