在Roxygen/Rd代码示例中使用非平衡括号

Question

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

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

无论我包含哪些"Nope"行,它总是会因错误而失败

氧气块开始失败mwe.r:1
不匹配的支架......

根据我对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('\\\\{')
}