Komentarze Opcje

[Bora]

Często spoykam sie z dokumentacją w stylu :

  /**
    * This tells Smarty whether or not to use sub dirs in the cache/ and
    * templates_c/ directories. sub directories better organized, but
    * may not work well with php safe mode enabled.
    *
    * @var boolean
    *
    */

Zbyt często jest ona podobnej składni czyli wydaje mi sie że jest to efekt jakiegoś dodatku lub edytora. Wydaje mi sie dość ciekawe dlatego pytam jak z tego korzystac i co oferuje takie funkcje??

[Seth]

To sa specjalne komentarze do phpDoca. Ogolnie rzecz ujmujac phpDoc jest skryptem parsujacym te komentarze do postaci gotowej dokumentacji (w roznych formatach).

Wiecej: http://phpdoc.org/

[Bora]

Ciekawe a czy jakieś edytory wspomagają takie pisanie (IMG:http://forum.php.pl/style_emoticons/default/questionmark.gif) np pluginy.
Czy trzeba za każdym razem to pisać ręcznie (IMG:http://forum.php.pl/style_emoticons/default/questionmark.gif) ?

[spenalzo]

Ja pisze ręcznie i musze przyznać, że weszło mi to w nawyk, i jak zapomne dodać komentarz to coś dziwnie mi wygląda (IMG:http://forum.php.pl/style_emoticons/default/winksmiley.jpg) (IMG:http://forum.php.pl/style_emoticons/default/biggrin.gif)

[Bora]

Zend ma w pewnym stopniu wstawianie komentaży ale jakoś mi nie odchodzi ten program może ktoś zaproponuje inny (IMG:http://forum.php.pl/style_emoticons/default/questionmark.gif)