Системы документирования кода си

Anna74

Интересует кто пользовался или представляет, поделитесь опытом/советами.
Интересует спец.комментарии в файлах на си скажем пишем, через что-то подобное LaTeX пропускаем,
получаем описание. Как texinfo может ещё какие системы, поделитесь опытом. Как там дела обстоят, если исходный си файл не один.
А то если писать документацию отдельно, то есть вероятность что-то потом забыть исправить и т.д. А комментарии пишем и меняем одновременно с изменением кода.
Или всё-таки забить, и документацию отдельно писать?

vall

Doxygen?

psm-home

Ну вот есть doxygen, например.
Upd: Гы, опоздал. :grin:

Fmouse

Ещё doc++
ЗЫ топикстартеру стыд и позор

Anna74

Спасибо за hints и советы. Набрёл вот благодаря вам на
http://en.wikipedia.org/wiki/Comparison_of_documentation_gen...
На самом деле комменты сейчас пишутся "с уклоном" в doxygen и по наследству досталось и просто надо, не всегда правда последовательно и реально через него не пропускаю и документацию не генерю.

Может кто пользовался тем или другим, или просто обязаловка была, поделитесь впечатлениями если какие странности/неочевидности, тонкости там всякие. Может кто сравнивал для пробы и не только разные системы документирования. Поделитесь любыми впечатлениями если не лень писать об этом сюда и время есть.

slonishka

мне вот кажется, что ничего более сложного, чем LXR не нужно.

если, конечно, это потом программисты будут читать.

Оставить комментарий