[R-pkg-devel] Inquiry

Rolf Turner r@turner @end|ng |rom @uck|@nd@@c@nz
Wed Sep 28 03:37:28 CEST 2022


On Tue, 27 Sep 2022 07:43:03 +0000
Georgi Boshnakov <georgi.boshnakov using manchester.ac.uk> wrote:

> >...functions, that are not meant to be called directly by users,
> >should be documented in a file named <pkgnm>-internal.Rd.  
> 
> This is one option, convenient in the use-case of the question. But
> why export a function that you actively don't want the users to know
> about?

<SNIP>

Why would you not want users to know about functions?  This strikes me
as being overly authoritarian. Of course, to export or not to export
is the choice of the package author.  It is also sensible to try to
protect users from shooting themselves in the foot.  However if they
really want to shoot themselves in the foot, that's their call.

Anyway, users can always get at non-exported functions using ":::".

cheers,

Rolf Turner

-- 
Honorary Research Fellow
Department of Statistics
University of Auckland
Phone: +64-9-373-7599 ext. 88276



More information about the R-package-devel mailing list