HeaderDoc vs AutoDoc
HeaderDoc vs AutoDoc
- Subject: HeaderDoc vs AutoDoc
- From: Bertrand Mansion <email@hidden>
- Date: Fri, 24 May 2002 17:32:16 +0200
Hi all,
I would like some help for choosing between AutoDoc and HeaderDoc for source
documentation. I know a bit about AutoDoc and I find the resulting html
documentation well done but I don't really like the way comments have to be
written in the source:
- part in the .h and part in the .m file.
- between /*" and "*/ which is rather bad looking in the code.
- between the method declaration and the accolade which is confusing.
I would prefer a javaDoc type of comments, and HeaderDoc seems to accept
this type of comments. But it seems to be far more limited than AutoDoc. For
instance, does anyone know if it is possible to comment instance variables
in the class declaration ? Is it possible to group methods by functionality
like in AutoDoc ?
And my last question, does anyone know what tool is using Apple for the
Application Kit and the foundation documentation ?
Thanks in advance,
Bertrand Mansion
Mamasam
--------------------------------------------------------
* Browse cocoa-dev and macosx-dev mailing list archives:
http://cocoa.mamasam.com
* Submit your link:
http://cocoa.mamasam.com/links
--------------------------------------------------------
Wishlist:
http://www.amazon.co.uk/exec/obidos/registry/wishlist/026-0946207-2854852
_______________________________________________
cocoa-dev mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/cocoa-dev
Do not post admin requests to the list. They will be ignored.