r - 在 Roxygen/Rd 代码示例中使用不平衡大括号

Question

以下 MWE 无法编译（通过devtools::document()）：

#' MWE
#'
#' @examples
#' format('{}') # Works
#' format('{')  # Nope
#' format('\{') # Nope
#' format('\\{')# Nope
format = function (str) {}

无论我包含哪一条“Nope”行，它总是会因错误而失败

roxygen 块开始失败 mwe.r:1
大括号不匹配……</p>

根据我对Rd 文档的阅读，这应该通过转义大括号来工作。但是，如上所示，这不起作用。我做错了什么还是这是 Roxygen 中的错误？

当我使用单转义版本 ( format('\{')) 时，提示这可能是 Roxygen 错误的一个提示是完整的错误消息：

不匹配的大括号："@example format('{}') # Works format('\\{') # Nope"

请注意，输入中的单个反斜杠在输出中已加倍。

Answer 1

不确定何时解决此问题，但roxygen2 version 6.0.1此问题似乎已解决。

devtools::document()在 MWE 上产生一个有效的 Rd：

\examples{
format('{}') 
format('{')  
format('\\{') 
format('\\\\{')
}