我目前正在学习 Objective-C，需要知道如何编写方法描述。我在学习如何在 Objective-C 中做到这一点时遇到了很多困难。
在 Jave 我们有这个
/**
< h2 >MethodName</ h2 >
< p >Various Description, can use html with images etc.</ p >
*/
private void methodName(args[]..)
{
}
在objective-c中我在哪里放置描述？这也是在头文件还是实现文件中？
//Within Implementation?
- (float)gteHeightPercentage:(float)percentageToGet
{
return self.view.bounds.size.height * percentageToGet;
}
//Within Header?
- (float)getWidthPercentage:(float)percentageToGet;
更新：以下格式适用于Objc. 如果您想记录 swift 代码，请参阅NSHipster 的关于 Swift 文档的博客
Xcode 5 可以做你想做的事。感谢Wonil Kim，在.h文件中：
/**
* Add new message between source to destination timeline as empty name string
* @author Wonil Kim
*
* @param sourceId Source timeline entity ID
* @param destId Destination timeline entity ID
* @return A newly created message instance
*/
- (ISMessage*)messageFromTimeline:(NSInteger)sourceId toTimeline:(NSInteger)destId;
完成后，您可以alt单击方法名称，然后..瞧！
当然，正如您在Kim 的博客上看到的那样，这不是唯一的方法：
/*! Some description of the method....
* \returns The result
*/
或者，
/// Some description to show up, done by:
/// @author Olly Dixon
你明白了...
正如许多人已经提到的，Objective-C 不会向您显示您的文档。事实上，java 也不是（javadoc，可能是）。这是您的 IDE，在这种情况下，是不可崩溃的 Xcode :)
UPDATE2： 评论中“特殊命令”的完整列表。
更新 3：如果您想启用自动生成文档，请使用VVDocumenter-Xcode///。
UPDATE4: : VVDocumenter 已集成到 Xcode 中：
如果您使用的是 Xcode 8 或更高版本，请使用快捷键 (⌥ Option + ⌘ Command + /) 为您的代码添加文档注释
您所描述的内容称为“文档注释”，或简称为“文档注释”。
从 4.6.3 版开始，Xcode 不会在弹出窗口或其快速帮助检查器中显示您自己的文档注释。你必须将你的注释编译成一个“文档集”才能让 Xcode 显示它们。有一些工具可以做到这一点，但是没有办法让 Xcode 重新加载文档集，除非退出并重新启动它，所以我不建议打扰。
Xcode 5（目前可作为 OS X 和 iOS 开发者计划的付费会员的开发者预览版）显示您自己代码的文档注释；请参阅开发人员工具功能页面上的“快速帮助”。您必须在头文件中写入文档注释。您可以使用 doxygen 或 headerdoc 格式。