quote aliases?

[yihui]

it seems that aliases are quoted when they contain special characters; I looked at the the documentation of %in%, its alias was \%in\% (no quotes but % was escaped). The alias for substr<- is not quoted either.

[hadley]

Does that cause any problems for you? If it should be quoted, R CMD check should be warning about it.

[yihui]

I mean it should NOT be quoted, but currently roxygen2 does quote it.

library(roxygen2)
roc <- rd_roclet()
out <- roc_proc_text(roc, "
    #' @name a
    #' @aliases \\%a\\%
    NULL")[[1]]
roxygen2:::get_tag(out, 'alias')$values

The output is:

> roxygen2:::get_tag(out, 'alias')$values
[1] "a"           "\"\\%a\\%\""

[unDocUMeantIt]

here's a fix, in two patches:

patch1

--- roclet-namespace.R.orig     2011-08-29 23:52:59.648650390 +0200
+++ roclet-namespace.R  2011-09-01 19:25:54.228446954 +0200
@@ -182,9 +182,15 @@
   unlist(lapply(matches, f, tag = tag, all = partitum), use.names = FALSE)
 }

-words <- function(x) {
-  quote_if_needed(str_split(str_trim(x), "\\s+")[[1]])
+words <- function(x, quote=TRUE) {
+  x.trimmed <- str_split(str_trim(x), "\\s+")[[1]]
+  if(isTRUE(quote)){
+    return(quote_if_needed(x.trimmed))
+  } else {
+    return(x.trimmed)
+  }
 }
+
 is.syntactic <- function(x) make.names(x) == x
 has.quotes <- function(x) str_detect(x, "'|\"")
 quote_if_needed <- function(x) {

patch2

--- roclet-rd.R.orig    2011-07-28 20:59:24.000000000 +0200
+++ roclet-rd.R 2011-09-01 19:27:26.976672899 +0200
@@ -333,7 +333,7 @@
   add_tag(rd, process_description(partitum, base_path))

   add_tag(rd, process_had_tag(partitum, 'aliases', function(tag, param) {
-      new_tag('alias', words(param))
+      new_tag('alias', words(param, quote=FALSE))
     }))
   add_tag(rd, process.usage(partitum))
   add_tag(rd, process.arguments(partitum))