Program v C++ (okomentování)

[bereline]

Zdravím, potřebuju radu, ví někdo/umí někdo okomentovat program, který jsem už naprogramoval ale ve stylu JavaDoc ? Mám program a mám zadáno, že ho mám okomentovat:"komentáře pro automatické generování dokumentace (ve stylu JavaDoc)". Vůbec nevím jak se to dělá, v čem se to dělá ... program jsem normálně komentoval "//.... .... ....", ale to není pravděpodobně dobře. Ví někdo jak na to ? Díky

[SM4JL]

Ahoj,
myslim, ze celkem slusne je to popsano treba v tomhle 3 dilnem serialu http://www.builder.cz/art/java/javadoc.html" onclick="window.open(this.href);return false;
Je to teda z roku 2001 a ja Javadoc nepouzivam, takze nevim, jestli tam nejsou nejake zasadni zmeny, ale myslim, ze ne.
Jinak mam pocit, ze v Netbeans je celkem pekna podpora pro psani tenhle komentaru.

[LifeRoma]

ahoj Martine.. ve Visualu je nehoře takové tlačítko, a to ti zakomentuje to, co máš označené...
Ty už nevíš co říkal pan Červenka?? Hlavně že si mu dal sedm stovek:)

[bereline]

Ahoj Romane, pochybuju, že to zakomentuje tak, jak to chce Kocyán aby z toho šel udělat dokument ...

//Zde je něco, co nám ukazoval ... upřímně, to vůbec nechápu

// Includes
#include <stdio.h>

// Jmenny prostor
namespace VSB {

/**
* @brief Trida student.
*
* V systemu zastupuju osobu studujici na skole VSB.
* Sem ovsem <b>NEPATRI</b> zamestnanci!
* <br />
*
*
* @author "Tom Kocyan"
* @version 1.0.0
*
* @link http://www.vsb.cz" onclick="window.open(this.href);return false; http://www.VSB.cz" onclick="window.open(this.href);return false;
*/
class Student : public Osoba {

public:

/**
* Vrati vek studenta
*
* @return Vek studenta
*/
const float getAge();

/**
* Nastavi jmeno studenta
*
* @param newAge Novy vek studenta
*/
void setAge(const float newAge);

/**
* Nastavi jmeno studenta
*
* @deprecated Tato metoda je nahrazena {@link #getAge}
* @param newAge Novy vek studenta
*/
void changeAge(const float newAge);

protected:
private:

// Vek studenta
float age;

};
}

#endif