我在开发时经常需要多个嵌套的多行(或“部分行”)注释。
Xcode最近可能引入了世界上最令人讨厌的警告 - 它迫使我禁用“警告为错误”。我猜这个警告是为了捕捉一个非常罕见的情况,当有人输入错误并导致一个块评论没有结束 - 但IME还有许多其他问题会导致很快就会显示出来。
一些例子:
/* removed while debugging the BARFOO
-(void) aMethod
{
[self methodCall:7.0 /* needed to FOO the BAR: */ * self.multiplier * /* double for hi-res:*/ 2.0];
}
*/
和
/* removed while debugging the BARFOO
/** This method has DOCUMENTATION
*/
-(void) aDocumentedMethod
{
...
}
-(void) aMethod
{
/** internally, we have to BAR BAR the FOOFOO.
1. BAR
2. BARBAR
3. Finally, FOOOFOO
*/
...complex lines of source here...
}
*/
当然,调试时非常简单的双重注释。
但我无法在Xcode5中找到一个禁用此警告的地方 - 它似乎不存在于任何列出的警告中:(?
答案 0 :(得分:3)
如果要查看警告代码,请执行构建,转到“Log Navigator”,选择构建,展开构建日志:
在查看构建日志的详细信息后,您会看到其中列出的警告代码。在这种情况下,您会看到警告为-Wcomment
。
注意,这有助于您识别您询问的警告(“/ *在块注释中”警告),但它不会更改嵌套/* ... */
注释的行为。
我个人使用Abizern的技术来快速评论大块。或者,您可以使用
#if 0
和
#endif
注释掉你的块(你可以嵌套)
答案 1 :(得分:2)
您可以在任何地方使用//
进行评论。这样你就不会收到这个警告。
/
也与doxygen类型注释兼容,您不需要使用/**
版本。
Xcode支持这种语法。如果您选择一个区域,则可以使用 cmd + /
切换注释