R中是否存在文档字符串的缺点？

Question

我不喜欢自动缩进评论 ESS（Emacs Speaks Statistics）模式，因为它是向右走的。

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

Python还使用docstrings进行评论。我在R中玩它。

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

我确信我也可以修复评论的ESS缩进，但我喜欢多行的想法 评论即可。在GNU R中，docstrings是否有任何缺点？

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)
}