Does appledoc support Doxygen-style groups

[Steve Wehba]

In Objective-C header files, I commonly organize methods into Doxygen-style groups using syntax like the following:

@interface MyClass : NSObject

//! @name Initializers

//! {

- (id)init;

- (id)initWithString:(NSString *)s;

//! }

Doxygen picks these up just fine, but appledoc seems to ignore them.

Does appledoc, in fact, support Doxygen-style groups? Does it not support the syntax I'm using? Anyone have any experience with groups in appledoc? 

 

 

 

 

 

 

[lowell]

Hm. @mattt's AFNetworking uses @name for method organization and it seems to work fine:

Header:

https://github.com/AFNetworking/AFNetworking/blob/master/AFNetworking/AFHTTPSessionManager.h

Output:

http://cocoadocs.org/docsets/AFNetworking/2.0.1/Classes/AFHTTPSessionManager.html

Take a look at how the headers are formatted in that project for a guide. appledoc used to have in-depth documentation on the main site, but it appears to go be going through an overhaul at the moment, so looking at projects like AFNetworking (along with appledoc's sources) are the best we've got as far as examples go. For now.

> --
> You received this message because you are subscribed to the Google Groups "appledoc" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to appledoc+u...@googlegroups.com.
> To post to this group, send email to appl...@googlegroups.com.
> Visit this group at http://groups.google.com/group/appledoc.
> For more options, visit https://groups.google.com/groups/opt_out.

[Tom @ Gentle Bytes]

Hi Steve!

Appledoc supports @name (it treats all methods and properties members of previous group, until next @name or end of interface). Try using /// or /** instead of //!.

Tom

--