From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: git history tracking across renames (and emacs support) Date: Thu, 12 Jul 2018 20:37:46 +0300 Message-ID: <83o9fce4np.fsf@gnu.org> References: <87a7yn7tqp.fsf@lifelogs.com> <878te75xa1.fsf@lifelogs.com> <87ind6l2tt.fsf@lifelogs.com> <877etklvsa.fsf@lifelogs.com> <83y3m0pv8u.fsf@gnu.org> <86608msw0h.fsf@dod.no> <838tdiet25.fsf@gnu.org> <87y3li4vh7.fsf@telefonica.net> <87efnan46u.fsf@linux-m68k.org> <86wp12qtgo.fsf@dod.no> <83tvw6chqv.fsf@gnu.org> <86shbprix7.fsf_-_@dod.no> <838t6jgl1k.fsf@gnu.org> <601m6cc6.fsf@lifelogs.com> <83o9fefnv9.fsf@gnu.org> <83d0vtfx4f.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1531416986 21470 195.159.176.226 (12 Jul 2018 17:36:26 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 12 Jul 2018 17:36:26 +0000 (UTC) Cc: tzz@lifelogs.com, larsi@gnus.org, emacs-devel@gnu.org To: Radon Rosborough Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jul 12 19:36:22 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fdfVt-0005US-NM for ged-emacs-devel@m.gmane.org; Thu, 12 Jul 2018 19:36:21 +0200 Original-Received: from localhost ([::1]:33315 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fdfY0-00070U-Rq for ged-emacs-devel@m.gmane.org; Thu, 12 Jul 2018 13:38:32 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49366) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fdfXL-00070B-F3 for emacs-devel@gnu.org; Thu, 12 Jul 2018 13:37:55 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fdfXH-0005LK-03 for emacs-devel@gnu.org; Thu, 12 Jul 2018 13:37:51 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:47645) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fdfXG-0005LG-Rt; Thu, 12 Jul 2018 13:37:46 -0400 Original-Received: from [176.228.60.248] (port=3109 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fdfXG-0006kw-4U; Thu, 12 Jul 2018 13:37:46 -0400 In-reply-to: (message from Radon Rosborough on Thu, 12 Jul 2018 11:03:09 -0600) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:227293 Archived-At: > From: Radon Rosborough > Date: Thu, 12 Jul 2018 11:03:09 -0600 > Cc: Ted Zlatanov , Lars Ingebrigtsen , emacs-devel > > > But if you have suggestions for clarifying CONTRIBUTE, please tell. > > I think that CONTRIBUTE needs to give a step-by-step guide for how to > generate a commit message with Magit, since Magit is certainly either > the most popular or second most popular version-control frontend for > Emacs. Is it really an issue with magit? And if it is, why isn't it documented in magit's documentation? > It should probably also provide a step-by-step guide for doing this > with VC. It is: in the Emacs manual. > As soon as I am linked to documentation about editing > ChangeLog files, I will assume I've gone astray, unless it's explained > why editing ChangeLog files is necessary in order to generate a commit > message. I don't understand why. How about providing detailed critique of what CONTRIBUTE says under "Generating ChangeLog entries"? > > I guess it depends on the projects. I contribute to several other > > projects, like GDB, Gawk, and Texinfo > > Well, those are all GNU projects. So I think that's the difference. It > seems to me that ChangeLog is a "GNU thing". As are mailing lists, > avoidance of GitLab, using debbugs, etc. Well, we are talking about Emacs, and Emacs will always be a GNU project. > > Like I said: free text log messages leave a lot of space for > > disagreement about what is and what isn't a good message. > > This is true, but it seems to me that we already have this problem. Not IME, no. > After all, the current format doesn't say anything about how to > actually describe your change. It just tells you how to replicate the > diff in your commit message. Nevertheless, log messages provided by contributors are pretty close to what I'd like to see, after a couple of initial submissions, where we generally need to point out some minor nits. > By dropping the format, we would only be losing the replicated diff > information; we wouldn't be losing any directions on how to > communicate useful information that *can't* be auto-generated, > because there are no such instructions now. I guess you never had to deal with contributors who ask "where's that written" right away when you make some comment about their submission. That's how CONTRIBUTE was born in the first place. > > IME, new contributors want clear and concise instructions; telling > > them to read a long blog will definitely turn off many of them. > > I think the blog does a much better job of getting across its > information clearly, concisely, and understandably: It's too long, IMO. > Plus, everybody knows this already, since virtually every open-source > project follows more or less these guidelines for commit messages. If so, why would someone need to write a blog, and why would we need to point to it? Evidently not everybody knows that. > I only wish to push for an agreement that "if somebody were willing to > do the work to remove the ChangeLog format, then the patch would be > accepted". Otherwise, who is going to write a patch? I cannot answer that because I don't think I understand what is being proposed here. If the proposal is to let people write what they want, then I don't think I'd agree, for reasons I tried to explain.