From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Eric S. Raymond" Newsgroups: gmane.emacs.devel Subject: Re: Referring to revisions in the git future. Date: Wed, 29 Oct 2014 05:52:48 -0400 Organization: Eric Conspiracy Secret Labs Message-ID: <20141029095248.GA14601@thyrsus.com> References: <20141028223312.GB6630@acm.acm> <87fve7b6p7.fsf@fencepost.gnu.org> Reply-To: esr@thyrsus.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1414576422 7650 80.91.229.3 (29 Oct 2014 09:53:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 29 Oct 2014 09:53:42 +0000 (UTC) Cc: emacs-devel@gnu.org To: David Kastrup Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 29 10:53:37 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 1XjPwe-0005gW-Vs for ged-emacs-devel@m.gmane.org; Wed, 29 Oct 2014 10:53:37 +0100 Original-Received: from localhost ([::1]:44635 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XjPwe-0006G9-Hf for ged-emacs-devel@m.gmane.org; Wed, 29 Oct 2014 05:53:36 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41755) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XjPwW-00065P-H4 for emacs-devel@gnu.org; Wed, 29 Oct 2014 05:53:32 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XjPwS-0002XP-8d for emacs-devel@gnu.org; Wed, 29 Oct 2014 05:53:28 -0400 Original-Received: from static-71-162-243-5.phlapa.fios.verizon.net ([71.162.243.5]:56457 helo=snark.thyrsus.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XjPwN-0002Ws-KR; Wed, 29 Oct 2014 05:53:19 -0400 Original-Received: by snark.thyrsus.com (Postfix, from userid 1000) id EE13D382DAD; Wed, 29 Oct 2014 05:52:48 -0400 (EDT) Content-Disposition: inline In-Reply-To: <87fve7b6p7.fsf@fencepost.gnu.org> X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.5.21 (2010-09-15) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 71.162.243.5 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:175969 Archived-At: David Kastrup : > Just use the SHA1. Please *don't* use the SHA1. It's an opaque blob, not portable to any future VCS we may need to move to someday. It is better, and more human friendly, to refer to commits by their summary line, or by committer and date. About summary lines, a reminder: Please don't write the traditional GNUish run-on change comment with a semi-infinite number of bulleted items in it any more. We're no longer in CVS-land, commits are cheap, make them fine-grained. Git tools (and Mercurial tools, and it is a safe bet future DVCS tools as well) like there to be a short, self-contained summary line beginning the change comment. This makes the history easier to read in tools like gitk and hg view. If you can't express your intention in a short summary line, you should break up the change into smaller commits until you can. -- Eric S. Raymond