[R-pkg-devel] Documenting raw data

[Cantin, Alan (NRCan/RNCan)]

Hello,

Yes thanks, I was able to figure out that I can (and should) remove documentation for these files. This solved my issue and thank you for taking the time to respond.

Cheers,


Alan Cantin



-------- Original message --------
From: Ma�lle SALMON <maelle.salmon using yahoo.se>
Date: 2020-05-12 4:24 a.m. (GMT-05:00)
To: r-package-devel using r-project.org, "Cantin, Alan (NRCan/RNCan)" <alan.cantin using canada.ca>
Subject: Re: [R-pkg-devel] Documenting raw data

Hello,

I don't think you have to (and shouldn't?) document raw data. However, you can use it in examples/tests/etc. using the system.file() command you mention.

But maybe you want to export the data? In that case it should be under data/.

This chapter of the R packages book might be useful <https://r-pkgs.org/data.html> (as well as <https://cran.r-project.org/doc/manuals/r-release/R-exts.html#Data-in-packages>).

Ma�lle.


Den torsdag 23 april 2020 23:06:26 CEST, Cantin, Alan (NRCan/RNCan) <alan.cantin using canada.ca> skrev:





Hi Folks,

Looking for some help documenting my raw data (data in inst/extdata).

Is the correct doctype "data"?

The usage of loading this type of data is system.file("extdata", nameoffile, package="nameofpackage")

Is this the correct string to put in the \usage section?  I have tried this, but get errors such as:

Functions or methods with usage in documentation object 'nameoffile' but not in code:
    'system.file'


Has anyone done this recently and have an example to see where I'm going wrong?

This check seems to be new as in the past I simply had lazydata set to true and it passed tests.

Thanks for any help.

Cheers,

Alan Cantin



    [[alternative HTML version deleted]]

______________________________________________
R-package-devel using r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel

	[[alternative HTML version deleted]]