]> git.eshelyaron.com Git - emacs.git/commitdiff
* CONTRIBUTE: Don't recommend action stamps
authorNoam Postavsky <npostavs@gmail.com>
Fri, 25 Sep 2020 14:10:56 +0000 (16:10 +0200)
committerLars Ingebrigtsen <larsi@gnus.org>
Fri, 25 Sep 2020 14:10:56 +0000 (16:10 +0200)
* CONTRIBUTE: Remove mention of the "action stamp" thing (bug#20609).

CONTRIBUTE

index 4e42c7aafcc7d948fd18a5f7163ed64a7a434dea..cb09391c324175f3f143ae2230844e81029988e3 100644 (file)
@@ -257,13 +257,12 @@ them right the first time, so here are guidelines for formatting them:
 - There is no standard or recommended way to identify revisions in
   ChangeLog entries.  Using Git SHA1 values limits the usability of
   the references to Git, and will become much less useful if Emacs
-  switches to a different VCS.  So we recommend against that.
+  switches to a different VCS.  So we recommend against doing only that.
 
   One way to identify revisions is by quoting their summary line.
-  Another is with an action stamp - an RFC3339 date followed by !
-  followed by the committer's email - for example,
-  "2014-01-16T05:43:35Z!esr@thyrsus.com".  Often, "my previous commit"
-  will suffice.
+  Prefixing the summary with the commit date can give useful context
+  (use 'git show -s "--pretty=format:%cd \"%s\"" --date=short HASH' to
+  produce that).  Often, "my previous commit" will suffice.
 
 - There is no need to mention files such as NEWS and MAINTAINERS, or
   to indicate regeneration of files such as 'lib/gnulib.mk', in the