Est-il possible de documenter configure.ac de sorte que doxygen puisse récupérer les commentaires incorporés et produire de la documentation pour les options, les variables, etc. dans les manuels générés?GNU autoconf, options de document avec doxygen?
Merci
Il y a contribué macros Autoconf pour Doxygen au Autoconf Archive. Incluez la macro DX_INIT_DOXYGEN dans configure.ac, puis automake créera des cibles telles que doxygen-doc pour générer divers sous-ensembles de la documentation.
Vous devriez commenter en utilisant Doxygen en utilisant des commentaires comme ##!, n'est-ce pas? Je ne pense pas que Doxygen soutient des commentaires comme ça, mais vous pouvez essayer de modifier Doxygen d'accepter des commentaires comme ça, alors vous pouvez document à l'aide des commandes Doxygen habituelles @var, @cond, etc.
Le La modification peut être difficile, mais vous pouvez essayer de modifier ce fichier commentcnv.l (à partir de @line 319). Peut-être que vous pouvez poster avec la liste de diffusion du développeur de projet.
En fait, la documentation python utilise un double hachage, peut-être que je peux tromper doxygen en traitant configure.ac comme un fichier python/Perl. Merci – Anycorn
merci, cependant je dois documenter configure.ac lui-même, plutôt que de produire des cibles doxygen * – Anycorn
Oh. Alors je ne sais pas, désolé. – ptomato