roxygen2和RStudio,没有为函数创建文档

时间:2014-12-01 10:19:35

标签: r rstudio roxygen2 roxygen

我正在尝试通过包中的roxygen2添加文档。我能够成功创建packag,并且在加载时也能够使用这些功能。以下是我对如何操作的理解,我在RStudio上创建了一个空的R-Package项目,然后有一个名为“getSomething.R”的源文件。内容如下,

#' Test function to ask on stackoverflow
#' 
#' \code{getSomething} Does something to get something.
#' 
#' @param a param 1
#' @param b param 2
#' 
#'

getSomething <- function(a,b){
  return(a*b)
}

现在,我构建并加载了包,理想情况下,应该在/ man文件夹中使用.Rd文件创建包,并且还要执行“?getSomething”。但是没有使用该命令,也没有创建Rd文件。我在这里错过了什么吗?在我的原始项目中,我添加了一些依赖包。

以下是解密文件

Package: testPackage
Type: Package
Title: Learn how to use roxygen2.
Version: 1.0.1
Date: 2014-11-27
Author: amj2403
Maintainer: amj2403 <emailid>
Description: Write something here
License: NA
Depends:
    R (>= 3.0.0),
    rjson,
    futile.logger,
    RCurl

也是NAMESPACE文件,

  

exportPattern( “^ [[:阿尔法:]] +”

我想我错过了一些重要的步骤。

3 个答案:

答案 0 :(得分:7)

当您启用roxygen2时,RStudio中的默认值是对包构建和R CMD CHECK上的所有内容进行roxygenise,但不会在&#34;构建和重新加载&#34;上。要启用它,请转到项目选项 - &gt;构建工具。然后单击&#34;配置&#34; &#34;旁边的按钮用Roxygen生成文档&#34;并勾选&#34; Build&amp;刷新&#34;框。

答案 1 :(得分:2)

有时候,RStudio不会显示复选框&#34;使用Roxygen生成文档&#34;一点都不如果是这种情况,在R控制台类型库(roxygen2)中会突然出现。

我希望默认是强制加载它并启用它。

答案 2 :(得分:1)

devtools制作软件包时遇到了同样的问题。我只需要运行devtools::document()来创建帮助文件。