如何强制 Xcode 显示我自己的自定义类、方法等文档？我习惯了 Java 和 Eclipse，它向我展示了我的类的文档，如下所示：
如何在 Xcode 中实现相同的功能？有没有 Xcode 可以识别和显示的特殊 cmets？
【问题讨论】：
标签： xcode
从 Xcode 5.0 开始，变量和方法的 Doxygen 和 HeaderDoc 格式会自动解析并呈现在快速帮助弹出窗口中。有关它的更多信息here，但这里有一些关键位：
/**
* Add a data point to the data source.
* (Removes the oldest data point if the data source contains kMaxDataPoints objects.)
*
* @param aDataPoint An instance of ABCDataPoint.
* @return The oldest data point, if any.
*/
- (ABCDataPoint *)addDataToDataSource:(ABCDataPoint *)aDataPoint;
在 Xcode 中呈现为：
至于属性，很简单：
/// Base64-encoded data.
@property (nonatomic, strong) NSData *data;
当点击选项时，会出现这个可爱的弹出框：
【讨论】：
好吧，看来课程的问题还没有得到回答，所以我会发布我的建议。
就在 MyClass.h 文件中的 @interface MyClass : NSObject 行之前，您可以像在示例中一样使用注释，但添加一些标签来显示文本。例如下面的代码：
/**
* @class GenericCell
* @author Average Joe
* @date 25/11/13
*
* @version 1.0
*
* @discussion This class is used for the generic lists
*/
将产生以下输出： the output of the code above http://imageshack.com/a/img18/2194/kdi0.png
【讨论】：
Appledoc 是目前生成 xcode 文档的最佳选择。 Doxygen 很棒，但它不会生成对您正在谈论的弹出窗口非常有效的文档集。 Appledoc 并不完美，但我们转向了它并且对结果非常满意。
【讨论】：
也可以在文档中添加一些代码sn-p，如下所示
通过添加以下代码
* @code
* - (UIButton*) createButtonWithRect:(CGRect)rect
{
// Write your code here
}
* @endcode
有关自定义类的文档方法的更多详细信息，您可以查看我的博客Function Documentation in Xcode。
【讨论】：
要让 Xcode 显示您的类的文档，您必须使用 Doxygen 或 HeaderDoc 等工具为您的类创建一个文档集。创建文档集后，您必须使用 Xcode 的文档首选项安装它。 Apple 有一篇关于使用 Doxygen 的文章，但它涵盖了 Xcode 3，而不是 4。
【讨论】：