Differences

This shows you the differences between two versions of the page.

--- doxygen [2018/05/02 20:18] – jeferson
+++ doxygen [2018/06/25 19:22] (current) – jeferson
@@ Line 11: / Line 11: @@
 </code>
-asdasd
+==== Documenting the code: ====
-asdasdasd
+The code must be documented in one of the following options:
+. C-style comment block
+<code>
+/**
+ * ... text ...
+ */
+</code>
+. Qt style
+<code>
+/*!
+ * ... text ...
+ */
+</code>
+. C++-like comment lines
+<code>
+///
+/// ... text ...
+///
+</code>
+or
+<code>
+//!
+//!... text ...
+//!
+</code>
+For brief descriptions, the following format must be used:
+.
+<code>
+/*! brief Brief description.
+ *   Brief description continued.
+ *
+ *  Detailed description starts here.
+ */
+</code>
+.
+<code>
+/// Brief description which ends at this dot. Details follow
+/// here.
+</code>
+.
+<code>
+/// Brief description.
+/** Detailed description. */
+</code>
+or
+<code>
+//! Brief description.
+//! Detailed description
+//! starts here.
+</code>
+==== Creating the documentation: ====
+The documentation can be created by many ways with doxygen. The most general is setting a Doxyfile, i. e., a file which describes the settings to be used by the doxygen documentation system. It can be done by accessing the program repository and typing the command
+<code>
+doxygen -g Doxyfile
+</code>
+A standard Doxyfile is created and can be personalized with many options.
+To create the documentation file run
+<code>
+doxygen Doxyfile
+</code>
+If GENERATE_HTML is set to YES, doxygen will generate HTML output. Then open the index.html file to view the code documentation. For more information about doxygen and personalization issues click [[http://www.stack.nl/~dimitri/doxygen/manual/index.html|here]].
+You can download the current Doxyfile used by the research group {{:doxyfile.txt|here}}.