[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] trunk r116038: On VCS-independent ways of identifying comm
From: |
Eric S. Raymond |
Subject: |
[Emacs-diffs] trunk r116038: On VCS-independent ways of identifying commits, and why they are desirable. |
Date: |
Thu, 16 Jan 2014 05:51:16 +0000 |
User-agent: |
Bazaar (2.6b2) |
------------------------------------------------------------
revno: 116038
revision-id: address@hidden
parent: address@hidden
committer: Eric S. Raymond <address@hidden>
branch nick: trunk
timestamp: Thu 2014-01-16 00:50:26 -0500
message:
On VCS-independent ways of identifying commits, and why they are desirable.
No code changes.
modified:
Makefile.in makefile.in-20091113204419-o5vbwnq5f7feedwu-446
admin/ChangeLog changelog-20091113204419-o5vbwnq5f7feedwu-2226
admin/notes/commits cvslogs-20091113204419-o5vbwnq5f7feedwu-8580
=== modified file 'Makefile.in'
--- a/Makefile.in 2014-01-13 19:48:17 +0000
+++ b/Makefile.in 2014-01-16 05:50:26 +0000
@@ -385,6 +385,7 @@
cd $@ || exit; \
boot=bootstrap-emacs$(EXEEXT); \
[ ! -x "$$boot" ] || boot=''; \
+ echo "VCSWITNESS: $$vcswitness";\
$(MAKE) all $(MFLAGS) \
CC='${CC}' CFLAGS='${CFLAGS}' CPPFLAGS='${CPPFLAGS}' \
LDFLAGS='${LDFLAGS}' MAKE='${MAKE}' BOOTSTRAPEMACS="$$boot" \
=== modified file 'admin/ChangeLog'
--- a/admin/ChangeLog 2014-01-15 19:38:44 +0000
+++ b/admin/ChangeLog 2014-01-16 05:50:26 +0000
@@ -1,3 +1,8 @@
+2014-01-16 Eric S. Raymond <address@hidden>
+
+ * notes/commits: Add a 'graph on VCS-independent ways of
+ identifying commits and the desirability thereof.
+
2014-01-15 Paul Eggert <address@hidden>
Fix copyright license notices for Adobe Unicode mapping files.
=== modified file 'admin/notes/commits'
--- a/admin/notes/commits 2011-11-17 09:09:20 +0000
+++ b/admin/notes/commits 2014-01-16 05:50:26 +0000
@@ -45,6 +45,15 @@
for modern source-control systems with a global log, it's better to
have something like "Regenerate configure".
+(4) (Added in 2014) In commit comments, and ChangLog files, it is best
+ to use ways of identifying revisions that are not dependent on a
+ particular version control system. (At time of writing Emacs is
+ about to move to its third VCS and another move in the future is
+ not impossible.) An excellent way to identify commits 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:address@hidden". Often, "my
+ previous commit" will suffice.
Followup discussion:
http://lists.gnu.org/archive/html/emacs-devel/2010-01/msg00897.html
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] trunk r116038: On VCS-independent ways of identifying commits, and why they are desirable.,
Eric S. Raymond <=