First of all you’ll need to get the OS X version of Doxygen from doxygen.org. Doxygen comes in a dmg image. Just copy the Doxygen application into your Application folder.

Further create a folder called Documentation inside your XCode project. All generated documentation will be created in this folder.

Now run Doxygen and set it up for your XCode project.

1. In Doxygen use the Wizard to set up your project:
2. In the first tab of the wizard, set up your projects name and version. Further set the source code destination directory as shown in the screenshot (remember to create the Documentation directory before). Enter the directories manually, since using the Select dialog will result in absolut paths. Relative paths allow us to move the project later without reference problems.:
3. The second tab (Mode) allows you to define wich output entities will appear. Select to also include undocumented entities. C++ is fine for language optimization :
4. The Output tab allows you to specify which output formats shall be generated. Make sure to check HTML with frames and navigation tree. Afterwards press OK to close the wizard. Configuring the Diagrams tab is optional:
5. As the second step in Doxygen save the configuration as file Doxyfile in your project folder and you’re done. Step 6 & 7 are optional and not required, as they will be performed automatically from within XCode. But you may perform them to test your configuration.
6. Set the location of you project directory in step 3.
7. Step 4: press “Start” and the generation shall begin. Afterwards check the Documentation directory in your project. A folder named html has been created inside it. Check the documentation by opening the index.html file. Congrats!

Now on to setting up XCode to automatically execute Doxygen on build.

1. Open your XCode project.
2. Add a new build phase (Script Build Phase) to your projects target:
3. Enter “/Applications/Doxygen.app/Contents/Resources/doxygen Doxyfile” as the Shell command:

On your next project build, the documentation shall be created. Try!
But wouldn’t it be nice to access that documentation from within XCode? So let’s set this up next.

1. Right click your project and add a new Group. Call this group “Documentation”
2. To that group add an “Existing File” and choose the index.html in your projects Documentation/html folder (Did you compile yet? You’ll need to, to have the folder and file created ). Don’t copy item to destination groups folder and set reference type relative to project.
3. Finally you’ll have to tell XCode that this is no regular html source file. Do this by setting its file type to “text.html.documentation”. Now the file should be opened in XCodes HTML viewer. If not, check your file type settings in XCodes preferences.

Now everything should be set up for you to create great source code documentation!! Now all you need to do is document your source code. I’ll post about this later, but to get you started check out http://www.stack.nl/~dimitri/doxygen/docblocks.html for a brief introduction. Everybody who ever used javadoc shall find himself comfortable instantly.

Fangen wir mal mit den befreundeten Bloggern an (hallo allerseits! ):

• poetsch.org: Gernot’s Blog. Haben zusammen in Dresden studiert und stehen immer noch in Kontakt wenn er mal nach Dresden kommt, oder Ich mal Hilfe in Objective-C brauche
  sLandArt: Stefan und sein Diplom. Viele schöne Bilder aus Istambul Istanbul!
  blauwunder: Dresdner Freunde, bei denen ich mir nicht sicher bin, ob die Pseudonyme aufgedeckt werden dürfen Hauptsächlich gehts hier um Musik und Lebenskultur. Seht selbst!
  Netzküssen: Anne, eine gute Freundin von mir, macht Fotos für Euch. Die passende Musik dazu kommt von anderen.

Weiter gehts mit Podcasts. Meist Musik, oft Geschwafel und vereinzelt auch Video:

• DSC: Der gute alte Daily Sourcecode… Die Mutter aller Podcasts vom Vater aller Podcasts – Mr. Adam Curry. Fuck you!
  TikiBar TV: Guter Schnaps mit guten (äußerst unterhaltsame) Stories. Cocktailrezepte von und mit Dr. Tiki, Jonny Jonny und Lala.
  Wahnzeit: Sebastian is ein netter Kerl und kommentiert hier Gott und die Welt. Nette Musik von Ernesto Sett und allerlei Absurditäten aus unser aller Alltag.
  SE Radio: Software Engineering Radio, was der Name schon sagt. Interviews, Tipps, Best Practices und mehr zum Thema Software Design, Pattern und anderen Belangen des Softwaretechnikers. Sehr empfehlenswert für alle Software Ingenieure und die die es werden wollen.
  Cocoacast: Auch hier ein sehr Empfehlenswerter Videocast, diesmal zum Thema Cocoa & Objective-C (also Programmieren auf und für Mac OS X). Lehnt sich anfangs thematisch am Hillegass Buch an und geht nun weit darüber hinaus.
  …die letzten will ich nur kurz nennen: RoRcast, Grailscast

Jetz wirds noch geekier… Meine IT feeds:

• fscklog: Das Fscklog ist meine Hauptquelle für alles was so in der Welt von Mac und iPod und darüber hinaus passiert. Täglich top aktuell.
  techCrunch: Am Puls des Web. TechCrunch stellt neue Webprojekte vor. Dokumentiert den Aufstieg, Werdegang und Fall von Web2.0 Firmen.
  Theocacao: Noch ein Mac Entwickler Blog. Interessante Artikel und spannende Anleitungen. Reinlesen

Und last but not least:

• banq: Banq hat jetzt auch nen Feed, der die aktuelle Termine für Dresden listet. Hatte selbst mal die Seite geparst um nen Feed zu erstellen, ist jetzt aber überflüssig. Vielleicht werd ich den feed mal filtern, um nur die Termine von heute anzuzeigen. Manchmal nervt es nämlich immer alle Termine zu sehen und bei neu eingefügten Terminen alle nachfolgenden als ungelesen im netvibes zu sehen.. Aber mal schaun.

So, nun seit Ihr dran. Was denkt Ihr, was ich denn unbedingt noch abonnieren sollte? Ist euer Blog lesenswert?