Index: trunk/archive/pslib/include/psMisc.h
===================================================================
--- trunk/archive/pslib/include/psMisc.h	(revision 181)
+++ trunk/archive/pslib/include/psMisc.h	(revision 196)
@@ -1,19 +1,29 @@
 #if !defined(PS_MISC_H)
 #define PS_MISC_H
-/*
+/**
  * Concatenate two macro arguments
  */
-#define P_PS_CONCAT(A, B) A ## B	// Expands to AB
-#define PS_CONCAT(A, B) A ## B		// Also Expands to AB
-#define PS_CONCAT2(A, B) PS_CONCAT(A, B) // Also expands to AB
-#define PS_CONCAT3(A, B, C) A ## B ## C // Expands to ABC
-#define PS_CONCAT4(A, B, C, D) A ## B ## C ## D // Expands to ABCD
+#define P_PS_CONCAT(A, B) A ## B	//!< Expands to AB
+#define PS_CONCAT(A, B) A ## B		//!< Also Expands to AB
+#define PS_CONCAT2(A, B) PS_CONCAT(A, B) //!< Also expands to AB
+#define PS_CONCAT3(A, B, C) A ## B ## C //!< Expands to ABC
+#define PS_CONCAT4(A, B, C, D) A ## B ## C ## D //!< Expands to ABCD
 
-#define PS_STRING(S) #S			// converts argument to string
+#define PS_STRING(S) #S			//!< converts argument to string
 
-void psAbort(const char *name, const char *fmt, ...);
-void psError(const char *name, const char *fmt, ...);
+/** Prints an error message and aborts */
+void psAbort(const char *name,		//!< Category of code that caused the abort
+	     const char *fmt,		//!< Format
+	     ...			//!< Extra arguments to use format
+    );
+/** Prints an error message and doesn't abort */
+void psError(const char *name,		//!< Category of code that caused the abort
+	     const char *fmt,		//!< Format
+	     ...			//!< Extra arguments to use format
+    );
 
-char *psStringCopy(const char *str);
+/** Allocates and returns a copy of a string */
+char *psStringCopy(const char *str	//!< string to copy
+    );
 
 #endif