Add doxygen documentation on trunk.

Merge trunk in the unified render branch which will be renamed to be 
another branch for new features.

Doxyfile

@@ -31,7 +31,7 @@ PROJECT_NAME           = ViTE
 # This could be handy for archiving the generated documentation or 
 # if some version control system is used.
 
-PROJECT_NUMBER         = 1.0
+PROJECT_NUMBER         = 1.1
 
 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 
 # base path where the generated documentation will be put. 
@@ -513,7 +513,7 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories 
 # with spaces.
 
-INPUT                  = src/interface/ src/message/ src/parser/ src/render/ src/trace/ src/trace/values/ src/trace/tree/ src/main.cpp src/main_resource.hpp src/statistics/ src/general/
+INPUT                  = src/common/ src/core/ src/interface/ src/parser/ src/plugin/ src/render/ src/statistics/ src/trace/ src/trace/values/ src/trace/tree/ src/main.cpp
 
 # This tag can be used to specify the character encoding of the source files 
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is 

src/common/Tools.cpp

@@ -93,16 +93,6 @@ double convert_to_double(const string arg){
 }
 
 #ifdef MEMORY_TRACE
-/*
-  Function: clockGet
-
-  Timing routine.
- 
-  Uses different timing routines depending on the machine architecture.
-
-  Returns:
-    Returns the time ellapsed since <clockStart>.
- */
 double clockGet (void)
 {
 #if (defined X_ARCHalpha_compaq_osf1) || (defined X_ARCHi686_mac)

src/common/Tools.hpp

@@ -61,6 +61,12 @@ double convert_to_double(const std::string args);
 #define MIN(x,y) (((x)<(y))?(x):(y))
 #define MAX(x,y) (((x)<(y))?(y):(x))
 
+/*!
+ * \fn clockGet()
+ * \brief Timing routine.
+ *  Uses different timing routines depending on the machine architecture.
+ * \return the time ellapsed since <clockStart>.
+ */
 double clockGet (void);
 
 #endif // TOOLS_HPP

src/common/common.hpp

@@ -78,7 +78,7 @@
  */
 #define VITE_DATE "December 2009"
 /*!
- * \def VITE_DATE
+ * \def VITE_WEBSITE
  * \brief the ViTE website (string)
  */
 #define VITE_WEBSITE "http://vite.gforge.inria.fr"

src/core/Core.hpp

@@ -41,7 +41,7 @@
 **
 */
 /*!
- *\file interface_console.hpp
+ *\file Core.hpp
  */
 
 #ifndef CORE_HPP
@@ -461,6 +461,9 @@ public:
     void set_max_value_for_export(const double d);
              
 
+    /*!
+     *\brief Return the current trace.
+     */
     Trace *get_trace() const;
 
     /*!

src/interface/Interface.hpp

@@ -41,7 +41,7 @@
 **
 */
 /*!
- *\file interface.hpp
+ *\file Interface.hpp
  */
 
 

src/interface/Interface_graphic.hpp

@@ -41,7 +41,7 @@
 **
 */
 /*!
- *\file interface_graphic.hpp
+ *\file Interface_graphic.hpp
  */
 
 #ifndef INTERFACE_GRAPHIC_HPP
@@ -81,14 +81,21 @@ class Interface_graphic : public QMainWindow,  protected Ui::main_window, public
      */
     void load_windows();
 
-
     /*!
-     *\brief Drag and drop functions
-     *
+     *\brief Drag and drop function
      */
     void dragEnterEvent(QDragEnterEvent *event);
+    /*!
+     *\brief Drag and drop function
+     */
     void dragMoveEvent(QDragMoveEvent *event);
+    /*!
+     *\brief Drag and drop function
+     */
     void dragLeaveEvent(QDragLeaveEvent *event);
+    /*!
+     *\brief Drag and drop function
+     */
     void dropEvent(QDropEvent *event);
 
     /*!

src/parser/Definition.hpp

@@ -61,6 +61,9 @@ struct Field{
      */
     std::string _type;
 
+    /*!
+     *  \brief Constructor
+     */
     Field(const std::string &name, const std::string &type) : _name(name), _type(type){};
 };
 

