在 Xcode 中消除“文档问题”警告？答案

【问题标题】：Silencing "Documentation issue" warnings in Xcode?在 Xcode 中消除“文档问题”警告？
【发布时间】：2017-08-16 22:00:28
【问题描述】：

例如 '@param' command used in a comment that is not attached to a function declaration

这个警告是有效的，但是，我正在编译第 3 方代码并且希望不必更改原始源代码。

我正在运行 Xcode 8.2.1。

【问题讨论】：

标签： xcode documentation warnings

【解决方案1】：

这为我解决了这个问题，超过了第三方库标题中only的警告。只需用这些pragmas 包装有问题的标题#includes：

#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdocumentation"
#include <opencv2/core/core.hpp>
#include <opencv2/highgui/highgui.hpp>
#pragma clang diagnostic pop

这是一个提示的组合 Konchog 和 Vladimir Grigorov 的超级有用的回答 here。

【讨论】：

【解决方案2】：

我能够通过转到

来抑制这些警告

项目 -> 构建设置 -> Apple LLVM 8.1 - 警告 - 所有语言， 并将“文档注释”切换为否。

（为了找到设置，我在构建设置下的搜索框中输入了“文档”。）

【讨论】：

这不会使导入的 SDK 中的第三方文档保持沉默。我有一整套与我的项目无关的第三方文档警告菜单，所以我也很想找到一种方法来消除这些警告。有任何想法吗？谢谢。
@tymac 对 Pods.project 使用相同的解决方案
@Aznix 你说的“Pods.project”是什么意思？
我使用了#pragma clang diagnostic ignored "-Wdocumentation"