P9: Javadoc, anotácie a zopár ďalších vecí / P10: Programovací jazyk C++: flexibilita a efektivita

Zhrnutie prednášky

Prednáška je rozdelená na dve časti; prvá sa venuje Javadocu, anotáciám a zvyšným prvkom jazyka Java, druhá jazyku C++. Úvod tvoria organizačné poznámky k projektom, priebežným prezentáciám a odovzdávaniu verzií na GitHub. Hlavná časť vysvetľuje, prečo je vhodné komentovať triedy a metódy, a upozorňuje, že komentár môže časom zastarať, lebo ho nič nenúti meniť spolu s kódom. Javadoc komentáre (začínajúce dvoma hviezdičkami) nástroj vyzbiera a vygeneruje z nich dokumentáciu vo formáte Java API; možno v nich odkazovať na triedy a opisovať parametre metód. Generovanie sa ukazuje v menu Project a Generate Javadoc, pričom aspektovo orientované časti vyžadujú samostatný nástroj.

• - Komentár je ľudská stránka kódu a musí zostať aktuálny, lebo ho nič automaticky nekontroluje.
• - Javadoc komentár sa začína dvoma hviezdičkami a nástroj Javadoc ho vyzbiera do dokumentácie.
• - Signatúry tried, metód a atribútov nástroj vytiahne sám, ručne sa dopisuje len opis.
• - V komentároch možno odkazovať na iné triedy a opisovať parametre metód.
• - Dokumentácia sa generuje cez Project → Generate Javadoc a má rovnaký formát ako dokumentácia Java API.
• - Aspektovo orientovaný kód Javadoc nezvláda, na jeho dokumentáciu treba špeciálny nástroj.
• - Druhá časť prednášky predstaví črty jazyka C++ ako ukážku, že veci sa dajú robiť inak.

Zhrnutie pripravené s pomocou AI z prepisu videa.