src/parser/File.hpp

@@ -83,7 +83,7 @@ public:
     ~File();
         
     /*!
-     *  \fn open()
+     *  \fn open(std::string &filename)
      *  \brief Open the file
      *  \param filename the file name
      */
@@ -96,7 +96,7 @@ public:
     void close();
 
     /*!
-     *  \fn get_line()
+     *  \fn get_line(Line &)
      *  \brief Get the next line.
      *  \return the next line
      */

src/parser/Line.hpp

@@ -88,7 +88,7 @@ public:
     /*!
      *  \fn fill_line(const std::string &string_line)
      *  \brief Split the string into tokens
-     *  \param s string to be splitted
+     *  \param string_line string to be splitted
      */
     void fill_line(const std::string &string_line);
 
@@ -130,7 +130,7 @@ public:
     void set_line_number(const unsigned int n);
 
     /*!
-     *  \fn build_composite_token(std::string line, int index)
+     *  \fn build_composite_token(const std::string &line, int index)
      *  \brief create a token within "" or ''
      *  \param line the line containing the token
      *  \param index from where we start to read the line

src/parser/Parser.hpp

@@ -55,12 +55,18 @@
 
 class Parser{
 protected:
+    /*!
+     * Set to true if the parsing is finished.
+     */
     bool _is_finished;
+    /*!
+     * Set to true if the parsing is canceled.
+     */
     bool _is_canceled;
 
 public:
     /*!
-     *  \fn parse(std::string filename, Trace &trace) = 0
+     *  \fn parse(const std::string &filename, Trace &trace, bool finish_trace_after_parse) = 0
      *  \param filename the name of the file to parse
      *  \param trace the structure of data to fill
      *  \param finish_trace_after_parse boolean set if we do not have to finish the trace after parsing
@@ -89,7 +95,7 @@ public:
     virtual void set_canceled() = 0;
 
     /*!
-     *  \fn set_file_to_parse(const std::string filename)
+     *  \fn set_file_to_parse(const std::string &filename)
      *  \param filename : the name of the file to parse
      *  \brief set the name of the file to parse.
      */

src/parser/ParserDefinitionOTF.hpp

@@ -343,7 +343,7 @@ public:
     static ProcessGroup get_processgroup_by_id(const int id);
 
     /*!
-     * \fn get_processgroup_by_process(const int process_id)
+     * \fn get_processgroup_by_process(const unsigned int process_id)
      * \brief Get the first processGroup which contains the process process_id
      * \param process_id the id of the process we want the group
      * \return The ProcessGroup associated to id

src/parser/ParserDefinitionPaje.hpp

@@ -80,13 +80,13 @@ public:
     ParserDefinitionPaje();
 
     /*!
-     *  \fn definitions_number
+     *  \fn definitions_number() const
      *  \return : the number of definitions in the map
      */
     int definitions_number() const;
 
     /*!
-     *  \fn store_definition(Line &)
+     *  \fn store_definition(const Line &l)
      *  \param l the line to store.
      */
     void store_definition(const Line &l);
@@ -99,7 +99,7 @@ public:
     Definition &get_definition(unsigned int i);
 
     /*!
-     *  \fn get_hash_table_of_definitions
+     *  \fn get_hash_table_of_definitions() const
      *  \return : the hash table of definitions
      */
     const std::map<unsigned int,Definition> *get_hash_table_of_definitions() const;
@@ -123,7 +123,7 @@ public:
      */
     void add_field_to_definition(std::string& first_token, const Line& line);
 
-    /*! \fn print_definitions
+    /*! \fn print_definitions() const
      * \brief Print all the definitions. Useful for debug.
      */
     void print_definitions() const;

