This is the mail archive of the
mailing list for the binutils project.
Re: GDB attribution policy (Re: [PATCH v2 2/3] Add FreeBSD/mips architecture.)
- From: Pedro Alves <palves at redhat dot com>
- To: John Baldwin <jhb at FreeBSD dot org>, gdb-patches at sourceware dot org, binutils at sourceware dot org
- Date: Tue, 10 Jan 2017 16:18:52 +0000
- Subject: Re: GDB attribution policy (Re: [PATCH v2 2/3] Add FreeBSD/mips architecture.)
- Authentication-results: sourceware.org; auth=none
- References: <20161206210015.40422-1-jhb@FreeBSD.org> <20161206210015.40422-3-jhb@FreeBSD.org> <firstname.lastname@example.org>
FYI, I've added this to the wiki now:
On 12/16/2016 12:22 PM, Pedro Alves wrote:
> IMO, "contributed by" "written by", etc. attribution statements are best not
> added to source files, and are better placed in the "Contributors" node in
> the manual , which seems to exist exactly for this purpose.
> I see a few advantages:
> - It ends up surviving even if these new files are deleted in the future.
> - It's discoverable by end users too, unlike some comment deep in some
> source file.
> - Doesn't get inaccurate over time, as other contributors touch / rework / add
> to / mostly rewrite the code over the years, who understandably won't
> remember or won't feel comfortable with touching the original "written by"
> For similar reasons, a few years back, glibc explicitly stopped accepting
> attribution statements in sources, as can be seen in their version of the
> contribution checklist . I believe the discussion that led to that glibc
> policy started here .
> I've discussed this with other GDB maintainers off list and it seems
> there's general agreement to follow such a policy in GDB as well.
>  - https://sourceware.org/gdb/current/onlinedocs/gdb/Contributors.html#Contributors
>  - https://sourceware.org/glibc/wiki/Contribution%20checklist#Attribution
>  - https://sourceware.org/ml/libc-alpha/2012-04/msg00339.html