Saya memiliki paket fungsi; satu fungsi memiliki 22 parameter (termasuk ...
). Saya baru-baru ini memindahkan parameter dari opsi ...
menjadi parameter lengkap, dan memperhatikan bahwa meskipun itu dijelaskan dalam urutan logis dalam daftar parameter fungsi, dan dalam urutan yang sama dalam daftar item roxygen2 @params, ketika saya document()
, item baru berada di bawah item ...
di bagian bawah, dan diikuti oleh param lain yang saya dapatkan di tempat yang logis juga.
Contoh: Scriptnya seperti ini:
#' @param ParameterA does something
#' @param ParameterB does something else
#' @param ... optional extras
foo <- function(ParameterA, ParameterB, ...)
File rd & bantuan terlihat seperti ini:
Arguments
Parameter A does something
... optional extras
Parameter B does something else
Saya tahu ini sepele, tetapi adakah yang tahu cara memperbaikinya? Saya menghapus file .Rd dan redocument()
ed tetapi tidak berhasil.
Tangkapan layar album Imgur (3 foto) di sini: http://imgur.com/a/pUX4m
Edit: menggali lebih lanjut: Saya menjalankan build & reload, memeriksa, dan melihat:
Documented arguments not in \usage in documentation object 'gbm.auto':‘tc’ ‘mapshape’.
Functions with \usage entries need to have the appropriate \alias entries, and all their arguments documented.
The \usage entries must correspond to syntactically valid R code.
Paragraf terakhir sebelum "RC" di sini mengatakan @usage
tidak diperlukan lagi sejak itu v3 dari roxygen2 menghasilkan ini secara otomatis. Tapi ini tidak berhasil lagi bagi saya, meskipun saya pernah berhasil di masa lalu.