src/parser/ParserEventOTF.hpp

@@ -105,7 +105,7 @@ public:
     void set_handlers(Trace *t);
 
     /*!
-     * \fn read_definitions(OTF_Reader *reader)
+     * \fn read_events(OTF_Reader *reader)
      * \brief Begin the reading of the events
      * \param reader The main otf file we want to read in.
      */

src/parser/ParserOTF.hpp

@@ -71,7 +71,7 @@ public:
     ParserOTF();
 
     /*!
-     *  \fn parse(std::string filename, Trace &trace)
+     *  \fn parse(const std::string &filename, Trace &trace, bool finish_trace_after_parse)
      *  \param filename : the name of the file to parse
      *  \param trace : the structure of data to fill
      *  \param finish_trace_after_parse boolean set if we do not have to finish the trace after parsing
@@ -79,7 +79,7 @@ public:
     void parse(const std::string &filename, Trace &trace, bool finish_trace_after_parse = true);
     
     /*!
-     *  \fn set_file_to_parse(const std::string filename)
+     *  \fn set_file_to_parse(const std::string &filename)
      *  \param filename : the name of the file to parse
      *  \brief set the name of the file to parse.
      */

src/parser/ParserPaje.hpp

@@ -81,7 +81,7 @@ public:
     ~ParserPaje();
 
     /*!
-     *  \fn parse(std::string filename, Trace &trace)
+     *  \fn parse(const std::string &filename, Trace &trace, bool finish_trace_after_parse)
      *  \param filename : the name of the file to parse
      *  \param trace : the structure of data to fill
      *  \param finish_trace_after_parse boolean set if we do not have to finish the trace after parsing
@@ -89,7 +89,7 @@ public:
     void parse(const std::string &filename, Trace &trace, bool finish_trace_after_parse = true);
     
     /*!
-     *  \fn set_file_to_parse(const std::string filename)
+     *  \fn set_file_to_parse(const std::string &filename)
      *  \param filename : the name of the file to parse
      *  \brief set the name of the file to parse.
      */
@@ -122,7 +122,7 @@ public:
     void set_canceled();
 
     /*! 
-     * \fn get_definitions()
+     * \fn get_definitions() const
      * \brief get the definitions from the parserdefinition
      */
     const std::map<unsigned int, Definition> *get_definitions() const;

src/parser/ParserVite.hpp

@@ -72,14 +72,15 @@ public:
     ParserVite();
 
     /*!
-     *  \fn parse(std::string filename, Trace &trace)
+     *  \fn parse(const std::string &filename, Trace &trace, bool finish_trace_after_parse)
      *  \param filename : the name of the file to parse
      *  \param trace : the structure of data to fill
+     *  \param finish_trace_after_parse : close the trace when parsing is finished if set to true
      */
     void parse(const std::string &filename, Trace &trace, bool finish_trace_after_parse = true);
     
     /*!
-     *  \fn set_file_to_parse(const std::string filename)
+     *  \fn set_file_to_parse(const std::string &filename)
      *  \param filename : the name of the file to parse
      *  \brief set the name of the file to parse.
      */

src/plugin/Command_window.hpp

@@ -41,7 +41,7 @@
 **
 */
 /*!
- * \file command_window.hpp
+ * \file Command_window.hpp
  */
 
 #ifndef _COMMAND_WINDOW_HPP

src/render/Render_template.hpp

@@ -41,7 +41,7 @@
 **
 */
 /*!
- *\file render.hpp
+ *\file Render_template.hpp
  */
 
 #ifndef RENDER_TEMPLATE_HPP

src/render/render_stats_svg.hpp

@@ -182,7 +182,7 @@ public:
 
 
      /*!
-     * \fn set_height_for_a_container()
+     * \fn set_height_for_one_container(Element_pos)
      * \brief Useless for svg.
      */
     void set_height_for_one_container(Element_pos /*h*/){};