在更新到 roxygen2
之前版本 6.0.0,似乎该包支持使用 @export
标记不在包中函数头的底部。例如:
#' Title
#' @param foo
#' @return bar
#'
#' @export
#'
#' @seealso Other blah blah
上面的代码可以使用
roxygen2
成功构建使用我安装的 roxygen2
时正确填写命名空间版本 5.0.1。但是,随着更新,这种形式的文档将不起作用,
roxygen2
主动将其从 NAMESPACE.R 中删除。我可以通过移动
@export
来解决这个问题至底部#' Title
#' @param foo
#' @return bar
#'
#' @seealso Other blah blah
#' @export
我的问题是这个问题是否是设计造成的?我在发行说明中看不到任何将这一更改指定为 @export 的内容:https://github.com/klutometis/roxygen/releases/tag/v6.0.0
总是这样吗
roxygen2
应该工作,直到这一点的操作是意外的?或者这是故意改变?注意显然,为不同版本制作完整的 mwe 很困难,关于如何解决这个问题的任何建议欢迎
编辑:经过进一步测试,我开始怀疑这不仅仅是 Roxygen。我正在使用 rstudio 中的构建和文档快捷方式,我最近也在更新,甚至退回到
roxygen2
5.0.1 版阻止我重建曾经工作过的旧函数的文档。
最佳答案
在 Roxygen2
的积压软件包中有几个与 @export
相关的错误在 2017 年。
它们现在已修复,无法复制:
关于r - roxygen2 6.0.0 现在在最后一行需要 "@export"吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/42116550/