Xcode8警告⚠️ Empty paragraph passed to '@xxx' command

问题

• Xcode8升级后，之前添加的注释会有很多警告

解决方法

• 基础知识，就是在编译选项中，添加警告屏蔽

解决步骤

• 显示警告信息

  
  
  

  显示警告信息.png

• 查看警告类型

  
  
  

  查看警告类型.png

• 屏蔽警告
  W是前缀,这个前缀表示的是 打开这种类型的警告 如果我们是要关闭某种类型的警告的话, 要将 -W换成 -Wno-

  • 第一种Xcode编译配置简单粗暴

    
    
    

    屏蔽警告.png
  • 第二种局部屏蔽编译警告
    1. 写法一
       由于pragma为编译预处理命令
       • 如果命令写在.m文件中，作用于为当前.m
       • 如果命令写在.h文件中，作用域为包含该.h文件的所有.m文件
         建议使用写法二

#pragma clang diagnostic ignored "-Wdocumentation"

 2. 写法二 
 作用域只局限于`push `和`pop`之间

#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdocumentation"
//
要去除警告的代码
//
#pragma clang diagnostic pop

关于'#pragma'去除警告

• 参见文章#pragma 处理警告