mirror of
git://git.sv.gnu.org/emacs.git
synced 2025-12-06 06:20:55 -08:00
* CONTRIBUTE: Don't recommend action stamps
* CONTRIBUTE: Remove mention of the "action stamp" thing (bug#20609).
This commit is contained in:
parent
307b6f9353
commit
499848d840
1 changed files with 4 additions and 5 deletions
|
|
@ -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
|
- There is no standard or recommended way to identify revisions in
|
||||||
ChangeLog entries. Using Git SHA1 values limits the usability of
|
ChangeLog entries. Using Git SHA1 values limits the usability of
|
||||||
the references to Git, and will become much less useful if Emacs
|
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.
|
One way to identify revisions is by quoting their summary line.
|
||||||
Another is with an action stamp - an RFC3339 date followed by !
|
Prefixing the summary with the commit date can give useful context
|
||||||
followed by the committer's email - for example,
|
(use 'git show -s "--pretty=format:%cd \"%s\"" --date=short HASH' to
|
||||||
"2014-01-16T05:43:35Z!esr@thyrsus.com". Often, "my previous commit"
|
produce that). Often, "my previous commit" will suffice.
|
||||||
will suffice.
|
|
||||||
|
|
||||||
- There is no need to mention files such as NEWS and MAINTAINERS, or
|
- 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
|
to indicate regeneration of files such as 'lib/gnulib.mk', in the
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue