检查R包时出现意外的节标题'\ examples'

Question

当我使用R CMD检查pkg_name来检查我自己的R包时，我会收到这样的警告：

unexpected section header '\examples'
unexpected section header '\keyword'

.Rd文件中存在问题，我为自己的数据编写了一些示例R代码（即.Rd文件用于.RDdata文件，而不是.R函数文件）。我想我们可以在下面的{}之间编写示例代码（“...”）：

\example{
...
}

不幸的是它无法通过包裹检查程序...在此先感谢您的帮助！

Answer 1

使用百分比符号（%）时，我曾遇到此问题。我正在尝试编写置信区间参数的文档。然后我意识到我需要用反斜杠转义符号以解决错误（就像在LaTeX中一样）。因此，我将%替换为\%。这解决了错误。

Answer 2

导致问题的.Rd文件中的{}不匹配。检测非常困难，确保在进行R CMD检查pkg_name之前已配对。

Answer 3

此错误消息现在可以获得更多点击roxygen2（mercifully）supports markdown。如果从旧的LaTeX样式文件转换，一些LaTeX合法语法可能仍然隐藏在手动转换之外。

从`word'转换为'word'解决了我的Rd解析错误（即，将前导反引号更改为常规引号）。