Doxygen w / XCode & Subversion Probleme

Question

Ich folgte diese Anleitung von Apple doxygen Dokumentation zu erstellen. Ich brauche das Skript zu ändern Variablen in Anführungszeichen zu setzen, so dass, wenn es ein Verzeichnis mit Leerzeichen analysiert, es behandelt nicht als zwei getrennte Argumente.

Das heißt, ich vor kurzem wechselte Subversion in XCODE zu verwenden, anstatt den Snapshot-Sachen zu verwenden, die eine berüchtigte Geschichte hat sich mit korrumpieren und Ihre Geschichte zu verlieren. Mein Prozess so zu tun, war eine Subversion wie Verzeichnisstruktur für mein Projekt zu erstellen, überprüfen Sie, ob in SVN, dann überprüfen Sie aus dem Kofferraum überprüfen.

Mein Problem ist, dass, wenn ich die Dokumentation zu erstellen, egal, wie ich meine doxygen config-Datei (exclude_parameters, etc ...) ändern, das erste Mal, dass die Dokumentation Nach der Dokumentation erstellt es ist in Ordnung. Das zweite Mal, es durchläuft, hat es Probleme versuchen, mit dem Befehl cp mein Bibliothek Dokumentationsverzeichnis zu kopieren, auf dem es installiert ist, für XCODE zu verweisen.

Ich habe versucht, indem auf die exclude_parameters .svn * .svn * * /. Svn * * /. Svn / *, aber nichts scheint in der Dokumentation zu helfen, oder zu beeinflussen. Ich habe ein chmod auf meiner Bird Dokumentation, nachdem es installiert ist, und das wird das Problem behoben, aber es ist wirklich Maskierung nur die Tatsache, dass die .svn Verzeichnisse in der Dokumentation noch vorhanden sind.

Ich dachte, vielleicht einen Ordner Aktion zu schaffen könnte den Trick tun, aber ich habe nicht wirklich um mit Apfel-Skripte, die viel durcheinander. Es wäre ein Hack, aber würde den Job zu erledigen sicher gehen.

Um dieses Recht zu tun, obwohl, hat jemand eine Idee, wie Sie diese anmutig (die richtige Art und Weise)?

Danke!

Answer 1

ich nicht genau wissen, wo Ihr Problem ist, also werde ich versuchen zu beschreiben, wie ich mit SVN, doxygen und Xcode arbeiten. Ich habe eine mehr komplette Anleitung als diese Antwort, aber leider ist es in französisch.

In Bezug auf Quelldateien, meine Projekt-Verzeichnisstruktur ist flach: kein Quellcode ist in Unterordner (dies ist die Standardeinstellung, wenn Sie Code mit Xcode verwalten nur). Meine Doxyfile enthält diese Einstellung:

RECURSIVE = NO

Auf diese Weise .svn Verzeichnisse werden nicht von doxygen analysiert.

In Bezug auf docsets, mein Doxyfile enthält folgende Einstellungen:

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

und mein Skript sieht wie folgt aus:

# 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

Mit diesen Einstellungen habe ich nicht Probleme auftreten wie die, die Sie beschreiben.

Answer 2

Sie sollten nicht eine flache Verzeichnisstruktur auf Ihrem Projekt haben. Was ist, wenn Sie es internationalisieren wollen?

Die Art und Weise, diese cp Fehler zu vermeiden, ist die Dokumentation Nach Paket in der Liste der Dateien, die von SVN ignoriert hinzuzufügen. Wenn es ignoriert werden ist es nicht versioniert und wenn es nicht versioniert ist es keine .svn-Dateien für cp zu bemängeln.

Ich bin mit der Befehlszeile SVN-Client so YMMV, aber hier ist das, was ich getan habe:

• Zuerst svn Ihre Arbeitskopie aktualisieren, um sicherzustellen, dass Sie mit dem Repository sind synchronisiert.
• Zweitens löschen svn das Verzeichnis Bird Dokumentation aus dem Repository und begehen.
• Drittens baut das Projekt ein neues Verzeichnis Bird Dokumentation zu erzeugen (dies ist unversionierte).
• Fügen Sie es zu SVN ignorieren und begehen
• svn status Sie sicher, dass alles in Ordnung zu machen. Sie sollten nun in der Lage sein, ohne Probleme zu arbeiten.

Ich verbrachte ein paar Stunden dieses heraus herauszufinden, aber jetzt kann ich mein Projekt bauen, ohne von diesen falschen Fehlern der Irre geführt werden, und ich habe meine Bird Dokumentation.