Articles of doxygen

¿Cómo escribir AssemblyVersion en un file usando MSBuild?

FinalEdit: A pesar de que los directorys relativos no funcionan en la primera publicación, funcionó si simplemente $(MsBuildThisFileDirectory) de la línea Exec . Edit2: agregué los nuevos objectives a los DefaultTargets . Que ahora los ejecuta por defecto. Sin embargo, el cronometraje ahora estaba desactivado con el command postbuild. <Exec Command="call $(MsBuildThisFileDirectory)documentation\tools\GenerateDocumentation.bat" IgnoreExitCode="false" /> al […]

Usando git con Doxygen FILE_VERSION_FILTER

¿Qué command se usaría con git para el file FILE_VERSION_FILTER ? La salida sería preferiblemente la cantidad de veces que ese file fue revisado en el repository.

Doxygen w / XCode y problemas de subversión

Seguí esta guía de Apple para crear documentation doxygen. Necesité modificar el script para poner las variables entre comillas, de modo que cuando analiza un directory con espacios, no lo trata como dos arguments separados. Dicho esto, hace poco cambié para usar subversión en XCODE en lugar de utilizar Snapshot, que tiene una historia notoria […]

Integrar Trac + SVN con Doxygen

Conozco el plugin Trac Doxygen. Permite vincular los documentos de Doxygen desde la wiki de Trac. Estoy buscando algo que me ayude a automatizar la documentation. Dado que el proyecto es enorme, probablemente no sea posible actualizar la documentation en cada confirmación, especialmente dado que Doxygen no realiza comstackciones incrementales de documentation. En cambio, una […]

La palabra key SVN se muestra en doxygen

Estoy usando palabras key de svn ($ Author $, …) en mi proyecto. También estoy usando comentarios doxygen para mejorar mi documentation. La combinación de ambos me está causando algunos problemas. Ejemplo simplificado: /** * @author $Author$ */ @author es la palabra key doxygen y $ Author $ es la palabra key svn. Mi resultado […]

Doxygen / AppleDoc y Jenkins con Objective-C: ¿dónde debería funcionar la salida Doxygen / AppleDoc?

Actualmente nuestro equipo está utilizando un repository SVN para administrar nuestro código en el Servidor A, y los cambios en este repository desencadenan comstackciones a través de Jenkins para que se inicien en el Servidor B (así el server B tiene un espacio de trabajo que refleja el repository en el Servidor A). Ahora, deseamos […]

Incluir documentation doxygen en el repository SVN

¿Es una buena práctica include y comprometer la documentation HTML de Doxygen para mi proyecto en el repository SVN?

Incluir posts de logging SVN en Doxygen

¿Hay alguna forma de configurar Doxygen para include el logging de SVN para un file como parte de la salida? Básicamente ingresamos posts de logging bastante rigurosos en SVN cuando realizamos commits, y me gustaría que esos posts tengan una sección dentro de la salida de Doxygen.

¿Cómo minimizo el número de cambios entre revisiones con una nueva salida de doxígeno?

Un repository de subversión contiene los directorys 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 files 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 […]

¿Debería la documentation generada entrar en control de fuente?

Últimamente (finalmente) he estado documentando uno de mis proyectos de código abierto. El proyecto es una biblioteca de classs para .Net. Estoy usando Doxygen para generar documentation HTML a partir del código fuente. Ahora, mi pregunta es si debo almacenar los files HTML que Doxygen produce en mi control de fuente.