Message-ID: <CACr7k5+-ZABSt-Qpphca=UkXJ=qr95WVa1nOWbfJr_Jg-YxS6Q@mail.gmail.com>
Date: 2024-12-19T14:48:35Z
From: Jose Barrera-Gómez
Subject: [R-pkg-devel] Changes in function call with respect to the current published version
In-Reply-To: <96f1a281-587d-4a83-be8b-b9da11a95215@mcmaster.ca>
Hi Georgi, Uri, John and List,
Thank you, that was very helpful!
Kind regards
Jose Barrera
Statistician, Associate Lecturer
*IS**Global*
Barcelona Institute for Global Health - Campus MAR
Barcelona Biomedical Research Park (PRBB) (Room Hypatia)
Doctor Aiguader, 88
08003 Barcelona, Spain
Tel. +34 93 2147383
jose.barrera at isglobal.org
<https://www.linkedin.com/in/josebarrera>
Personal website: sites.google.com/view/josebarrera
www.isglobal.org
This message is intended exclusively for its addressee and may contain
information that is CONFIDENTIAL and protected by professional privilege.
If you are not the intended recipient you are hereby notified that any
dissemination, copy or disclosure of this communication is strictly
prohibited by law. If this message has been received in error, please
immediately notify us via e-mail and delete it.
DATA PROTECTION. We inform you that your personal data, including your
e-mail address and data included in your email correspondence, are included
in the ISGlobal Foundation filing system. Your personal data will be used
for the purpose of contacting you and sending information on the activities
of the above foundations. You can exercise your rights to access to
personal data, rectification, erasure, restriction of processing, data
portability and object by contacting the following address: *lopd at isglobal.org
<lopd at isglobal.org>*. ISGlobal Privacy Policy at *www.isglobal.org
<http://www.isglobal.org/>*.
-----------------------------------------------------------------------------------------------------------------------------
CONFIDENCIALIDAD. Este mensaje y sus anexos se dirigen exclusivamente a su
destinatario y puede contener informaci?n confidencial, por lo que la
utilizaci?n, divulgaci?n y/o copia sin autorizaci?n est? prohibida por la
legislaci?n vigente. Si ha recibido este mensaje por error, le rogamos lo
comunique inmediatamente por esta misma v?a y proceda a su destrucci?n.
PROTECCI?N DE DATOS. Sus datos de car?cter personal utilizados en este
env?o, incluida su direcci?n de e-mail, forman parte de ficheros de
titularidad de la Fundaci?n ISGlobal para cualquier finalidades de
contacto, relaci?n institucional y/o env?o de informaci?n sobre sus
actividades. Los datos que usted nos pueda facilitar contestando este
correo quedar?n incorporados en los correspondientes ficheros, autorizando
el uso de su direcci?n de e-mail para las finalidades citadas. Puede
ejercer los derechos de acceso, rectificaci?n, supresi?n, limitaci?n del
tratamiento, portabilidad y oposici?n dirigi?ndose a *lopd at isglobal.org
<lopd at isglobal.org>* . Pol?tica de privacidad en *www.isglobal.org
<http://www.isglobal.org/>*.
El mi?, 18 dic 2024 a las 18:37, John Fox (<jfox at mcmaster.ca>) escribi?:
> Dear Jose,
>
> On 2024-12-18 10:26 a.m., John Fox wrote:
> > Caution: External email.
> >
> >
> > Dear Jose,
> >
> > Assuming that you can fix the bugs in the original function, one
> > approach would be to make myfun() generic, say myfun <- function(y, ...)
> > UseMethod("myfun"), with the (fixed) original myfun() as the default
> > method and a new function method, which would probably set up a call to
>
> That should read "a new formula method" (not "a new function method").
>
> Sorry for the confusion,
> John
>
> > the default method. Then existing code wouldn't break and users would
> > have the option of using a formula.
> >
> > I hope this helps,
> > John
> > --
> > John Fox, Professor Emeritus
> > McMaster University
> > Hamilton, Ontario, Canada
> > web: https://www.john-fox.ca/
> > --
> >
> > On 2024-12-17 4:00 p.m., Jose Barrera-G?mez wrote:
> >> [You don't often get email from jose.barrera at isglobal.org. Learn why
> >> this is important at https://aka.ms/LearnAboutSenderIdentification ]
> >>
> >> Caution: External email.
> >>
> >>
> >> Dear List,
> >>
> >> I have a package that works in the context of regression models. The
> main
> >> function has arguments (y, x, z, data, ...), where y is the response
> >> variable, x is the explanatory variable and z can be other covariates.
> >>
> >> Due to some bugs, I am interested in changing the call from (y, x, z,
> >> data,
> >> ...) to (formula, data, ...).
> >>
> >> For instance, current usage is
> >>
> >> myfun(y = birthweight, x = cotinine, z = age, data = mydata, ...)
> >>
> >> and new usage would be
> >>
> >> myfun(formula = birthweight ~ cotinine + age, data = mydata, ...)
> >>
> >> This change would have no impact on the usage for the rest of the
> >> package.
> >>
> >> My concern is that users updating the package won't be able to reproduce
> >> old analyses. I.e. they would need to update the calls to myfun (but
> >> nothing else related to the usage of other functions or methods).
> >>
> >> I think the new usage would result in some advantages and bugs fixing
> and
> >> only the disadvantage I mentioned just above.
> >>
> >> I would appreciate advice on:
> >>
> >> 1) There could be other disadvantages for users of previous versions
> >> that I
> >> don't see?
> >>
> >> 2) What would be the best location(s) in the documentation to explain in
> >> detail this change?
> >>
> >> Thanks in advance,
> >>
> >> Jose Barrera
> >> Statistician, Associate Lecturer
> >>
> >> *IS**Global*
> >> Barcelona Institute for Global Health - Campus MAR
> >> Barcelona Biomedical Research Park (PRBB) (Room Hypatia)
> >>
> >> Doctor Aiguader, 88
> >> 08003 Barcelona, Spain
> >> Tel. +34 93 2147383
> >> jose.barrera at isglobal.org
> >> <https://www.linkedin.com/in/josebarrera>
> >> Personal website: sites.google.com/view/josebarrera
> >> www.isglobal.org
> >>
> >> This message is intended exclusively for its addressee and may contain
> >> information that is CONFIDENTIAL and protected by professional
> privilege.
> >> If you are not the intended recipient you are hereby notified that any
> >> dissemination, copy or disclosure of this communication is strictly
> >> prohibited by law. If this message has been received in error, please
> >> immediately notify us via e-mail and delete it.
> >>
> >> DATA PROTECTION. We inform you that your personal data, including your
> >> e-mail address and data included in your email correspondence, are
> >> included
> >> in the ISGlobal Foundation filing system. Your personal data will be
> used
> >> for the purpose of contacting you and sending information on the
> >> activities
> >> of the above foundations. You can exercise your rights to access to
> >> personal data, rectification, erasure, restriction of processing, data
> >> portability and object by contacting the following address:
> >> *lopd at isglobal.org
> >> <lopd at isglobal.org>*. ISGlobal Privacy Policy at *www.isglobal.org
> >> <http://www.isglobal.org/>*.
> >>
> >>
> >>
> -----------------------------------------------------------------------------------------------------------------------------
> >>
> >> CONFIDENCIALIDAD. Este mensaje y sus anexos se dirigen exclusivamente
> >> a su
> >> destinatario y puede contener informaci?n confidencial, por lo que la
> >> utilizaci?n, divulgaci?n y/o copia sin autorizaci?n est? prohibida por
> la
> >> legislaci?n vigente. Si ha recibido este mensaje por error, le rogamos
> lo
> >> comunique inmediatamente por esta misma v?a y proceda a su destrucci?n.
> >>
> >> PROTECCI?N DE DATOS. Sus datos de car?cter personal utilizados en este
> >> env?o, incluida su direcci?n de e-mail, forman parte de ficheros de
> >> titularidad de la Fundaci?n ISGlobal para cualquier finalidades de
> >> contacto, relaci?n institucional y/o env?o de informaci?n sobre sus
> >> actividades. Los datos que usted nos pueda facilitar contestando este
> >> correo quedar?n incorporados en los correspondientes ficheros,
> >> autorizando
> >> el uso de su direcci?n de e-mail para las finalidades citadas. Puede
> >> ejercer los derechos de acceso, rectificaci?n, supresi?n, limitaci?n del
> >> tratamiento, portabilidad y oposici?n dirigi?ndose a *lopd at isglobal.org
> >> <lopd at isglobal.org>* . Pol?tica de privacidad en *www.isglobal.org
> >> <http://www.isglobal.org/>*.
> >>
> >> --
> >>
> >>
> >> This message is intended exclusively for its addressee and may contain
> >> information that is CONFIDENTIAL and protected by professional
> privilege.
> >> If
> >> you are not the intended recipient you are hereby notified that any
> >> dissemination, copy or disclosure of this communication is strictly
> >> prohibited
> >> by law. If this message has been received in error, please
> >> immediately notify
> >> us via e-mail and delete it.
> >>
> >>
> >>
> >> DATA PROTECTION. We
> >> inform you that your personal data, including your
> >> e-mail address and data
> >> included in your email correspondence, are included in
> >> the ISGlobal
> >> Foundation files. Your personal data will be used for the purpose
> >> of
> >> contacting you and sending information on the activities of the above
> >> foundations. You can exercise your rights of access, rectification,
> >> cancellation and opposition by contacting the following address:
> >> lopd at isglobal.org <mailto:lopd at isglobal.org>. ISGlobal
> >> Privacy Policy at
> >> www.isglobal.org <http://www.isglobal.org/>.
> >>
> >>
> >>
> >>
> -----------------------------------------------------------------------------------------------------------------------------
> >>
> >> CONFIDENCIALIDAD. Este mensaje y sus anexos se dirigen exclusivamente a
> >> su
> >> destinatario y puede contener informaci?n confidencial, por lo que la
> >> utilizaci?n,
> >> divulgaci?n y/o copia sin autorizaci?n est? prohibida por la
> >> legislaci?n
> >> vigente. Si ha recibido este mensaje por error, le rogamos lo
> >> comunique
> >> inmediatamente por esta misma v?a y proceda a su destrucci?n.
> >>
> >>
> >>
> >>
> >>
> >>
> >>
> >>
> >>
> >> PROTECCI?N DE DATOS. Sus datos de car?cter personal utilizados en este
> >> env?o, incluida su direcci?n de e-mail, forman parte de ficheros de
> >> titularidad
> >> de la Fundaci?n ISGlobal para cualquier
> >> finalidades de
> >> contacto, relaci?n institucional y/o env?o de informaci?n sobre
> >> sus
> >> actividades. Los datos que usted nos pueda facilitar contestando este
> >> correo quedar?n incorporados en los correspondientes ficheros,
> >> autorizando
> >> el
> >> uso de su direcci?n de e-mail para las finalidades citadas. Puede
> >> ejercer los
> >> derechos de acceso, rectificaci?n, cancelaci?n y oposici?n
> >> dirigi?ndose a lopd at isglobal.org <mailto:lopd at isglobal.org>* *.
> >> Pol?tica de
> >> privacidad
> >> en www.isglobal.org <http://www.isglobal.org/>.
> >>
> >> [[alternative HTML version deleted]]
> >>
> >> ______________________________________________
> >> R-package-devel at r-project.org mailing list
> >> https://stat.ethz.ch/mailman/listinfo/r-package-devel
> >
> > ______________________________________________
> > R-package-devel at r-project.org mailing list
> > https://stat.ethz.ch/mailman/listinfo/r-package-devel
>
>
>
--
This message is intended exclusively for its addressee and may contain
information that is CONFIDENTIAL and protected by professional privilege.
If
you are not the intended recipient you are hereby notified that any
dissemination, copy or disclosure of this communication is strictly
prohibited
by law. If this message has been received in error, please
immediately notify
us via e-mail and delete it.
DATA PROTECTION. We
inform you that your personal data, including your
e-mail address and data
included in your email correspondence, are included in
the ISGlobal
Foundation files. Your personal data will be used for the purpose
of
contacting you and sending information on the activities of the above
foundations. You can exercise your rights of access, rectification,
cancellation and opposition by contacting the following address:
lopd at isglobal.org <mailto:lopd at isglobal.org>. ISGlobal
Privacy Policy at
www.isglobal.org <http://www.isglobal.org/>.
-----------------------------------------------------------------------------------------------------------------------------
CONFIDENCIALIDAD. Este mensaje y sus anexos se dirigen exclusivamente a
su
destinatario y puede contener informaci?n confidencial, por lo que la
utilizaci?n,
divulgaci?n y/o copia sin autorizaci?n est? prohibida por la
legislaci?n
vigente. Si ha recibido este mensaje por error, le rogamos lo
comunique
inmediatamente por esta misma v?a y proceda a su destrucci?n.
PROTECCI?N DE DATOS. Sus datos de car?cter personal utilizados en este
env?o, incluida su direcci?n de e-mail, forman parte de ficheros de
titularidad
de la Fundaci?n ISGlobal? para cualquier
finalidades de
contacto, relaci?n institucional y/o env?o de informaci?n sobre
sus
actividades. Los datos que usted nos pueda facilitar contestando este
correo quedar?n incorporados en los correspondientes ficheros, autorizando
el
uso de su direcci?n de e-mail para las finalidades citadas. Puede
ejercer los
derechos de acceso, rectificaci?n, cancelaci?n y oposici?n
dirigi?ndose a lopd at isglobal.org <mailto:lopd at isglobal.org>* *. Pol?tica de
privacidad
en www.isglobal.org <http://www.isglobal.org/>.
[[alternative HTML version deleted]]