ESS ess-roxy-template-alist

Я хотел бы настроить свой шаблон 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, который не решает эту проблему для меня.

Зачем вообще нужно его удалять? И иметь заголовок, являющийся просто именем функции, не особенно хорошо.

Dason 26.10.2018 17:09

Я всегда использую имя функции в коде так же, как имя в документации. Более подробная информация и описания находятся в соответствующих полях. Да, я полагаю, я мог бы оставить @title, но заставка нажатия клавиш на самом деле определяет имя функции, которое будет помещено в документацию roxygen.

trosendal 26.10.2018 17:14

Понятия не имею, но мне понравился пакет sinew для автоматизации скелета. r-bloggers.com/automating-roxygen2-package-documentation

Jonny Phelps 26.10.2018 19:23
Стоит ли изучать PHP в 2023-2024 годах?
Стоит ли изучать PHP в 2023-2024 годах?
Привет всем, сегодня я хочу высказать свои соображения по поводу вопроса, который я уже много раз получал в своем сообществе: "Стоит ли изучать PHP в...
Поведение ключевого слова "this" в стрелочной функции в сравнении с нормальной функцией
Поведение ключевого слова "this" в стрелочной функции в сравнении с нормальной функцией
В JavaScript одним из самых запутанных понятий является поведение ключевого слова "this" в стрелочной и обычной функциях.
Приемы CSS-макетирования - floats и Flexbox
Приемы CSS-макетирования - floats и Flexbox
Здравствуйте, друзья-студенты! Готовы совершенствовать свои навыки веб-дизайна? Сегодня в нашем путешествии мы рассмотрим приемы CSS-верстки - в...
Тестирование функциональных ngrx-эффектов в Angular 16 с помощью Jest
В системе управления состояниями ngrx, совместимой с Angular 16, появились функциональные эффекты. Это здорово и делает код определенно легче для...
Концепция локализации и ее применение в приложениях React ⚡️
Концепция локализации и ее применение в приложениях React ⚡️
Локализация - это процесс адаптации приложения к различным языкам и культурным требованиям. Это позволяет пользователям получить опыт, соответствующий...
Пользовательский скаляр GraphQL
Пользовательский скаляр GraphQL
Листовые узлы системы типов GraphQL называются скалярами. Достигнув скалярного типа, невозможно спуститься дальше по иерархии типов. Скалярный тип...
0
3
60
0

Другие вопросы по теме