ребят, кому интересно почитайте http://dust.habrahabr.ru/blog/18326/
здесь пару примеров вкратце рассказывают как и зачем правильно комментировать.
полный ман здесь http://manual.phpdoc.org/HTMLframesConverter/default/
*это касаемо php