From: "Eric S. Raymond" <esr@thyrsus.com>
To: Paul Eggert <eggert@cs.ucla.edu>
Cc: Emacs developers <emacs-devel@gnu.org>
Subject: Re: Use of "Action stamps" in commit messages
Date: Fri, 13 Jul 2018 14:15:20 -0400 [thread overview]
Message-ID: <20180713181520.GD28072@thyrsus.com> (raw)
In-Reply-To: <85f9a968-ba72-5b00-761e-a4449b073a7f@cs.ucla.edu>
Paul Eggert <eggert@cs.ucla.edu>:
> Eric Raymond designed that format, partly to be robust in the presence
> of VC backend changes. I'll send this message to him directly, to give
> him a heads-up, as this has been a long thread that he's likely tuned
> out of.
>
> On 07/13/2018 04:13 AM, Noam Postavsky wrote:
> > .On 12 July 2018 at 11:34, Basil L. Contovounesios <contovob@tcd.ie> wrote:
> >
> >> from CONTRIBUTE:
> >>
> >> 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".
> > This reminds that I'd like to remove this "Action stamp" thing as
> > commit message convention. Action stamps are fine for what they were
> > designed for: acting as a unique commit id for the repository
> > conversion software "reposurgeon", but they are not very friendly to
> > human readers.
> >
> > A date followed by the summary line is sufficient to identify a commit
> > in a vc system agnostic way, reads nicer, and gives more info up front
> > to a human.
> >
> > See also Bug#20609.
> >
> > https://debbugs.gnu.org/cgi/bugreport.cgi?bug=20609
If you're going to do this, please at least have mercy on future translators
and use a strict RFC3339 date format the way action stamps do.
I'm against this change because I think in the long term. Someday Emacs
will change VCSes again. On the day, whoever is charged with the move is
going to curse the perpetrators if he has to deal with a semi-infinite number
of variant ways of pasting together the data and commit parts of your
proposed IDs.
I know of two efforts underway to make cgit and git itself aware of the
action-stamp format. Have patience. Soon enough you'll be able to treat
action stampts as hotlinks that your software will chase for you.
--
<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>
My work is funded by the Internet Civil Engineering Institute: https://icei.org
Please visit their site and donate: the civilization you save might be your own.
next prev parent reply other threads:[~2018-07-13 18:15 UTC|newest]
Thread overview: 26+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-07-13 9:13 Use of "Action stamps" in commit messages (WAS: [Emacs-diffs] master babe0d4: Rearrange definition of zerop in subr.el) Noam Postavsky
2018-07-13 12:01 ` Eli Zaretskii
2018-07-13 12:59 ` Use of "Action stamps" in commit messages Andy Moreton
2018-07-13 13:45 ` Eli Zaretskii
2018-07-13 15:01 ` Andy Moreton
2018-07-13 15:05 ` Eli Zaretskii
2018-07-13 17:07 ` Radon Rosborough
2018-07-13 17:24 ` Yuri Khan
2018-07-13 17:30 ` Radon Rosborough
2018-07-13 17:38 ` Eli Zaretskii
2018-07-13 17:34 ` Eli Zaretskii
2018-07-13 18:17 ` John Yates
2018-07-13 18:48 ` Eli Zaretskii
2018-07-13 15:25 ` Paul Eggert
2018-07-13 18:15 ` Eric S. Raymond [this message]
2018-07-13 18:59 ` Eli Zaretskii
2018-07-13 19:06 ` Eric S. Raymond
2018-07-13 19:30 ` Eli Zaretskii
2018-07-13 20:10 ` Paul Eggert
2018-07-13 20:47 ` Eric S. Raymond
2018-07-14 7:08 ` Eli Zaretskii
2018-07-14 14:38 ` Paul Eggert
2018-07-14 15:48 ` Eli Zaretskii
2018-07-14 9:49 ` Andy Moreton
2018-07-14 2:45 ` Noam Postavsky
2018-07-14 2:51 ` Brett Gilio
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180713181520.GD28072@thyrsus.com \
--to=esr@thyrsus.com \
--cc=eggert@cs.ucla.edu \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).