From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: PROPOSAL: Move to git, now that bzr is no longer a req. Date: Mon, 06 Jan 2014 12:59:55 +0900 Message-ID: <87txdhiwuc.fsf@uwakimon.sk.tsukuba.ac.jp> References: <20140102095347.6834E381D0C@snark.thyrsus.com> <87fvp6bdd9.fsf_-_@ktab.red-bean.com> <8761q1ljny.fsf@gmail.com> <20140103175006.GE17261@thyrsus.com> <87iou0t72n.fsf@bzg.ath.cx> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Trace: ger.gmane.org 1388980828 11433 80.91.229.3 (6 Jan 2014 04:00:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 6 Jan 2014 04:00:28 +0000 (UTC) Cc: Bastien , esr@thyrsus.com, emacs-devel@gnu.org, thierry.volpiatto@gmail.com To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jan 06 05:00:30 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1W01Mb-0005PI-Rj for ged-emacs-devel@m.gmane.org; Mon, 06 Jan 2014 05:00:29 +0100 Original-Received: from localhost ([::1]:60527 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W01Mb-0002EK-G7 for ged-emacs-devel@m.gmane.org; Sun, 05 Jan 2014 23:00:29 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33752) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W01MO-0002Dp-Qf for emacs-devel@gnu.org; Sun, 05 Jan 2014 23:00:24 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1W01MH-0005v3-HB for emacs-devel@gnu.org; Sun, 05 Jan 2014 23:00:16 -0500 Original-Received: from mgmt2.sk.tsukuba.ac.jp ([130.158.97.224]:52802) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W01M7-0005bL-1p; Sun, 05 Jan 2014 22:59:59 -0500 Original-Received: from uwakimon.sk.tsukuba.ac.jp (uwakimon.sk.tsukuba.ac.jp [130.158.99.156]) by mgmt2.sk.tsukuba.ac.jp (Postfix) with ESMTP id 078F3970863; Mon, 6 Jan 2014 12:59:56 +0900 (JST) Original-Received: by uwakimon.sk.tsukuba.ac.jp (Postfix, from userid 1000) id EDFBF1A2E7D; Mon, 6 Jan 2014 12:59:55 +0900 (JST) In-Reply-To: X-Mailer: VM undefined under 21.5 (beta34) "kale" 2a0f42961ed4 XEmacs Lucid (x86_64-unknown-linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 130.158.97.224 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:167435 Archived-At: Richard Stallman writes: > I think it is best for commit messages to be brief high-level > summaries of the changes, and put the details only in ChangeLog. This violates the "don't repeat yourself" principle to some extent, and conflicts with habits formed in other projects. Some projects don't have ChangeLogs (or don't bother about commit messages, but that's very rare), so the preferred format gets all data, usually with some convention about a single line that *identifies* the commit, but may not be a full "executive summary". (For those who know Darcs, think "patch name".) I also get the feeling that a lot of committers feel that they receive ambiguous, even conflicting, advice about commit message and ChangeLog entries (eg, "follow the GNU Coding Standard" vs. "here's how you should do it" if Florian's characterization is correct). > I think that these two forms of desription complement each other > and that it is useful to have both available. There's absolutely no reason why both can't be in a single "place". The implementation in commit messages could be done via a VCS feature like "git notes" (resp, a special log formatter -- Jordi says Mercurial has a whole template language that can be used in logs), so you don't see the detail unless you ask for notes (resp, the verbose form). It could be done via a log-viewer Emacs mode. But as Eric says, this is not the thread to discuss that, because it changes workflow.