Provide keyword support for git.
-
$Id$ : Commit hash ( this is natively supported ) -
$Source$ : Fully-qualified filename -
$Date$ : Commit date as YYYY-MM-DD HH:MM:SS TZ -
$Auth$ : Commit author -
$File$ : filename -
$Log$ : Last 3 commit dates each followed by the log message -
$MyId$ : Repo name and combination of above
- Define each file extension to support keywords in
.gitattributes*.EXT ident # converts $Id$ supported by git natively *.EXT filter=kw # converts other keywords - Add to
.gitconfig
[filter "kw"]
smudge = gitkwexpand %f
clean = gitkwshrink
- Load supporting aliases and functions
source git-kw.plugin.zsh
- After committing changes, run:
guk# (stands for git update keywords)
- This updates working files with new keyword values.
- keywords.txt contains sample output
#ident "$Id: 5ff8003c5cbdd879788741c7b6cb72f227244da2 $"
#ident "$MyId: git-kw 2022-03-12 15:44:36 -0500 (HEAD -> main, origin/main, origin/HEAD) 9d716d7 $"
#ident "$Source: /Users/rwmitchell/git/RWM/git-kw $"
#ident "$Date: 2022-03-12 15:44:36 -0500 $"
#ident "$Auth: Richard Mitchell <name@host.com> $"
#ident "$File: keywords.txt $"
I have used various version control programs over the years.
sccs -> cvs -> hg -> git
The initial programs supported keywords and have been using them ever since, despite more intelligent programmers saying they are not productive.
My programs have an option to output version info using the above keywords.
Knowing the date when source code was committed for a program is an easy way to know how current it is.
The rest is just vanity.