r - R 帮助页面中的 "not run"是什么意思？

Question

有时，在 R 帮助页面上，注释中会出现短语“未运行”。从“with()”的帮助页面查看这一点:

Examples
require(stats); require(graphics)
#examples from glm:
**## Not run:** 
library(MASS)
with(anorexia, {
    anorex.1 <- glm(Postwt ~ Prewt + Treat + offset(Prewt),
                    family = gaussian)
    summary(anorex.1)
})
## End(**Not run**)

示例代码中的“未运行”是什么意思？

Answer 1

“not run”包含不应在 example 函数中执行的代码(例如耗时的代码部分、用户交互等)。

参见例如？示例:

如手册Writing R Extensions中所述，作者帮助页面可以标记部分示例的两个异常规则

• “dontrun”包含不应运行的代码。

• “dontshow”包含在帮助页面上不可见的代码，但会 由包检查工具运行，并且 'example()' 函数。这以前是“仅测试”，并且 该表格仍然被接受。