Thrift compiler code cleanup, comments, php inline generation, etc


git-svn-id: https://svn.apache.org/repos/asf/incubator/thrift/trunk@664822 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/compiler/cpp/src/main.h b/compiler/cpp/src/main.h
index b26142c..1281cc9 100644
--- a/compiler/cpp/src/main.h
+++ b/compiler/cpp/src/main.h
@@ -1,17 +1,27 @@
 #ifndef T_MAIN_H
 #define T_MAIN_H
 
-/** Defined in the flex library */
-extern int   yylex(void);
-extern int   yyparse(void);
+/**
+ * Defined in the flex library
+ */
 
-/** Expected to be defined by Flex/Bison */
-extern void  yyerror(char* fmt, ...);
+extern int yylex(void);
+extern int yyparse(void);
 
-/** Parse debug output */
-extern void  pdebug(char* fmt, ...);
+/**
+ * Expected to be defined by Flex/Bison
+ */
+extern void yyerror(char* fmt, ...);
 
-/** Flex utilities */
+/**
+ * Parse debugging output, used to print warnings etc.
+ */
+extern void pdebug(char* fmt, ...);
+
+/**
+ * Flex utilities
+ */
+
 extern int   yylineno;
 extern char  yytext[];
 extern FILE* yyin;