标准 C 类型的 Sphinx 警告“未找到参考目标”

Question

在 nitpick 模式下运行的 Sphinx 会发出类似“警告：c：未找到类型引用目标：wchar_t”和“警告：c：未找到标识符引用目标：wchar_t”之类的警告，以引用标准 C 类型，如

wchar_t

、

FILE 

或

va_list

。它抱怨所有不仅仅是关键字的类型，例如

long

、

unsigned int

或

const char *

。

将

('c:type', 'wchar_t')

添加到

nitpick_ignore

中的

conf.py

列表可以解决

:c:type:`wchar_t`

中的问题，但不能解决

:c:texpr:`wchar_t *`

中的问题，更重要的是，不能解决函数声明中的问题：

.. c:function:: int foobar(const wchar_t *arg)

如何摆脱这些警告？我如何告诉 Sphinx

wchar_t

、

FILE

和

va_list

是在我的项目之外定义的 C 类型？

Answer 1

请参阅此处的答案，其中定义了 nitpick_ignore 字典 https://github.com/breathe-doc/breathe/issues/696