Komentare

Kazda trieda musi obsahovat dokumentaciu popisanu pomocou doxygen. Pozor ale na zbytocne pisanie dokumentacie. Napriklad nema vyznam pisat popis atributov funkcie, kde je v popise atributu iba nazov. Interne triedy, ktore nie su sucastou interface su komentovane v sekciach pomocou INTERNAL

/// @cond INTERNAL
/**
 * Internal data holder.
 */
class DataProperty
{
public:
        /// Constructor sets reference counter to zero
        DataProperty();

        /// reference counter (how many times classes references to this shared structure)
        int mRefCount;

        /// command to be exeuted, when accessing property - do not delete in this class!
        Command *mCommand;
};

DataProperty::DataProperty()
{
        mRefCount = 0;
        mCommand = 0;
}

/// @endcond INTERNAL

Dokumentácia

   /**
    * @brief strucny popis funkcionality
    * @param popis vstupno-vystupnych parametrov
    * @return popis navratovych hodnot
    * @note poznamka
    * @warning upozornenie na dolezitu funkcionalitu alebo mozny problem
    * @sa link na aktulanu funckiu v danom subore- funkcie sa oddeluju ciarkou
    * @link link na funkciu v inom hlavickovom subore je potrebne zadat Trieda::Funkcia()
    * @list - zobrazenie listu
    *    @li - prvov listu
    *    @li - druhy prvok listu
   */