doxygen update

2 files changed, 29 insertions, 5 deletions

diff --git a/include/sitecing/sitecing_enflesher.h b/include/sitecing/sitecing_enflesher.h
index db15bc3..9eefdcc 100644
--- a/include/sitecing/sitecing_enflesher.h
+++ b/include/sitecing/sitecing_enflesher.h
@@ -8,34 +8,37 @@ using namespace std;
 /**
  * @file
  * @brief The preprocessed source builder.
  */
 
 #ifndef sitecing_enflesher_flexlexer_once
 #define sitecing_enflesher_flexlexer_once
 #undef yyFlexLexer
+/**
+ * nevermind me
+ */
 #define yyFlexLexer sitecing_enflesherFlexLexer
 #include <FlexLexer.h>
 #undef yyFlexLexerOnce
 #endif
 
 class sitecing_parser;
 /**
  * The enfleshing of the skeleton file according to the in-memory parsed
  * component source.
  */
 class sitecing_enflesher : public sitecing_enflesherFlexLexer {
     public:
         /**
-         * It is time to anchor output with the #line directive.
+         * It is time to anchor output with the \#line directive.
          */
         bool anchor_time;
         /**
-         * The file currently being written is supposed to have #line
+         * The file currently being written is supposed to have \#line
          * directives all around the place.
          */
         bool anchoraged;
         /**
          * The reference to the parser object containg the parsed source.
          */
         sitecing_parser& parser;
         /**
@@ -54,21 +57,30 @@ class sitecing_enflesher : public sitecing_enflesherFlexLexer {
         sitecing_enflesher(sitecing_parser& p)
             : parser(p), anchor_time(true) { }
 
         /**
          * Do the job.
          */
         void enflesh();
 
+        /**
+         * Output parsed data
+         * @param buf pointer to the data
+         * @param size length of the buffer pointed by buf
+         */
         virtual void LexerOutput(const char *buf,int size);
+        /**
+         * Lexer generated by flex
+         * @return zero on success
+         */
         virtual int yylex();
 
         /**
-         * Put a #line anchor into output.
+         * Put a \#line anchor into output.
          */
         void anchor();
 
         /**
          * Close previously opened output stream, rename to the 'correct'
          * destination filename, if needed, and open new file.
          * @see outs
          * @see outs_filename
diff --git a/include/sitecing/sitecing_parser.h b/include/sitecing/sitecing_parser.h
index a53ef22..bcabc5c 100644
--- a/include/sitecing/sitecing_parser.h
+++ b/include/sitecing/sitecing_parser.h
@@ -13,16 +13,19 @@ using namespace sitecing;
 /**
  * @file
  * @brief The component source parser.
  */
 
 #ifndef sitecing_parser_flexlexer_once
 #define sitecing_parser_flexlexer_once
 #undef yyFlexLexer
+/**
+ * nevermind me
+ */
 #define yyFlexLexer sitecing_parserFlexLexer
 #include <FlexLexer.h>
 #undef yyFlexLexerOnce
 #endif
 
 /**
  * The component source parser.
  */
@@ -306,29 +309,38 @@ class sitecing_parser : public sitecing_parserFlexLexer {
         sitecing_parser(component_factory& f);
 
         /**
          * Preprocess file.
          * @param in input file name.
          */
         void preprocess(const string& in);
 
+        /**
+         * Output parsed data
+         * @param buf pointer to the data
+         * @param size length of the buffer pointed by buf
+         */
         virtual void LexerOutput(const char *buf,int size);
+        /**
+         * Lexer generated by flex
+         * @return zero on success
+         */
         virtual int yylex();
 
         /**
          * Retrieve reference to the to of the modes stack.
          * @return the reference in question.
          */
         modus_operandi& M() {
             return modi.front();
         }
         /**
-         * Anchor the output with the #line, if we're not in the text output mode.
+         * Anchor the output with the \#line, if we're not in the text output mode.
          */
         void soft_anchor();
         /**
-         * Anchor the output with the #line directive, changing to the appropriate output mode if needed.
+         * Anchor the output with the \#line directive, changing to the appropriate output mode if needed.
          */
         void anchor();
 };
 
 #endif /* __SITECING_SITECING_PARSER_H */