An error ['\+' is an unrecognized escape in character string starting "\+" while creating a R package An error ['\+' is an unrecognized escape in character string starting "\+" while creating a R package r r

An error ['\+' is an unrecognized escape in character string starting "\+" while creating a R package


The offending code comes from the Examples section of one of your help files (which is why it ends up in packageName-Ex.R). To fix it, just escape each of the backslashes in the Examples sections of your *.Rd documentation files with a second backslash. (So, type \\to get \ in the processed help file, and type \\\\ to get \\.)

Unless it's escaped, \ is interpreted as a special character that identifies sectioning and mark-up macros (i.e. commands like \author, \description, \bold, and \ldots). Quoting from Duncan Murdoch's Parsing Rd files (the official manual for this topic):

The backslash \ is used as an escape character: \, \%, { and } remove the special meaning of the second character.

As an example of what this looks like in practice, here is part of $R_SOURCE_HOME/src/library/base/man/grep.Rd, which is processed to create the help file you see when you type ?grep or ?gsub.

## capitalizingtxt <- "a test of capitalizing"gsub("(\\\\w)(\\\\w*)", "\\\\U\\\\1\\\\L\\\\2", txt, perl=TRUE)gsub("\\\\b(\\\\w)",    "\\\\U\\\\1",       txt, perl=TRUE)

In the processed help file, it looks like this:

 ## capitalizing txt <- "a test of capitalizing" gsub("(\\w)(\\w*)", "\\U\\1\\L\\2", txt, perl=TRUE) gsub("\\b(\\w)",    "\\U\\1",       txt, perl=TRUE)