doxygen
Rozdíly
Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
| Obě strany předchozí revizePředchozí verzeNásledující verze | Předchozí verze | ||
| doxygen [2016/07/22 15:05] – [syntax ve zdrojovém kódu] djbuldog | doxygen [2025/08/28 10:09] (aktuální) – upraveno mimo DokuWiki 127.0.0.1 | ||
|---|---|---|---|
| Řádek 27: | Řádek 27: | ||
| </ | </ | ||
| - | ==== základní | + | ==== Základní |
| * nastavit základní info o projektu | * nastavit základní info o projektu | ||
| Řádek 39: | Řádek 39: | ||
| < | < | ||
| - | OUTPUT_DIRECTORY = " | + | OUTPUT_DIRECTORY |
| </ | </ | ||
| Řádek 49: | Řádek 49: | ||
| * vybrat si výstupní formát HTML, tex, xml, ... | * vybrat si výstupní formát HTML, tex, xml, ... | ||
| - | ==== syntax ve zdrojovém kódu ==== | + | |
| + | ==== Doxygen komentáře zdrojových kódů | ||
| * aby se vygenerovala dokumentace k souboru, musí obsahovat doxygen hlavičku (nebo v cfg zapnout volbu extractall0 | * 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í: | * komentáře na které má doxygen reagovat se identifikují pomocí: | ||
| - | * buď %%/ | + | * %%/ |
| - | * funguje i %%/*!%% (doporučeno od vedoucího DP) | + | * %%/*!%% - víceřádkový, Qt styl |
| - | * všechny následující parametry se používají právě uvnitř tohoto komentáře | + | * %%///%% - jednořádkový |
| + | * %%//!%% - jednořádkový | ||
| + | |||
| + | === Hlavička === | ||
| - | === hlavička === | ||
| * na začátku zdrojáku lze specifikovat uvnitř komentáře následující klíčové slova | * 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ě) | * (lze psát \slovo (doporučeno vedoucím DP) i @slovo používané v javě) | ||
| Řádek 78: | Řádek 81: | ||
| </ | </ | ||
| - | === funkce | + | === Funkce |
| * @brief Description of the function | * @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 | * @brief directive, leave a blank line and add a detailed description of what the function does. Also add the following optional | ||
| Řádek 95: | Řádek 98: | ||
| </ | </ | ||
| - | === proměnné a struktury === | + | === Proměnné a struktury |
| + | |||
| + | ==== Main page ==== | ||
| + | * kromě automaticky generované dokumentace podporuje doxygen i extra dokumentaci přes .dox soubory | ||
doxygen.1469192758.txt.gz · Poslední úprava: (upraveno mimo DokuWiki)