r - roxygen2 6.0.0 现在在最后一行需要 "@export"吗?

标签 r documentation version roxygen2

在更新到 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 年。

它们现在已修复,无法复制:

  • https://github.com/r-lib/roxygen2/issues/574
  • https://github.com/r-lib/roxygen2/issues/656
  • 关于r - roxygen2 6.0.0 现在在最后一行需要 "@export"吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/42116550/

    相关文章:

    r - 将矩阵转换为列

    r - 获取向量的最后 n 个元素。有没有比使用 length() 函数更好的方法?

    linux - Linux/GTK 上存在哪些应用程序帮助系统(如 chm 文件)?

    scala - 记录 Scala 2.10 宏

    java - Maven 和 System.lineSeparator

    C++自动更新到新版本

    R 中的正则表达式 : matching the string before a sequence of characters

    r - shinydashboardPlusGallery() 示例不起作用

    mysql - MySQL手册的文本版本

    c# - 有没有办法检查文件的版本?