Verwendung von unsymmetrischen Klammer in Roxygen/Rd Codebeispiel

Question

Die folgende MWE (via devtools::document()) zu kompilieren, schlägt fehl:

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

Unabhängig davon, welche der „Nein“ Linien I enthalten, ist es nicht immer mit dem Fehler

Failure in roxygen Block beginnend mwe.r: 1
Nicht übereinstimm Klammern ...

Accordi ng zu meiner Lesung der Rd documentation, sollte dies funktionieren, indem Sie die Klammer entkommen. Wie oben gezeigt, funktioniert dies jedoch nicht nicht. Mache ich etwas falsch oder ist das ein Fehler in Roxygen?

Ein Hinweis, dass dies ein Roxygen Fehler sein könnte, ist die vollständige Fehlermeldung, wenn ich die Single-escaped Version (format('\{')):

Nicht übereinstimm Klammern: "@example format('{}') # Works format('\\{') # Nope"

Beachten Sie, dass die einzelnen Der umgekehrte Schrägstrich in der Eingabe wurde in der Ausgabe verdoppelt.

Answer 1

Nicht sicher, wenn dies behoben wurde, aber mit roxygen2version 6.0.1 scheint dieses Problem gelöst.

devtools::document() auf dem MWE erzeugt eine gültige Rd:

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