tomaz/appledoc — Issue #158: Merging named groups, subclasses
Author: pixelglow
Created: 2011-12-13 03:28:09+00:00
State: open

Great tool -- love the use of Markdown and the results are much more Apple-like than the competition!

I've noticed that named groups are not merged together. For example

/** @name one */
/** @name two */
/** @name one */

creates three named groups (one, two, one), instead of merging the two groups named "one" together.

Merging named groups would be particularly useful when our header method layout is different from the documentation layout we want. In particular, I like to put all properties first and then all methods in the headers, but I want to combine properties and methods from the same named group together. It's not possible to do this in the current version.

Also the names do not carry over from a subclass e.g.

@interface A
/** @name one */
- (void)methodA;
@end

@interface B
/** @name two */
- (void)methodB
@end

methodA is put into it's own "Other Methods" group in B's documentation.