12 октября 2011 | Категория:

Выбор системы автодокументирования php-кода

Я тут озаботился документированием собственного кода (дада, говнокодер во мне умирает) и по этому поводу сижу, изучаю инструментарий. Собственно, с инструментарием бедновато – есть только phpDocumentor и Doxygen. И вот я таки не знаю, что же выбрать. С одной стороны phpDocumentor меня категорически не устраивает своим требованием коментировать каждую переменную класса отдельным комментарием минимум в 4 строки, превращая код в простыню из комментов, в то время как doxygen спокойно поддерживает однострочные комменты. С другой стороны phpDocumentor имеет нормальную графическую утилиту, в то время как Doxygen, насколько я понял, через графический интерфейс только конфигурируется, а вся работа через командную строку, что меня тоже не сильно устраивает. Вот и думаю, что же делать.

[upd] В результате, пощупав системы за жопу вживую, я выбрал Doxygen и всем советую. Не знаю, какой пиздабол писал те статьи, которые я читал, но в Doxygen отличная графическая оболочка и инсталлятор, а phpDoc глючит при установке и вообще пошел нахуй.

Один комментарий

Аватар

pilot114

2 мая 2013 в 14:13

Жжёшь =) Doxygen действительно по первому впечатлению лучше, попробую его.

Написать комментарий