Roxygen2 文档参数乱序

Question

我将 Roxygen2 用于文档，但我无法正确设置参数的顺序。具体来说，我为这一组方法设置了 3 组参数：

• “n”：所有函数的参数，应该始终放在首位
• “r”：某些函数的参数，应该始终是第二个。在模板中
• p3-p5：模板中的一组参数；应该总是在结尾。
  • 它们分别以“s”、“a”和“r”开头

我没能把它弄成正确的顺序：最常见的顺序是 n、p3-p5、r。如果我删除 n，我得到 p3-p5, r。如果我有 2 个 n，我得到 n，p3-p5，n，r。如果我有 2 个 r 而没有 n，我得到 p3-p5, r, r。

关于如何解决此问题的任何建议。如果你认为它与当前的布局有关，那就是：

#' @templateVar ... ...
#' @param n ...
#' @template t1 # Template for r
#' @template t2 # Template for p3-p5
#' @details  ... 
#' ...

t2 的布局在哪里：

#' @param p3
#' @param p4
#' @param p5
#' @details ...
#' @return  ...
#' ...

我发现的其他修复方法似乎不起作用。另外，我希望 n 成为 t2 模板的一部分，但我认为这是不合理的。

Answer 1

好吧，恭喜我，因为我花了 45 分钟的时间试图弄清楚这一点，却没有意识到这些参数被命令与函数使用参数同步，而且 r 不应该在那里。

修复最终是“r”（或“r”代表的参数）没有直接匹配函数的任何参数，所以它被扔到最后。我觉得我好笨。不管怎样。也许这对未来的用户来说是一个很好的警告。