Произвольные разделы в документах roxygen

Путь Roxygen , кажется, работает в том , что первая строка является \title, все остальное в \details, а затем любые @fooдирективы обрабатывать эти вещи. Но документация R богаче. Могу иметь "\section{Llamas}{Are they ungulates?}"в файлах .Rd.

Но я не могу заставить Roxygen делать что-либо, кроме как обернуть все это в \ детали. Я что-то упускаю?

У меня есть хакерское решение, которое заключается в том, чтобы поставить }перед моим \section. На этом \detailsраздел заканчивается . Тогда я не должен вставлять концовку }, потому что roxygen придерживает одну, думая, что закрывает \details. Eeeeeurrrrrrrrgh.

Эта поддержка была добавлена ​​(по крайней мере, в roxygen2). Вам просто нужно добавить, @section Llamas:и тогда все, что после этого, пока не будет достигнута новая директива, будет в разделе Llamas. Вот пример

#' Llama llama llama
#' 
#' More about llamas
#' 
#' @section Llamas:
#' Are they ungulates?
#' 
#' @section Not llamas:
#' This section is not about llamas.  It is not very interesting.
#' 
#' @param notused A parameter that isn't used at all!
#' @export
llama <- function(notused){
    return("LLAMA LLAMA LLAMA")
}

что дает следующее для файла .Rd

\name{llama}
\alias{llama}
\title{Llama llama llama}
\usage{
  llama(notused)
}
\arguments{
  \item{notused}{A parameter that isn't used at all!}
}
\description{
  More about llamas
}
\section{Llamas}{
  Are they ungulates?
}

\section{Not llamas}{
  This section is not about llamas.  It is not very
  interesting.
}