Komentare – C / C++ – Fórum – Programujte.com

Zdravim,
uz delsi dobu se potykam s problemy, tykajici se celkove prehlednosti zdrojoveho kodu a jedine co mi stale dela problemy, jsou komentare. Naucil jsem se sice komentovat ruzne neprehledne a na prvni pohled nesrozumitelne kousky kodu, ale lamu si hlavu, jak psat "popisky" k funkcim. Vim, ze spravne by identifikator fce mel vypovidat o vlastnostech, ale nekdy mi holt dojde zasoba a vymyslim nazvy, ktere mohou ostatni mast...

Docela jsem si oblibil v php zpusob komentovani pomoci phpDocumentoru (http://www.phpdoc.org/), ale nevim jestli se to da primo aplikovat na Cecko. Navic bych chtel pouzivat neco, co je osvedcene a pouziva to i spousta jinych Ceckovych programatoru.

Budu rad, kdyz se se mnou podelite, jak to mate vyresene vy :). Obzvlast by me zajimal nazor jiz zabehnutych programatoru.

Sice nejsem zaběhlý programátor, ale co se týče komentářů, tak využívám cppdoc http://www.cppdoc.com.

To nickjartin : nemyslel jsem to takto, samozrejme jsem rad za jakykoliv nazor k tematu...

jak se tak divam, je to v podstate to same jako phpDocumentor...urcite se na to podivam, diky... :)

Vo svete c/c++ sa najviac používa doxygen (http://www.stack.nl/~dimitri/doxygen/).

To AdamHlavatovic : diky, ma to zajimave featury a hlavne je to pouzitelne pro vice jazyku, takze asi se uchylim k pouzivani doxygen...

kdyby jeste nekdo mel tipy na dalsi "documentory", budu rad kdyz se podelite, abych mohl srovnavat a vybrat si ten nejvhodnejsi...