From gmbecker at ucdavis.edu  Tue Oct  6 23:39:30 2015
From: gmbecker at ucdavis.edu (Gabriel Becker)
Date: Tue, 6 Oct 2015 14:39:30 -0700
Subject: [Rd] authorship and citation
In-Reply-To: <CAJ=0CtAF--akTCjUocARtURD5GGxuUX55R+WXxyq=D2Tfn3HNg@mail.gmail.com>
References: <CAJ=0CtAKRSjo9yeVtN6ye4kHWZs3Yrf2DJMBscUbWTZRDCDvtg@mail.gmail.com>
	<5612EA11.7080805@statistik.tu-dortmund.de>
	<CAHyGmd7M_OZ3vtJzHBV_1AsHrB34tXD6-a8+wB87S8QpUhPRvw@mail.gmail.com>
	<5612FA28.2090607@statistik.tu-dortmund.de>
	<8B5956DE-4D87-4444-BC9D-AF96C04C4F7A@r-project.org>
	<CAJ=0CtAkV0uyeRjgRbOAdFzp4dfM9b_Q1+PqS2MfLBS492W94Q@mail.gmail.com>
	<CADwqtCPV3cFqSzXH5Wr-uWaSN0PZg_7cFddk-xyqrn5_SNpvSw@mail.gmail.com>
	<CAJ=0CtAF--akTCjUocARtURD5GGxuUX55R+WXxyq=D2Tfn3HNg@mail.gmail.com>
Message-ID: <CADwqtCO+72hW3xJp_tLq6Gb1EcbB+yP=ogEx_g8eBOU88XfLYw@mail.gmail.com>

Adrian,

Responses inline

On Tue, Oct 6, 2015 at 1:58 PM, Adrian Du?a <dusa.adrian at unibuc.ro> wrote:

> Hi Gabriel,
>
> On Tue, Oct 6, 2015 at 10:59 PM, Gabriel Becker <gmbecker at ucdavis.edu>
> wrote:
>
>> [...]
>>
>> At the very least, this is seems to be a flagrant violation of the
>> *spirit* of the CRAN policy, which AFAIK is intended to enforce
>> acknowledgement of the contributions of all copyright holders in the
>> package. The fact that you are trying to bypass the policy by suggesting
>> users use an unofficial citation which would not comply with the policy
>> while maintaining an official one which complies, but which you don't want
>> users to see  is probably a suggestion that you shouldn't do that.
>>
>
>
> But that is the very point: I read the CRAN policies twice, and there is
> no official guideline on how to compile the citation.
> Regarding the Source packages, the policies mention:
>

> ######
> The ownership of copyright and intellectual property rights of all
> components of the package must be clear and unambiguous (including from the
> authors specification in the DESCRIPTION file). Where code is copied (or
> derived) from the work of others (including from R itself), care must be
> taken that any copyright/license statements are preserved and authorship is
> not misrepresented.
> Preferably, an ?Authors at R? would be used with ?ctb? roles for the authors
> of such code. Alternatively, the ?Author? field should list these authors
> as contributors.
>
> Where copyrights are held by an entity other than the package authors,
> this should preferably be indicated via ?cph? roles in the ?Authors at R?
> field, or using a ?Copyright? field (if necessary referring to an
> inst/COPYRIGHTS file).
>
> Trademarks must be respected.
> ######
>
> Now, that requirement is already met: the former author is still in the
> authors' list. So the contribution of the former author is duly
> acknowledged, but the fundamental issue of my question related to the
> citation file, for which the CRAN policies doesn't offer any other
> information.
>

The citation mechanism, AFAIK, has two purposes. One is to associate a
published article/book/etc with an r package, where appropriate (and there
authorship and inclusion would need to meet the requirements of the
publishing journal). The other is to give a way for other works to cite the
work done in developing the package.

If you don't acknowledge that it is "heavily implied" that in the second
case all authors of the package should appear in the citation (this is
almost definitionally true of citations, I would think) I'm not really sure
what to tell you.

Approached from a different angle, what reason do you have for wanting the
other other to not appear in the citation for the package other than
minimizing/not acknowledging the copyright-holding work that he or she did
on the project?


>
> If the spirit of the CRAN policies is to enforce citing each and every one
> of the authors, then I don't understand why the citation from package Rcmdr
> meets this spirit, while my suggestion doesn't.
>

I don't have any knowledge of what Rcmdr does with regards to the citations
or the historical context that would make it relevant to the discussion
here.

>
> I apologize for pushing this topic to the limit, but I haven't got an
> answer to this question yet...
>

With respect, not receiving the answer you wanted isn't the same as not
receiving an answer.

Best,
~G


>
> Best wishes,
> Adrian
>
> PS: @Thierry: I did take a look at RODBC, but the citation information is
> generated automatically upon package installation (no other special file on
> CRAN)
>
> --
> Adrian Dusa
> University of Bucharest
> Romanian Social Data Archive
> Soseaua Panduri nr.90
> 050663 Bucharest sector 5
> Romania
>



-- 
Gabriel Becker, PhD
Computational Biologist
Bioinformatics and Computational Biology
Genentech, Inc.

	[[alternative HTML version deleted]]



[Rd] authorship and citation
Gabriel Becker