Au-delà de Linux® From Scratch (édition System V) - Version r12.4-444-wip

Chapitre 13. Programmation

Doxygen-1.15.0

Introduction à Doxygen

Le paquet Doxygen contient un système de documentation pour C++, C, Java, C objet, Corba IDL et certaines extensions PHP, C# et D. C'est utile pour la génération de documentation HTML ou de manuel de référence hors ligne à partir d'un ensemble de fichiers sources documentés. Il y a aussi un support pour générer une sortie RTF, PostScript, des PDF avec hyperliens, du HTML compressé, et des pages de manuel Unix. La documentation est extraite directement des sources ce qui rend beaucoup plus facile la conservation de la cohérence de la documentation avec le code source.

Vous pouvez aussi configurer Doxygen pour extraire la structure du code des fichiers sources non documentés. C'est très utile pour vous y retrouver rapidement dans les sources de grosses distributions. Utilisé avec Graphviz, vous pouvez aussi visualiser les relations entre les divers éléments à l'aide de graphes de dépendance d'inclusion, diagrammes d'héritage, et des diagrammes de collaborations tous générés automatiquement.

[Note]

Note

Les versions de développement de BLFS peuvent ne pas arriver à contruire ou à exécuter certains paquets correctement si LFS ou des dépendances ont été mises à jour depuis la dernière version stable des livres.

Informations sur le paquet

  • Téléchargement (HTTP) : https://doxygen.nl/files/doxygen-1.15.0.src.tar.gz

  • Téléchargement (FTP) :

  • Somme de contrôle MD5 du téléchargement : 69de0f41eb65c8238642d4b81312f843

  • Taille du téléchargement : 8,8 Mo

  • Estimation de l'espace disque requis : 256 Mo (avec les tests)

  • Estimation du temps de construction : 1,3 SBU (avec les tests, tous deux avec parallélisme = 4)

Dépendances de Doxygen

Requises

CMake-4.1.2 et git-2.51.2

Recommandées

Qt-6.10.0 (pour doxywizard)

Facultatives

sGraphviz-14.0.2, ghostscript-10.06.0, libxml2-2.15.1 (requis pour les test), LLVM-21.1.2 (avec clang), texlive-20250308 (ou install-tl-unx), xapian-1.4.29 (pour doxyindexer) et javacc

Installation de Doxygen

Tout d'abord, corrigez certains scripts python : 

grep -rl '^#!.*python$' | xargs sed -i '1s/python/&3/'

Installez Doxygen en exécutant les commandes suivantes : 

mkdir -v build &&
cd       build &&

cmake -G "Unix Makefiles"          \
      -D CMAKE_BUILD_TYPE=Release  \
      -D CMAKE_INSTALL_PREFIX=/usr \
      -D build_wizard=ON           \
      -D force_qt=Qt6              \
      -W no-dev .. &&
make

Pour tester les résultats, exécutez : make tests. Un test, 012_cite.dox, est connu pour échouer si vous n'avez installé ni texlive-20250308 ni install-tl-unx.

Si vous préférez générer la documentation du paquet, vous devez avoir Python, TeX Live (pour la doc HTML) et Ghostscript (pour la doc PDS) installés, puis entrer les commandes suivantes : 

cmake  -D build_doc=ON \
       -D DOC_INSTALL_DIR=share/doc/doxygen-1.15.0 \
       .. &&
make docs

Maintenant, en tant qu'utilisateur root : 

make install &&
install -vm644 ../doc/*.1 /usr/share/man/man1

Si vous avez généré la documentation du paquet, alors les pages de manuel sont installées automatiquement et vous n'avez pas à lancer la dernière commande install ….

Explication des commandes

-D build_wizard=OFF : utilisez ce paramètre si Qt6 n'est pas installé.

-D build_search=ON : Utilisez ce paramètre si xapian est installé et que vous souhaitez construire les outils de recherche externes (doxysearch.cgi et doxyindexer).

-D force_qt6=ON :: Utilisez ce paramètre pour construire doxywizard avec Qt6 même si Qt5 est installé.

-D use_libclang=ON : Utilisez ce paramètre si llvm est installé avec clang, pour ajouter le support pour l'analyse de libclang.

Configuration de Doxygen

Il n'y a pas réellement de configuration nécessaire pour le paquet Doxygen bien que trois paquets supplémentaires sont requis si vous souhaitez utiliser les fonctionnalités étendues. Si vous exigez des formules pour créer de la documentation PDF, vous devez avoir installé texlive-20250308. Si vous demandez des formules pour convertir des fichiers PostScript en bitmap, vous devez avoir installé ghostscript-10.06.0.

Contenu

Programmes installés: doxygen et potentiellement, doxywizard, doxyindexer et doxysearch.cgi
Bibliothèques installées: Aucune
Répertoire installé: /usr/share/doc/doxygen-1.15.0

Descriptions courtes

doxygen

est un outil en ligne de commande utilisé pour générer des fichiers modèles de configuration puis pour générer de la documentation à partir de ces modèles. Utilisez doxygen --help pour une explication des paramètres de la ligne de commande

doxywizard

est un front-end graphique pour configurer et lancer doxygen

doxyindexer

génère un index de recherche appelé doxysearch.db à partir d'un ou plusieurs fichiers de données produits par doxygen. Voir par exemple https://javacc.github.io/javacc/

doxysearch.cgi

est un programme CGI pour chercher des données indexées par doxyindexer