Comment puis-je réduire le nombre de changements entre les révisions avec la nouvelle sortie doxygen?

Question

Un dépôt subversion contient le html, le latex et les répertoires de l'homme qui doxygen génère à partir du code source. Même pour les petits changements de code source, de nouveaux fichiers sont générés avec des noms aléatoires qui fait pour les grands changements dans le système de contrôle de version.

Est il y a moyen de contourner cela? Comment puis-je réduire les changesets entre révisions tout en incluant la documentation générée doxygen-? Sinon, comment pourrais-je trouver des fichiers qui genrated doxygen-ne sont plus utilisés et doivent être supprimés?

Answer 1

Je déteste répondre à une question sans fournir une réponse à la question spécifique, mais son généralement une mauvaise idée à la piste doxygen docs dans votre référentiel. La même chose est vraie pour autoconf généré des scripts de configuration.

Si vous êtes inquiet au sujet des gens ne pas pouvoir produire les documents en raison d'un manque de doxygen, de son mieux pour les accueillir dans leur propre prise en pension privée dans votre langue et les paramètres régionaux de choix.

Vous pouvez modifier les scripts de construction pour le faire pour , avec un effort pas trop. Dans mon expérience après avoir travaillé sur le logiciel libre / open source pour un certain nombre d'années, ceux qui se soucient vraiment de la documentation sera en mesure de les générer .. mais votre kilométrage peut varier.

L'élimination de la fusion redondante des conflits (à savoir Joe a changé les commentaires les docs et doit maintenant fusionner les deux) à mon humble avis justifie externalisant les documents générés.