r - R中的文档字符串有缺点吗？

Question

我不喜欢 ESS（Emacs Speaks Statistics）模式下注释的自动缩进，因为它太靠右了。

normalize <- function(values){
                                        # comment
  return(2* values / (max(values) - min(values)) )
}

Python 也使用文档字符串来进行注释。我在 R 中玩弄它。

normalize <- function(values){
  "comment
   line 2 of comment"
  return(2* values / (max(values) - min(values)) )
}

我确信我也可以修复注释的 ESS 缩进，但我喜欢多行注释的想法。GNU R 中的文档字符串有什么缺点吗？

Answer 1

##以代替开头的注释#将根据当前缩进级别自动缩进。

j <- function(x) {
                                        # One hash auto-indents to column 40 
    ## Two hashes auto-indent to current level
### Three hashes auto-indent to BOL
    rnorm(x)
}