Doxygen w / XCode y subversión Cuestiones

Question

esta guía de Apple para crear la documentación doxygen. Yo tenía necesidad de modificar el script para poner las variables en las cotizaciones para que cuando se analiza un directorio con espacios, que no lo trata como dos argumentos separados.

Dicho esto, Recientemente he pasado de utilizar la subversión en XCODE en lugar de utilizar el material de instantáneas, que tiene una historia notoria con corromper a sí mismo y la pérdida de su historia. Mi proceso para hacer tal era crear una subversión como la estructura de directorios para mi proyecto, compruebe que en SVN, a continuación, comprobar hora de salida desde el tronco.

Mi problema es que cuando se crea la documentación, no importa lo modifico mi archivo de configuración Doxygen (exclude_parameters, etc ...), la primera vez que se crea el docset de la documentación que está bien. La segunda vez que pasa por, tiene problemas tratando de copiar con el comando cp a mi directorio documentación de la biblioteca donde está instalado para XCODE de referencia.

He intentado añadir a los exclude_parameters .svn * * * .svn /. SVN * * /. SVN / * pero nada parece ayudar o afectar a la documentación. Hice un chmod en mi docset después de su instalación, y que resuelve el problema, pero en realidad es sólo enmascarar el hecho de que los directorios .svn todavía están presentes en la documentación.

pensé que tal vez la creación de una carpeta de acción puede hacer el truco, pero realmente no he metido un poco con guiones de manzana que mucho. Sería un truco, pero sin duda hacer el trabajo.

Para hacer esto bien, sin embargo, ¿alguien tiene una idea de cómo hacer esto con gracia (la forma correcta)?

Gracias!

Answer 1

No sé exactamente dónde es su problema, así que voy a tratar de describir cómo trabajo con SVN, doxygen y Xcode. He escrito un rel más completa guía de esta respuesta, pero por desgracia, es en francés.

En cuanto a los archivos de origen, mi estructura de directorios es plana: no hay código fuente está en las subcarpetas (este es el valor por defecto cuando se logra código con Xcode solamente). Mi Doxyfile contiene este ajuste:

RECURSIVE = NO

De esta manera, .svn directorios no se analizan por doxygen.

En cuanto a docsets, mi Doxyfile contiene los siguientes valores:

GENERATE_DOCSET        = YES
DOCSET_FEEDNAME        = "My wonderful Application"
DOCSET_BUNDLE_ID       = com.example.mywonderfulapp

y mi script es el siguiente:

# Where are doxygen and dot (assuming in my own Applications folder)
DOXYGEN_PATH=${HOME}/Applications/Doxygen.app/Contents/Resources
PATH=${DOXYGEN_PATH}:${PATH}
export PATH

# Doxygen documentation generation
doxygen || exit 1

# DOCSET generation
make -C html install || exit 1

# Open DOCSET in Xcode
DOCSET_PATH=Library/Developer/Shared/Documentation/DocSets
open $HOME/$DOCSET_PATH/fr.exemple.doxygentutorial.docset || exit 1

Con estos ajustes no tuve problemas como los que se describen.

Answer 2

No debe tener una estructura de directorios plana en su proyecto. ¿Qué pasa si usted quiere internacionalizar él?

La forma de evitar esos errores cp es añadir el paquete DocSet a la lista de archivos ignorados por SVN. Si se ignora que no es versionado y si no está versionado no hay archivos .svn para CP de que quejarse.

Estoy usando la línea de comandos cliente SVN así que tu caso es distinto, pero esto es lo que hice:

• En primer lugar, actualizar su copia de trabajo SVN para asegurarse de que está sincronizado con el repositorio.
• En segundo lugar, SVN eliminar el directorio DocSet desde el repositorio y comprometerse.
• En tercer lugar, la construcción del proyecto para generar un nuevo directorio DocSet (éste es versionado).
• Añadir a SVN ignorar y cometer
• svn status para asegurarse de que todo está bien. Ahora debería ser capaz de trabajar sin problemas.

Me pasé un par de horas calcular esto, pero ahora puedo construir mi proyecto a voluntad, sin ser engañado por los falsos errores y tengo mi DocSet.