P9: Programovací jazyk C++: flexibilita a efektivita

Zhrnutie prednášky

Úvod prednášky tvoria organizačné poznámky k projektu a Jave a potom výklad nástroja Javadoc, ktorým majú študenti zdokumentovať svoje projekty. Javadoc komentáre začínajú znakmi /** a píšu sa ku každej triede a metóde. Stručne opisujú účel prvku a jeho parametre, môžu obsahovať HTML a odkazy na iné triedy či metódy (značky ako @link, @author, @version). Na projekte v Eclipse je predvedené generovanie HTML dokumentácie: kódovanie UTF-8, výstupný adresár a zoznam balíkov, pričom podbalíky sa uvádzajú zvlášť. Javadoc nezvláda AspectJ, preto stačí bežný komentár. Samotná téma C++ z názvu sa v tejto časti prepisu ešte neobjavila.

• - Dokumentácia projektu cez Javadoc je požadovaná, ale nemá byť rozsiahla.
• - Javadoc komentár sa začína /** a patrí ku každej triede a metóde.
• - Komentár má vystihnúť podstatu prvku a vysvetliť parametre metód.
• - Značky umožňujú odkazy na triedy a metódy, uvádzať autora a verziu.
• - Nástroj generuje HTML dokumentáciu; treba nastaviť kódovanie UTF-8, výstupný adresár a balíky.
• - Import balíka nezahŕňa jeho podbalíky, tie sa uvádzajú zvlášť.
• - Javadoc nezvláda AspectJ, pri aspektoch stačí bežný komentár.

Zhrnutie pripravené s pomocou AI z prepisu videa.