Index: src/SymTab/FixFunction.h
===================================================================
--- src/SymTab/FixFunction.h	(revision 85c4ef0989717f74ab61b2f8edadc71d37320cd6)
+++ src/SymTab/FixFunction.h	(revision dfee306217f7777314fd2b0dc26100a95e34eccb)
@@ -20,4 +20,5 @@
 
 namespace SymTab {
+	/// Replaces function and array types by equivalent pointer types.
 	class FixFunction : public Mutator {
 		typedef Mutator Parent;
Index: src/SymTab/Validate.cc
===================================================================
--- src/SymTab/Validate.cc	(revision 85c4ef0989717f74ab61b2f8edadc71d37320cd6)
+++ src/SymTab/Validate.cc	(revision dfee306217f7777314fd2b0dc26100a95e34eccb)
@@ -60,4 +60,5 @@
 	class HoistStruct : public Visitor {
 	  public:
+		/// Flattens nested struct types
 		static void hoistStruct( std::list< Declaration * > &translationUnit );
   
@@ -84,4 +85,5 @@
 	};
 
+	/// Replaces enum types by int, and function or array types in function parameter and return lists by appropriate pointers
 	class Pass1 : public Visitor {
 		typedef Visitor Parent;
@@ -89,5 +91,6 @@
 		virtual void visit( FunctionType *func );
 	};
-  
+
+	/// Associates forward declarations of aggregates with their definitions
 	class Pass2 : public Indexer {
 		typedef Indexer Parent;
@@ -110,4 +113,5 @@
 	};
 
+	/// Replaces array and function types in forall lists by appropriate pointer type
 	class Pass3 : public Indexer {
 		typedef Indexer Parent;
@@ -123,4 +127,5 @@
 	class AddStructAssignment : public Visitor {
 	  public:
+		/// Generates assignment operators for aggregate types as required
 		static void addStructAssignment( std::list< Declaration * > &translationUnit );
 
@@ -444,6 +449,6 @@
 	}
 
+	/// Fix up assertions
 	void forallFixer( Type *func ) {
-		// Fix up assertions
 		for ( std::list< TypeDecl * >::iterator type = func->get_forall().begin(); type != func->get_forall().end(); ++type ) {
 			std::list< DeclarationWithType * > toBeDone, nextRound;
Index: src/SymTab/Validate.h
===================================================================
--- src/SymTab/Validate.h	(revision 85c4ef0989717f74ab61b2f8edadc71d37320cd6)
+++ src/SymTab/Validate.h	(revision dfee306217f7777314fd2b0dc26100a95e34eccb)
@@ -23,4 +23,5 @@
 	class Indexer;
 
+	/// Normalizes struct and function declarations
 	void validate( std::list< Declaration * > &translationUnit, bool doDebug = false );
 	void validateType( Type *type, const Indexer *indexer );