Generating docs for a project that uses the iOS5 UIAppearance API results in a lot of warnings. Specifically, every property declared of the form:
@property(nonatomic, etc) Type myAppearanceProperty UI_APPEARANCE_SELECTOR;
Generates a warning:
WARN | @propertyMyClass.UI_APPEARANCE_SELECTOR: Comment found in MyClass.h@55 and MyClass.h@59!
There was already an issue describing similar thing - seems like appledoc gets confused with property suffix attributes - but can't find it now. I'm marking this as known bug for the moment, until 3.0 is released (this behavior is supported there already).