[R-pkg-devel] Inquiry

[Jeff Newmiller]

If you haven't settled on exactly which approach you want to use in accomplishing the main goals of your exported package functions, then hiding the gory details can make it easier to tell people later to sod off when you decide those gory details functions should act different or use different function signatures.

Anyone regularly using ::: earns the lack of reproducibility they get.

On September 27, 2022 6:37:28 PM PDT, Rolf Turner <r.turner using auckland.ac.nz> wrote:
>
>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
>

-- 
Sent from my phone. Please excuse my brevity.