Как документировать встроенный протокол с помощью appledoc

Question

Я определил Objective-C @class, который определяет строку @protocol inline в заголовке перед @interface.

Я не могу получить appledoc для создания документов для протокола. Возможно ли это встраивание или должен ли протокол быть отдельным файлом?

Answer 1

Протокол не обязательно должен быть определен в отдельном файле заголовка. Я использую это сам в конструкции, как этот (тот же файл заголовка):

MyClass.h

/** The `MyClassDelegate` will notify the controller about anything that happens inside `MyClass` 
*/ 
@protocol MyClassDelegate <NSObject> 
//Protocol definition 
@end 


/** This class has some cool methods and properties 
*/ 
@interface MyClass : NSObject 
//Class definition 
@end