From benjamin.hofner at imbe.med.uni-erlangen.de  Mon Aug 26 17:52:57 2013
From: benjamin.hofner at imbe.med.uni-erlangen.de (Benjamin Hofner)
Date: Mon, 26 Aug 2013 17:52:57 +0200
Subject: [Rd] legitimate use of :::
In-Reply-To: <CABdHhvE7cym=D9nWSynW6U-c6YddDm7Q0sVbZp+5vY-LuBt3NQ@mail.gmail.com>
References: <mailman.25.1377252007.21998.r-devel@r-project.org>
	<521B4F6C.3090101@imbe.med.uni-erlangen.de>
	<521B6A8A.7040307@gmail.com>
	<CABdHhvE7cym=D9nWSynW6U-c6YddDm7Q0sVbZp+5vY-LuBt3NQ@mail.gmail.com>
Message-ID: <521B79D9.8040803@imbe.med.uni-erlangen.de>

Am 26.08.2013 17:38, schrieb Hadley Wickham:
>> I would say that you should certainly state it in the man page, and have
>> something in the DESCRIPTION file as well.  It might be something like
>>
>> Author:  Duncan Murdoch, with code from others (see the man pages)
>>
>> However, I just looked at rgl (a package I maintain), and I see we didn't do
>> that.  We have a separate README file listing other credits.
>
> The feedback that I've been getting from CRAN maintainers lately is
> that you have to include all source code contributors in the authors
> field.
>
> Hadley

I read these mails as well when I was looking for a good way to document 
code contributions. However, it seems to be nonsense to me, especially 
if you really just duplicate a simple function such as the n.knots. Next 
time I just "rewrite" the function (which doesn't seem to be good 
practice as well).

Well, on the other hand it reads nice to have R Core as contributing 
authors in my package(s)...

Perhaps a new field in DESCRIPTION and a standardized way how to name 
authors of functions one has duplicated would save a lot of the hassle? 
I could imagine a field that requires the structure:

Contributions:
   function (pkg): Authors

e.g.

   n.knots (stats): R Core

(perhaps with an added LICENSE "field")

Benjamin
-- 
******************************************************************************
Dr. rer. nat. Benjamin Hofner

Institut f?r Medizininformatik, Biometrie und Epidemiologie
Friedrich-Alexander-Universit?t Erlangen-N?rnberg
Waldstr. 6 - 91054 Erlangen - Germany

Tel: +49-9131-85-22707
Fax: +49-9131-85-25740

Office:
   Room 3.036
   Universit?tsstra?e 22
   (Entrance at the left side of the building)

benjamin.hofner at fau.de

http://www.imbe.med.uni-erlangen.de/cms/benjamin_hofner.html
http://www.benjaminhofner.de



[Rd] legitimate use of :::
Benjamin Hofner