Seções arbitrárias em documentos roxygen

A maneira como o Roxygen parece funcionar é que a primeira linha é o \title, todo o resto está no \details, e então quaisquer @foodiretivas tratam dessas coisas. Mas a documentação do R é mais rica do que isso. Posso ter "\section{Llamas}{Are they ungulates?}"em arquivos .Rd.

Mas não consigo fazer com que o Roxygen faça outra coisa senão embrulhar tudo em \ detalhes. Estou esquecendo de algo?

Tenho uma solução hacky, que é colocar um incomparável }antes do meu \section. Isso então encerra a \detailsseção. Então eu tenho que não colocar um final }em, porque o roxygen prende um pensando que está fechando o \details. Eeeeeurrrrrrrrgh.

Este suporte foi adicionado (pelo menos no roxygen2). Você só precisa adicionar @section Llamas:e, em seguida, qualquer coisa depois disso, até que uma nova diretiva seja atendida, estará em uma seção Llamas. Aqui está um exemplo

#' 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")
}

que fornece o seguinte para o arquivo .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.
}