Index: src/GenPoly/Box.cc
===================================================================
--- src/GenPoly/Box.cc	(revision 145f1fc837f3fe2237a52a1c4d10dfa54a209da5)
+++ src/GenPoly/Box.cc	(revision 7f5566b3fe2cd28774da6eb330d767776dd50ea4)
@@ -204,6 +204,5 @@
 		}
 
-		DeclarationWithType *
-		Pass1::mutate( FunctionDecl *functionDecl ) {
+		DeclarationWithType *Pass1::mutate( FunctionDecl *functionDecl ) {
 			if ( functionDecl->get_statements() ) {
 				TyVarMap oldtyVars = scopeTyVars;
Index: src/GenPoly/Box.h
===================================================================
--- src/GenPoly/Box.h	(revision 145f1fc837f3fe2237a52a1c4d10dfa54a209da5)
+++ src/GenPoly/Box.h	(revision 7f5566b3fe2cd28774da6eb330d767776dd50ea4)
@@ -21,4 +21,5 @@
 
 namespace GenPoly {
+	/// boxes polymorphic function calls
 	void box( std::list< Declaration* >& translationUnit );
 } // namespace GenPoly
Index: src/GenPoly/CopyParams.h
===================================================================
--- src/GenPoly/CopyParams.h	(revision 145f1fc837f3fe2237a52a1c4d10dfa54a209da5)
+++ src/GenPoly/CopyParams.h	(revision 7f5566b3fe2cd28774da6eb330d767776dd50ea4)
@@ -20,4 +20,5 @@
 
 namespace GenPoly {
+	/// Clones by-value parameters which have been passed by-reference for polymorphism
 	void copyParams( std::list< Declaration* > &translationUnit );
 } // namespace GenPoly
Index: src/GenPoly/Lvalue.h
===================================================================
--- src/GenPoly/Lvalue.h	(revision 145f1fc837f3fe2237a52a1c4d10dfa54a209da5)
+++ src/GenPoly/Lvalue.h	(revision 7f5566b3fe2cd28774da6eb330d767776dd50ea4)
@@ -22,4 +22,5 @@
 
 namespace GenPoly {
+	/// replaces return type of `lvalue T` with `T*`, along with appropriate address-of and dereference operators
 	void convertLvalue( std::list< Declaration* >& translationUnit );
 } // namespace GenPoly
Index: src/GenPoly/Specialize.h
===================================================================
--- src/GenPoly/Specialize.h	(revision 145f1fc837f3fe2237a52a1c4d10dfa54a209da5)
+++ src/GenPoly/Specialize.h	(revision 7f5566b3fe2cd28774da6eb330d767776dd50ea4)
@@ -22,4 +22,5 @@
 
 namespace GenPoly {
+	/// generates thunks where needed
 	void convertSpecializations( std::list< Declaration* >& translationUnit );
 } // namespace GenPoly