r - roxygen2 是否自动为 "Imports:"包编写 NAMESPACE 指令？

Question

tl;我的问题的博士版本

如果我想导入包，是否必须手动将 import() 指令写入我的 NAMESPACE 文件中？看来 roxygen2 不会神奇地为我做到这一点，即使我在描述中将它们列为“导入:”。

完整版本

这是一个非常愚蠢的问题，但我问这个问题是因为答案对我来说并不明显。

我使用roxygen2来处理my R package文档。当我想确保导出某个函数时，我会在其 roxygen block 中添加一个 @export 标签。后续运行 roxygenize() 将相应地写入 NAMESPACE 指令。

但是，my package目前还导入了其他几个:

Depends:
    R (>= 2.13.0),
    ggplot2 (>= 0.8.9)
Imports:
    RColorBrewer,
    plyr,
    gridExtra

看来，虽然roxygen2将重写导出函数的NAMESPACE指令，但它不会自动重写NAMESPACE以反射(reflect)包I' ve 指定应该导入到我的描述中。

Answer 1

扩展我的评论，如果您想自动为您导入的包/函数添加命名空间指令，您可以通过添加@imports包来实现 或 @importFrom package function 行添加到函数的 roxygen2 文档 header 。

但是，正如@hadley指出的，它只会修改NAMESPACE，而不会影响包DESCRIPTION