Sections arbitraires dans les documents roxygen

La façon dont Roxygen semble fonctionner est que la première ligne est le \title, tout le reste est dans le \details, puis toutes les @foodirectives gèrent ces choses. Mais la documentation R est plus riche que cela. Je peux avoir des "\section{Llamas}{Are they ungulates?}"fichiers .Rd.

Mais je ne peux pas demander à Roxygen de faire autre chose que d'envelopper tout dans \ details. Est-ce que je manque quelque chose?

J'ai une solution hacky, qui est de coller un inégalé }avant mon \section. Ceci termine alors la \detailssection. Je dois alors ne pas mettre de fin }dedans, car roxygen colle un en pensant qu'il ferme le \details. Eeeeeurrrrrrrrgh.

Ce support a été ajouté (au moins dans roxygen2). Il vous suffit d'ajouter @section Llamas:et tout ce qui suit jusqu'à ce qu'une nouvelle directive soit satisfaite sera dans une section Llamas. Voici un exemple

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

ce qui donne ce qui suit pour le fichier .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.
}