Я хотел бы настроить свой шаблон roxygen2, который создается, когда я использую C-c C-o C-o
для функции R.
Если мы возьмем пример функции R:
add <- function(x, y) {
return(x + y)
}
и я добавил этот шаблон в свой .emacs:
(setq ess-roxy-template-alist (list (cons "title" "")
(cons "description" "")
(cons "param" "")
(cons "return" "")))
Я получаю это:
##' @title
##'
##'
##' @param x
##' @param y
##' @return
add <- function(x, y) {
return(x + y)
}
Я хочу этот:
##' add
##'
##' @param x
##' @param y
##' @return
add <- function(x, y) {
return(x + y)
}
Есть идеи, как я могу улучшить свой .emacs, чтобы мне не приходилось всегда удалять слово @title и вручную вводить имя функции в первой строке? Я как бы потерялся в документации ESS. Единственное, что я нашел незначительно полезным, было это: https://stat.ethz.ch/pipermail/ess-help/2011-De December/007342.html, который не решает эту проблему для меня.
Я всегда использую имя функции в коде так же, как имя в документации. Более подробная информация и описания находятся в соответствующих полях. Да, я полагаю, я мог бы оставить @title, но заставка нажатия клавиш на самом деле определяет имя функции, которое будет помещено в документацию roxygen.
Понятия не имею, но мне понравился пакет sinew
для автоматизации скелета. r-bloggers.com/automating-roxygen2-package-documentation
Зачем вообще нужно его удалять? И иметь заголовок, являющийся просто именем функции, не особенно хорошо.