Re: Documentation generation
Re: Documentation generation
- Subject: Re: Documentation generation
- From: Dave DeLong <email@hidden>
- Date: Sun, 08 May 2011 07:11:35 -0600
AppleDoc produces Apple-like docsets:
https://github.com/tomaz/appledoc
Cheers,
Dave
Sent from my iPhone
On May 8, 2011, at 4:42 AM, Thomas Davie <email@hidden> wrote:
> Heya,
>
> I'm working on improving my CoreParse (http://www.github.com/beelsebob/CoreParse) framework by actually documenting it properly. The problem I'm hitting though is that either the two major documentation generators suck (doubt that, probably PEBKAC), or their default configuration sucks. I've had a go with both doxygen and headerdoc.
>
> Headerdoc seems to produce some reasonably clear and well organised output, but I can't find any way to configure the output to be a bit prettier.
>
> Doxygen seems to produce a pretty cluttered mess as output, with a bunch of stuff that I really don't want, but I've not found any good documentation on how to configure it to produce nicer output. The GUI tool seems to be a perfect example of how not to design a GUI wrapper for a command line tool. Perhaps the design skills involved in it hint at why I don't like the structure of it's output either.
>
> Does anyone know a good way to get clean, reasonably configurable html output for objective-c documentation? Ideally, I'd like something that just dumps out almost exactly the style apple use for their docs, without too much need to play about.
>
> Thanks
>
> Tom Davie_______________________________________________
>
> Cocoa-dev mailing list (email@hidden)
>
> Please do not post admin requests or moderator comments to the list.
> Contact the moderators at cocoa-dev-admins(at)lists.apple.com
>
> Help/Unsubscribe/Update your Subscription:
>
> This email sent to email@hidden
_______________________________________________
Cocoa-dev mailing list (email@hidden)
Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden