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

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

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

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

ОТВЕТЫ

Ответ 1

Эта поддержка была добавлена ​​(по крайней мере, в 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.
}