From: Junio C Hamano <email@example.com> To: Christian Couder <firstname.lastname@example.org> Cc: Cornelius Schumacher <email@example.com>, git <firstname.lastname@example.org>, Josh Triplett <email@example.com> Subject: Re: [RFC] Proof of concept: Support multiple authors Date: Mon, 30 Jan 2017 12:48:52 -0800 Message-ID: <firstname.lastname@example.org> (raw) In-Reply-To: <CAP8UFD3=vaFupEDay-5vrMBwK_YJezysUUvySxnUUZxuW7m_WQ@mail.gmail.com> Christian Couder <email@example.com> writes: > I am just wondering if you have read and taken into account the > previous threads on this mailing list about the same subject, like for > example this one: > > https://public-inbox.org/git/CAOvwQ4i_HL7XGnxZrVu3oSnsbnTyxbg8Vh6vzi4c1isSrrexYQ@mail.gmail.com/ Thanks for a starting-point link. In that discussion, another discussion in the debian BTS is mentioned, https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=451880 which in turn has links to other, even earlier, discussions, but they are all gmane links so it would be harder for those who do not use its NNTP interface (which still works). Here are their modern counterparts ;-) https://public-inbox.org/git/?q=gmane:83880 https://public-inbox.org/git/?q=gmane:146223 https://public-inbox.org/git/?q=gmane:146886 The older discussions already cited the cost to update both in-tree and out-of-tree tools not to barf when they see such a commit object and one of the reason why we would not want to do this, and Ted Ts'o gave us another excellent reason why not to do multiple author header lines in a commit object header, i.e. "How often is that all of the authors are completely equal?" Another thing that I didn't see brought up was that it is not enough to ensure all existing tools are updated not to barf on a commit with multiple "author" line. You need to define what it means to have multiple authors and how they are treated by tools in a consistent way. Think "shortlog", for example. The tool may be able to be tweaked not to barf, and you may be able to add a random definition of which of the multiple authors to group a single commit under (the "random definition" could be "show that same commit multiple times, once for each author" or it could be "concatenate the authors to create a single header to list co-authored commits under, as if they were a single person", or it could be something equally bogus), but I do not think any single solution satisfies people's needs, and my gut feeling is that it is not worth to add tons of options and explain them to the end-users to support these random things that happen when there are multiple authors. Incidentally, there recently was a discussion on extending request-pull by adding a summary of commits by reviewers and testers. https://firstname.lastname@example.org/ I would imagine, if it is to be implemented, it would boil down to teaching shortlog that the "author" line in the commit object header is not the only thing that matters, and that it should optionally take notice of lines in the trailer block of the log message (e.g. perhaps "Co-Authored-by: " trailer suggested by $gmane/146223 above would help there). My advice to those who want to record credit to multiple authors is to treat the commit author line as recording the primary contact when there is a question on the commit and nothing else. Anything with richer semantics is better done in the trailer by enriching the support of trailer lines with interpret-trailers framework.
next prev parent reply index Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top 2017-01-29 18:06 Cornelius Schumacher 2017-01-30 17:56 ` Christian Couder 2017-01-30 19:33 ` Cornelius Schumacher 2017-01-30 20:48 ` Junio C Hamano [this message] 2017-01-31 0:54 ` Cornelius Schumacher
Reply instructions: You may reply publically to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style List information: http://vger.kernel.org/majordomo-info.html * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: link
email@example.com mailing list mirror (one of many) Archives are clonable: git clone --mirror https://public-inbox.org/git git clone --mirror http://ou63pmih66umazou.onion/git git clone --mirror http://czquwvybam4bgbro.onion/git git clone --mirror http://hjrcffqmbrq6wope.onion/git Newsgroups are available over NNTP: nntp://news.public-inbox.org/inbox.comp.version-control.git nntp://ou63pmih66umazou.onion/inbox.comp.version-control.git nntp://czquwvybam4bgbro.onion/inbox.comp.version-control.git nntp://hjrcffqmbrq6wope.onion/inbox.comp.version-control.git nntp://news.gmane.org/gmane.comp.version-control.git note: .onion URLs require Tor: https://www.torproject.org/ or Tor2web: https://www.tor2web.org/ AGPL code for this site: git clone https://public-inbox.org/ public-inbox