[R-pkg-devel] undocumented data sets

Iñaki Ucar iuc@r @ending from fedor@project@org
Mon Jan 14 15:49:51 CET 2019


See an example with roxygen2:

https://github.com/r-quantities/errors/blob/master/R/data.R

And how this is translated if you prefer to write the Rd yourself:

https://github.com/r-quantities/errors/blob/master/man/datasets.Rd

Iñaki

On Mon, 14 Jan 2019 at 15:45, Troels Ring <tring using gvdnet.dk> wrote:
>
> Dear friends - with your help I'm almost through developing a package and
> Ctrl-shit-E now only has a single warning
>
> > checking for missing documentation entries ... WARNING
>
>   Undocumented data sets:
>
>     'Cl' 'K' 'Na' 'TOTAL' 'WA' 'INPUT' 'Alb' 'Ca' 'Lact' 'Mg' 'PCO2' 'S1'
>
>     'Brom' 'pHOBS'
>
>   All user-level objects in a package should have documentation entries.
>
>   See chapter 'Writing R documentation files' in the 'Writing R
>
>   Extensions' manual.
>
>
>
> But in 2.1.2.Documenting data sets in Writing R extensions it is said that
> \arguments is not needed and in the template on p 72 in the manual I see no
> entry directly making for this documentation. Everything runs just well -
> but I must have it clean now!
>
> I also tried the RStudio option of generating a Rd file on data, and there
> was an entry I filled out like this
>
>
>
> \describe{
>
>     \item{\code{Brom}}{Dataframe of Table S4 in Glaser et al}
>
>
>
> But t didn't cure the warning (Brom entry) above?
>
>
>
> All best wishes
>
> Troels
>
>
>         [[alternative HTML version deleted]]
>
> ______________________________________________
> R-package-devel using r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-package-devel



-- 
Iñaki Úcar



More information about the R-package-devel mailing list