ПО для разработки документации

doxygen

> doxygen

В чем заключаются преимущества этой системы?

И главный вопрос - что лучше - сразу набирать документацию в формате doxygen, или же можно сперва поработать с документацией в текстовом редакторе (OO, к примеру), а потом вставлять тэги doxygen?

Ты требования сформулируй, а то удобство и простота у каждого свои. Для кого-то это Word, для кого-то TeX. Я лично DocBook предпочитаю.

Требования несложные - простота в освоении, несколько форматов выхода - что есть почти у всех, как я понял. А так - чтобы было удобно.

doxygen это для разработчика, описание внутренней структуры, интерфейсов программирования итп. Для пользователя нечто из классики аля latex.

очевидно docbook + emacs..

cweb, web, noweb.