[R-pkg-devel] Is there an Rtools40 changelog?

2020-05-10 Thread James Lamb
Hello,

I am a maintainer on the LightGBM project, focused on that project's R
package. The R package is not available on CRAN yet (we are working on it),
so for now our users must build it from source.

The package includes compilation of a C++ library, and we link to R.dll /
R.so to use R-provided functions like Rprintf.

With the release of R4.0 and Rtools40, we recently received reports from
our users that they are unable to build our package on Windows systems with
R 4.0 and Rtools 4.0 (https://github.com/microsoft/LightGBM/issues/3064).

After some investigation, I've learned that the following changes in
Rtools40 (relative to Rtools35) broke our installation process:

   - *gendef.exe* was removed
   - *mingw32-make.exe* was removed
   - paths like "mingw_64/bin" were changed to "mingw64/bin"

I do not expect that our off-CRAN installation process is supported. I
understand that by maintaining our own process, we are taking on the burden
of keeping up with new releases of R and Rtools.

My question is this...is there public documentation about why the changes I
mentioned above were made? I have not found any mention of them in the
following places, and am not sure where else to look.

   - https://cran.r-project.org/bin/windows/Rtools/
   - https://github.com/r-windows/docs/blob/master/faq.md#readme
   - https://jeroen.github.io/rstudio2019

Thank you very much for your time and consideration,

-James Lamb

[[alternative HTML version deleted]]

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


[R-pkg-devel] Documentation for non-user-level objects

2020-05-10 Thread Sapphire Zhou
I met a problem when I uploaded the package to CRAN. There is a warning told me 
“All user-level objects in a package should have documentation entries.”

Actually, those functions are not user-level functions. How could I claim 
non-user-level functions in an R package.
Is there any idea to remove this warning.

Thanks!
__
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel


Re: [R-pkg-devel] Documentation for non-user-level objects

2020-05-10 Thread Bert Gunter
1. Don't export them.

2. Use:  \keyword{ internal } in the .Rd file
>From "Writing R Extensions"
"The special keyword ‘internal’ marks a page of internal objects that
are not part of the package’s API. If the help page for object foo has
keyword ‘internal’, then help(foo) gives this help page, but foo is
excluded from several object indices, including the alphabetical list
of objects in the HTMLhelp system."

Cheers,
Bert

Bert Gunter

"The trouble with having an open mind is that people keep coming along
and sticking things into it."
-- Opus (aka Berkeley Breathed in his "Bloom County" comic strip )

On Sun, May 10, 2020 at 2:31 PM Sapphire Zhou
 wrote:
>
> I met a problem when I uploaded the package to CRAN. There is a warning told 
> me
> “All user-level objects in a package should have documentation entries.”
>
> Actually, those functions are not user-level functions. How could I claim 
> non-user-level functions in an R package.
> Is there any idea to remove this warning.
>
> Thanks!
> __
> R-package-devel@r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-package-devel

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


Re: [R-pkg-devel] Documentation for non-user-level objects

2020-05-10 Thread Uwe Ligges




On 10.05.2020 23:26, Sapphire Zhou wrote:

I met a problem when I uploaded the package to CRAN. There is a warning told me
“All user-level objects in a package should have documentation entries.”

Actually, those functions are not user-level functions. How could I claim 
non-user-level functions in an R package.
Is there any idea to remove this warning.


Have you exported the function?

Best,
Uwe Ligges



Thanks!
__
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel



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