¿Cómo minimizo el número de cambios entre las revisiones con una nueva salida de doxygen?

Question

Un repositorio de subversión contiene los directorios html, latex y man que doxygen genera a partir del código fuente. Incluso para pequeños cambios en el código fuente, se generan nuevos archivos con nombres aleatorios, lo que genera grandes cambios en el sistema de control de versiones.

¿Hay alguna forma de evitar esto? ¿Cómo puedo minimizar los conjuntos de cambios entre revisiones mientras sigo incluyendo la documentación generada por doxygen? Alternativamente, ¿cómo puedo encontrar cuál de los archivos genéricos de doxígeno ya no se usa y debería eliminarse?

Answer 1

Odio responder una pregunta sin proporcionar una respuesta a la pregunta específica, pero en general es una mala idea seguir los documentos doxygen en su repositorio. Lo mismo ocurre con las secuencias de comandos de configuración generadas de forma automática.

Si le preocupa que las personas no puedan generar los documentos debido a la falta de doxygen, es mejor alojarlos en su repositorio privado en su idioma y configuración regional de su elección.

Puede modificar los scripts de construcción para hacer esto para, sin demasiado esfuerzo. En mi experiencia después de trabajar en software de código abierto/libre durante varios años, aquellos que realmente se preocupan por los documentos podrán generarlos ... pero su rendimiento puede variar.

La eliminación de conflictos de fusión redundantes (es decir, Joe cambiaron los comentarios Y los documentos y ahora tiene que fusionar ambos) En mi humilde opinión justifica exteriorizando los documentos generados.