Skip to content

Commit

Permalink
.git-blame-ignore-revs: change format to hash then info
Browse files Browse the repository at this point in the history
Command used to generate the entries in the new format:

    $ TZ=UTC0 git show --date='format-local:%Y-%m-%d' \
      --pretty='%H # %cd | %s' -s f43382f fe0f975

Put the committer date ("%cd") and commit message subject ("%s") as a
comment right after the commit hash ("%H").  The pipe ("|") is intended
to improve readability.

This format looks more similar to the output of `git log --oneline` and
should make it easier to visually parse long lists.  It also allows more
hashes to fit into the same amount of lines (at the cost of longer
lines).

Use committer date ("%cd") instead of author date ("%ad") as the former
tells when a commit actually landed on master.  This usually matches the
topological order, which should make it easier to verify that all of the
relevant commits are listed (and that there are no extraneous commits).

Use --date + "%cd" instead of just "%ci" because the former can be used
to ensure that the date is always printed in the same timezone (UTC).
  • Loading branch information
kmk3 committed Sep 19, 2022
1 parent 9ffef72 commit 7178981
Showing 1 changed file with 13 additions and 4 deletions.
17 changes: 13 additions & 4 deletions .git-blame-ignore-revs
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
# Revert "move whitelist/blacklist to allow/deny"
f43382f1e9707b4fd5e63c7bfe881912aa4ee994
# move whitelist/blacklist to allow/deny
fe0f975f447d59977d90c3226cc8c623b31b20b3
# Note: Entries (and sections) should be listed in topological order (that is,
# in the same order that is shown by `git log --oneline`) and they can be
# generated with one of the following commands:
#
# TZ=UTC0 git show --date='format-local:%Y-%m-%d' --pretty='%H # %cd | %s' -s
# [<commit>...]
#
# TZ=UTC0 git log --date='format-local:%Y-%m-%d' --pretty='%H # %cd | %s'
# [<revision-range>]

# "move whitelist/blacklist to allow/deny"
f43382f1e9707b4fd5e63c7bfe881912aa4ee994 # 2021-07-18 | Revert "move whitelist/blacklist to allow/deny"
fe0f975f447d59977d90c3226cc8c623b31b20b3 # 2021-07-05 | move whitelist/blacklist to allow/deny

0 comments on commit 7178981

Please sign in to comment.