Voir les contributions
1
Suggestions de nouvelles fonctionnalités / Proposer de générer un tagfile à la compilation
« le: Décembre 16, 2017, 05:22:49 pm »
Hello !
J'utilise et la SFML dans mes projets pour me faire un peu les dents, j'utilise aussi CMake et Doxygen pour mes projets, et en fouillant un peu, je suis tombé sur le mécanisme de tag file (cf https://www.stack.nl/~dimitri/doxygen/manual/external.html)
Du coup j'ai testé sur ma doc, et ça fonctionne : quand un type de la SFML est mentionné, dans ma doc, il est cliquable et mène à la documentation de la dite classe, générée lors de la compilation de la SFML.
J'ai du bidouiller le Doxyfile pour activer la génération et indiquer moi même le chemin du tag file.
Je trouverais ça sympa d'inclure une option (comme c'est déjà le cas pour la doc elle même) au CMakeLists.txt pour générer un tag file et eventuellement l'installer avec la doc ? Et peut-être d'ajouter des variables au module findSFML.cmake pour indiquer le dossier de la documentation installé le cas échéant et trouver le tag file ?
Ca permettrait de lier plus facilement les documentations des libraires utilisant CMake.
Ou peut-être que c'est trop accessoire ?
Merci de prendre le temps de considérer l'idée et bravo pour tout le boulot déjà fait !
J'utilise et la SFML dans mes projets pour me faire un peu les dents, j'utilise aussi CMake et Doxygen pour mes projets, et en fouillant un peu, je suis tombé sur le mécanisme de tag file (cf https://www.stack.nl/~dimitri/doxygen/manual/external.html)
Du coup j'ai testé sur ma doc, et ça fonctionne : quand un type de la SFML est mentionné, dans ma doc, il est cliquable et mène à la documentation de la dite classe, générée lors de la compilation de la SFML.
J'ai du bidouiller le Doxyfile pour activer la génération et indiquer moi même le chemin du tag file.
Je trouverais ça sympa d'inclure une option (comme c'est déjà le cas pour la doc elle même) au CMakeLists.txt pour générer un tag file et eventuellement l'installer avec la doc ? Et peut-être d'ajouter des variables au module findSFML.cmake pour indiquer le dossier de la documentation installé le cas échéant et trouver le tag file ?
Ca permettrait de lier plus facilement les documentations des libraires utilisant CMake.
Ou peut-être que c'est trop accessoire ?
Merci de prendre le temps de considérer l'idée et bravo pour tout le boulot déjà fait !