Page MenuHomeFreeBSD

git-arc: vertically align tag values
AcceptedPublic

Authored by glebius on Tue, Dec 17, 8:41 PM.

Details

Summary

Force vertical alignment for the two tags that git-arc adds.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 61226
Build 58110: arc lint + arc unit

Event Timeline

glebius created this revision.

The change is a matter of taste, of course. So I decided to add all contributors to the script to create a kind of a vote. Anybody else using git-arc are also very welcome to join the review and vote their (dis)agreement.

It is fine by me, as long as it is also updated in:
https://cgit.freebsd.org/src/tree/tools/tools/git/hooks/prepare-commit-msg#n47
(and align all the trailers accordingly)

This revision is now accepted and ready to land.Tue, Dec 17, 9:57 PM

The tag we have been using in the commit logs back to the CVS days only has one tab after Reviewed by: and all our other tags like PR:, etc. are all aligned to the same width both here and in our commit log template, the format documented in the Committer's Guide, etc.. Note that only Differential Revision is further indented because its name is so long. We are probably going to change all the metadata lines to be hyphenated git-style trailers in the near future, and I don't think we should change this now given that.

E.g. see some a recent commit:

commit 6dafe8c1e46e58097b277ab9babb3ec5336713d7
Author: Muhammad Moinur Rahman <bofh@FreeBSD.org>
Date:   Tue Dec 10 18:24:43 2024 +0100

    Clean pkg cache in release media
    
    Recently wifi-firmware-kmod-release pkgs were added in the release
    installation media, but unfortunately the pkgs were not cleaned up after
    the installation. These kept the stale pkgs in the /var/cache. The pkgs
    should be removed with pkg clean.
    
    PR:             283112
    Reported by:    yanhui.he@broadcom.com
    Reviewed by:    cperciva, emaste
    Approved by:    cperciva, emaste, re (implicit)
    MFC after:      3 days
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D47942

Your change would mis-align the Reviewed by: tag there unless we change all of them to add an extra tab.