One easy way is to list the undocumented files in pkg-internal.Rd. From the Writing R Extensions manual:

Note that all user-level objects in a package should be documented; if a package pkg contains user-level objects which are for “internal” use only, it should provide a file pkg-internal.Rd which documents all such objects, and clearly states that these are not meant to be called by the user. See e.g. the sources for package *grid* in the R distribution for an example.

Probably a perverse use of this facility, but it works, and will even allow the package to pass check.

David Scott


On 16/12/2011 1:01 a.m., Nicola Sturaro Sommacal wrote:
Hi!

I am building a package. This package will not submitted to CRAN.

I write the help files for the most important functions of my package, I
cannot write it for all functions. This may sounds strange, but so there!

I know that all user-level functions should be documented, so I have to
move my undocumented functions to a non-user-level. It's right?

To move my functions to a non-user-level I can write them as hidden
functions, with a dot before the names. This require a very long check of
my code to change the call to the function preceding it by a dot. So, this
is not a real choice.
There are other way to reach my purpose?

Thank you very much for help.

Sincerely,
Nicola

        [[alternative HTML version deleted]]

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

--
_________________________________________________________________
David Scott     Department of Statistics
                The University of Auckland, PB 92019
                Auckland 1142,    NEW ZEALAND
Phone: +64 9 923 5055, or +64 9 373 7599 ext 85055
Email:  d.sc...@auckland.ac.nz,  Fax: +64 9 373 7018

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

Reply via email to