Roxygen2 文档参数乱序
Roxygen2 documentation parameter out of order
我正在使用 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 模板的一部分，但我认为这是不合理的。
好吧，恭喜我，因为我花了整整 45 分钟试图解决这个问题，却没有意识到参数被命令与函数使用参数同步，而且 r 无论如何都不应该在那里。
Fix最终是"r"（或"r"代表的参数）没有直接匹配函数的任何参数，所以它被抛到了最后。我觉得我好笨。不过，无论如何。也许这对未来的用户来说是一个很好的警告。
我正在使用 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 模板的一部分，但我认为这是不合理的。
好吧，恭喜我，因为我花了整整 45 分钟试图解决这个问题，却没有意识到参数被命令与函数使用参数同步，而且 r 无论如何都不应该在那里。
Fix最终是"r"（或"r"代表的参数）没有直接匹配函数的任何参数，所以它被抛到了最后。我觉得我好笨。不过，无论如何。也许这对未来的用户来说是一个很好的警告。