python - Sphinx 中未解决的引用

Question

假设我有一个项目，其中（某处）记录了以下功能：

.. exmpl:cfunction:: ExMpl* ExMplSet( int flags, int size, ExStorage* storage )

在该项目文档的其他地方，我们有一个参考，如下所示：

:exmpl:cfunc:`ExMplSet`

一切似乎都是合法的，并且在文档中还有其他这种用法的例子，但是作为输出 Sphinx 给出了一个警告：

~/some_folder/some_file:320: WARNING: unresolved reference: u'ExMplSet' - u'cfunc'

没有应该有的链接，而且 100 多个警告（对于整个项目）并不是那么好。

这些确切的例子当然是虚构的。我要的是某种提示，在哪里寻找答案。

Answer 1

我希望它被分成不同的行。一个目标，另一个定义：

.. exmpl:cfunction:: ExMplSet

ExMpl* ExMplSet( int flags, int size, ExStorage* storage )

另一种选择（我现在无法检查）是您在“exmpl：”前面缺少一个冒号