11

我最近被指向 Roxygen 来解决我的文档问题/懒惰。但是还有这个闪亮的 Roxygen2,在我的理解中,它在某种程度上是它自己的东西。Hadley 的打包工具需要使用 Roxygen2,但似乎没有太多的地方可以通过。

鉴于我在学习过程中从头开始:

  1. 对于新用户,是否有一个用例偏爱 Roxygen 而不是 Roxygen2,或者 Roxygen2 在所有方面都更好?

  2. 如果是这样,有什么资源可以学习它(最好是那些不依赖于 Roxygen 的先验知识的资源)?

  3. Roxygen2 是否与 Roxygen 向后兼容(这样在学习和编写 Roxygen 上投入的时间会延续)?

4

2 回答 2

13

如果从头开始,没有理由更喜欢 roxygen 而不是 roxygen2。我们正在为 r 新闻撰写介绍性文章。

于 2011-08-07T02:57:30.907 回答
7

我将构建脚本切换为调用 roxygen2 而不是 roxygen,一切正常,除了现在我得到了一个很好的自动生成的 NAMESPACE 文件。

所以学习roxygen意味着你正在学习roxygen2的基础知识。我确定我没有使用所有的新功能,但对于基础来说,roxygen2 就像 roxygen 一样工作。

我还要补充一点install_github(),在devtools包中(也在 github 上)绝对很棒。对于不适合 CRAN 的软件包,github 是一个不错的选择。

于 2011-08-07T15:31:32.833 回答