Doxygen Dokumentation für C# unter Mac OS X erzeugen

Ein Quelltext wird während der Entwicklung gewöhnlich kommentiert. Unter C# bzw. .NET gibt es dafür Kommentare nach einem bestimmen Schema. Über einer Methode könnte ein solcher Kommentar z.B. aussehen:

/// <summary>
/// Distance between a and b.
/// </summary>
/// <param name="a">The first vector.</param>
/// <param name="b">The second vector.</param>

Diese Kommentare kann die freie Software Doxygen auswerten und daraus eine Dokumentation erzeugen. Im Gegensatz zu anderen Lösungen wie Sandcastle ist Doxygen betriebsystemübergreifend verfügbar und kann somit – wie in diesem Beispiel – unter Mac OS X genutzt werden. Im ersten Schritt sollte Doxygen installiert werden. Unter Mac OS X kann dies einfach über MacPorts geschehen:

sudo port install doxygen

Nachdem Doxygen installiert ist, sucht man im Terminal den Ordner des Entwicklungsprojektes heraus und gibt dort ein:

doxygen -g projektname.doxygen

Damit wird eine Standard-Doxygen-Konfiguration erzeugt. In dieser Datei werden nun ein paar Änderungen vorgenommen:

PROJECT_NAME = "Testprojekt"
PROJECT_NUMBER = "Release Candidate 1"
OUTPUT_DIRECTORY = docs
RECURSIVE  = YES

Über den Aufruf:

doxygen projektname.doxygen

kann nun die HTML-Dokumentation des Quelltextes erzeugt erzeugt werden und diese anschließend im Browser genutzt werden.

Keychain von anderem Mac einbinden

Wenn man von einem Mac zu einem anderen Mac umzieht, kann es vorkommen das bestimmte Passwörter sich noch in der Keychain des alten Mac befinden. Möchte man diese Passwörter übernehmen, so muss man die alte Keychain mit Hilfe der Schlüsselbundverwaltung einbinden.

Die Schlüsselbundverwaltung unter Mac OS X

Die Schlüsselbundverwaltung unter Mac OS X

Die Keychain befindet sich dabei im Pfad /Users/username/Library/Keychains/. Dort ist unter anderem eine Datei mit dem Namen login.keychain zu finden. In der Schlüsselbundverwaltung kann man diese keychain-Datei über den Menüpunkt Schlüsselbund hinzufügen laden. Die gewünschten Passwörter können nun in den Standardschlüsselbund des neuen Macs überführt werden. Zu berücksichtigen ist hierbei, das für jeden Datensatz das Passwort der eingebundenen Keychain eingegeben werden.

F10, der Midnight Commander und Mac OS X

Der freie Norton Commander Clone Midnight Commander wird wie sein Vorbild mit der F10-Taste beendet. Bei einem frisch installierten Mac OS X führt diese Taste leider zu Problemen, da das Programmfenster nur verkleinert wird.

Die Mission Control Einstellungen

Die Mission Control Einstellungen

Grund hierfür sind die Mission Control-Einstellungen. Hier ist die Taste F10 für die Eigenschaft Programmfenster vorgesehen. Wenn man diesen Tastenkombination anderes belegt oder deaktiviert, kann man F10 im Midnight Commander wieder ohne Probleme nutzen. Alternativ kann die Escape-Taste und anschließend die Taste 0 gedrückt werden – dies hat die gleiche Wirkung wie die F10-Taste.

Adium Konfiguration zu anderem Mac übernehmen

Bei Adium handelt es sich um einen freien Multi-Protokoll-Messenger für Mac OS X. Möchte man die Konfiguration von Adium zu einem anderem Mac übernehmen, so muss das Verzeichnis:

/Users/username/Library/Application Support/Adium 2.0

auf den anderen Mac übertragen werden. Anschließend kann Adium auf dem anderen Mac gestartet werden. Passwörter müssen allerdings neu eingegeben werden – auch Zertifikatswarnungen müssen neu bestätigt werden. Adium selbst kann über die offizielle Seite bezogen werden.

Mac OS X installieren oder reparieren

Nach dem Mac OS X ab Lion ohne Datenträger vertrieben wird, hat sich auch die Neuinstallation bzw. die Reperatur etwas verändert. Diese erfolgt nun über das Rettungssystem von Mac OS X. Um dieses System zu starten muss während des Starts des Macs die Tastenkombination:

Command + R

gedrückt werden. Damit wird beim Start automatisch das Rettungssystem geladen. Wird ein Mac mit einer leeren oder neuen Festplatte gestartet so wird das Rettungssystem automatisch aus dem Internet heruntergeladen und anschließend gestartet. Im Rettungssystem kann nun unter anderem die Neuinstallation angestossen werden.