генератор документации в HTML-формате из комментариев

Вопросы использования сторонних (не входящих в состав FPC и Lazarus) утилит и библиотек.

Модератор: Модераторы

генератор документации в HTML-формате из комментариев

Сообщение Bohdan » 02.10.2008 12:52:38

Посоветуйте хороший генератор документации в HTML-формате из комментариев исходногом коде.
Знаю только Javadoc и XHelpGen (KOL).
Может сейчас есть что то новое, хорошее?
Bohdan
новенький
 
Сообщения: 87
Зарегистрирован: 11.05.2005 11:31:46
Откуда: Ukraine, Kyiv

Re: генератор документации в HTML-формате из комментариев

Сообщение ev » 02.10.2008 14:31:16

кроме форума тут есть еще сайт со статьями и книгами ;)
вот одна из статей Автодокументация исходников посредством PasDoc
ev
долгожитель
 
Сообщения: 1763
Зарегистрирован: 27.04.2005 23:19:06
Откуда: Москва

Re: генератор документации в HTML-формате из комментариев

Сообщение Bohdan » 02.10.2008 15:03:40

Спасибо, прочитал. Приятно, что есть такие статьи на данном сайте :D

Как я понял PasDoc основан на принципах Javadoc (т.е. синтаксис аналогичный)
Т.е. стандарт Javadoc стал общепринятым стандартом?

Я не просто хочу поюзать какой либо help-генератор, а сделать свой, для определенных целей.
Поэтому было бы интересно узнать еще о других движках :)
Bohdan
новенький
 
Сообщения: 87
Зарегистрирован: 11.05.2005 11:31:46
Откуда: Ukraine, Kyiv

Re: генератор документации в HTML-формате из комментариев

Сообщение bw » 27.11.2008 21:00:54

В Python я использую epydoc, а вот для Pascal такое понадобилось впервые отчего и натолкнулся на эту тему :-).

..bw
Аватара пользователя
bw
постоялец
 
Сообщения: 359
Зарегистрирован: 01.12.2005 11:36:23
Откуда: Усть-Илимск

Re: генератор документации в HTML-формате из комментариев

Сообщение Иван Шихалев » 04.12.2008 16:14:47

Не из комментариев, но близко. В комплект FPC входит fpdoc. Там принципы другие - собственно по исходникам формируется скелет документации, а описания хранятся в отдельных XML-файлах.
Аватара пользователя
Иван Шихалев
энтузиаст
 
Сообщения: 1138
Зарегистрирован: 15.05.2006 11:26:13
Откуда: Екатеринбург


Вернуться в Сторонние средства

Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 8

Рейтинг@Mail.ru