Doxygen-1.4.1

Пакет Doxygen содержит систему документации для C++, C, Java, Objective-C, Corba IDL и для некоторых расширений PHP, C# и D. Он полезен для генерирования HTML документации и/или локальной документации из документированных исходных файлов. Так же есть поддержка для генерации вывода в RTF, PostScript, гиперссылочного PDF, сжатого HTML и Unix man страниц. Документация извлекается прямо из исходников.

Вы можете так же настроить Doxygen для извлечения структуры кода из недокументированных исходных текстов. Это очень полезно для быстрого нахождения вашего пути в больших дистрибутивах исходников. При использовании совместно с GraphViz, вы так же можете визуализировать зависимости между различными элементами при помощи включения графиков зависимостей, диаграмм наследственности и сотрудничества, которые генерируются автоматически.

Установим Doxygen запуском следующих команд:

rm src/unistd.h &&
./configure --prefix /usr --docdir /usr/share/doc &&
make

А теперь, как пользователь root:

make install

Если вы захотите сгенерировать и установить документацию, убедитесь, что установлены пакеты Python, TeX и Graphviz, затем замените следующими командами для make install команды выше:

make docs &&
make pdf &&
install -d -m755 /usr/share/doc/doxygen/src &&
install -m644 src/translator{,_adapter,_en}.h \
    /usr/share/doc/doxygen/src &&
install -m644 VERSION /usr/share/doc/doxygen &&
make install_docs

rm src/unistd.h: Есть ошибка в Flex-2.5.31, которая означает, что make использует этот файл вместо версии, установленной в системе. Удаление этого файла позволит собрать элементы GUI успешно.

--with-doxywizard: Используйте этот параметр, если у вас установлен Qt и вы хотите собрать GUI оболочку.

make docs: Эта команда соберет HTML документацию.

make pdf: Эта команда соберет PDF версию документации для Doxygen.

install ...: Эти команды установят некоторые файлы, требуемые для установки документации.

Замечание: Для документации на языках, отличных от английского, замените “_en” на код страны вашей локали.

make install_docs: Эта команда установит бинарники и документацию.