[int69h]

What tools are y'all using to generate docs? Before I developed a case of the glow butt about Apple STILL not releasing a Rage PRO driver, and wiping OSX and all of my projects in retaliation (stupid I know), I was using a version of HeaderDoc that I had coerced into semi-working with Obj-C. Rather than sink back into the evilness of PERL (what an awful language), I thought I'd see what y'all recommended. If nothing good exists, I might try and come up with a parser in ruby. If anyone else might be interested in such a tool, let me know.

Thanks,
Terry

[lindberg]

For Objective-C, I'm going to have to plug my own tool here -- AutoDoc. It's available from www.misckit.com.

It has a bit different type of markup then HeaderDoc/javadoc (I've been putting it out for well over two years, and it's an ObjC rewrite of someone else's perl version that existed for several years before that, so it invented its own markup). It can produce HTML, RTF, and PDFLaTeX documentation.

[int69h]

Your tool was just what I was looking for. I've set myself a shell script build phase to automatically generate linked html in the correct location of my framework. As soon as I can get PB to do automated OCUnit testing for me, my build environment will be complete.

Is there some sort of tag to designate preformatted text? All of my example code is getting messed up.

Terry

[lindberg]

Use the fixed-width markup !{ ... } for example code. It's not technically preformatted as it decides on the indentation for itself, but it should work fine.