Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- doxygen [2016/07/22 14:31] – [Instalace] djbuldog
+++ doxygen [2025/08/28 10:09] (aktuální) – upraveno mimo DokuWiki 127.0.0.1
@@ Řádek 27: / Řádek 27: @@
 </code>
-==== úprava cfg ====
+==== Základní úprava konfiguračního souboru ====
   * nastavit základní info o projektu
@@ Řádek 39: / Řádek 39: @@
 <code>
-OUTPUT_DIRECTORY = "doc"
+OUTPUT_DIRECTORY       = "doc"
 </code>
-==== syntax ve zdrojovém kódu ====
+  * nastavit cestu ke zdrojovým souborům
-  * http://www.jiggerjuice.net/software/doxygen.html
-  * komentáře na které má doxygen reagovat se identifikují pomocí: buď %%/**%% nebo %%//!%% (podle použitého komentáře)
+<code>
-     * funguje i %%/*!%% (doporučeno od vedoucího DP)
+INPUT                  = "src"
-  * všechny následující parametry se používají právě uvnitř tohoto komentáře
+</code>
+  * vybrat si výstupní formát HTML, tex, xml, ...
+==== Doxygen komentáře zdrojových kódů ====
+  * aby se vygenerovala dokumentace k souboru, musí obsahovat doxygen hlavičku (nebo v cfg zapnout volbu extractall0
+  * komentáře na které má doxygen reagovat se identifikují pomocí:
+    * %%/**%% - víceřádkový, JavaDoc styl
+    * %%/*!%% - víceřádkový, Qt styl
+    * %%///%% - jednořádkový
+    * %%//!%% - jednořádkový
+=== Hlavička ===
-=== hlavička ===
   * na začátku zdrojáku lze specifikovat uvnitř komentáře následující klíčové slova
      * (lze psát \slovo (doporučeno vedoucím DP) i @slovo používané v javě)
@@ Řádek 69: / Řádek 81: @@
  </code>
-=== funkce ===
+=== Funkce ===
     * @brief Description of the function
     * @brief directive, leave a blank line and add a detailed description of what the function does. Also add the following optional
@@ Řádek 86: / Řádek 98: @@
  </code>
-=== proměnné a struktury ===
+=== Proměnné a struktury ===
+==== Main page ====
+  * kromě automaticky generované dokumentace podporuje doxygen i extra dokumentaci přes .dox soubory