git-follow(1)

git-follow follows lifetime changes of a pathspec in Git, providing a simplified log and patch diff.

Table of Contents

• Installation
  • Homebrew
  • Manual
• Configuration
• Options
• Notes
• Examples
• See Also

Installation

You can install git-follow via Homebrew or manually.

Homebrew

brew tap nickolasburr/pfa
brew install git-follow

Manual

git clone https://github.com/nickolasburr/git-follow.git
cd git-follow
make
make install

By default, files are installed to /usr/local. You can install to an alternate location by passing PREFIX to make install.

For example, make install PREFIX=$HOME/.usr/local.

Configuration

Configuration values set via git-config(1) can be used to customize the behavior of git-follow.

• follow.diff.mode: Diff mode. Choices are inline (default), sxs, and colorsxs. See --word-diff of git-log(1).
• follow.log.format: Log format. See --format of git-log(1) for syntax.
• follow.pager.disable: Disable pager. Defaults to false. Set to true to disable pager. See --no-pager of git(1).

Options

Options can be specified to provide more refined information. If no options are given, all applicable commits will be shown.

• --branch, -b <branch>: Show commits specific to a branch.
• --first, -f: Show first commit where Git initiated tracking of pathspec.
• --func, -F <funcname>: Show commits which affected function <funcname> in pathspec. See -L of git-log(1).
• --last, -l [<count>]: Show last <count> commits which affect pathspec. Omit <count> defaults to last commit.
• --lines, -L <start>[,<end>]: Show commits which affect lines <start> to <end>. Omit <end> defaults to EOF.
• --no-merges, -M: Show commits which have a maximum of one parent. See --no-merges of git-log(1).
• --no-patch, -N: Suppress diff output. See --no-patch of git-log(1).
• --no-renames, -O: Disable rename detection. See --no-renames of git-log(1).
• --pager, -p: Force pager when invoking git-log(1). Overrides follow.pager.disable config value.
• --pickaxe, -P <string>: Show commits which change the # of occurrences of <string>. See -S of git-log(1).
• --range, -r <start>[,<end>]: Show commits in range <start> to <end>. Omit <end> defaults to HEAD.
• --reverse, -R: Show commits in reverse chronological order. See --walk-reflogs of git-log(1).
• --tag, -t <tag>: Show commits specific to a tag.
• --total, -T: Show total number of commits for pathspec.
• --usage, --help, -h: Show usage information.
• --version, -V: Show current version number.

Notes

Like standard Git builtins, git-follow supports an optional pathspec delimiter -- to help disambiguate options, option arguments, and refs from pathspecs.

Examples

Display commits on branch topic which affected blame.c

git follow --branch topic -- blame.c

Display first commit where Git initiated tracking of branch.c

git follow --first -- branch.c

Display last 5 commits which affected column.c

git follow --last 5 -- column.c

Display last commit where lines 5 through EOF were affected in diff.c

git follow --last --lines 5 -- diff.c

Display last 3 commits where lines 10 through 15 were affected in bisect.c

git follow --last 3 --lines 10,15 -- bisect.c

Display commits where function funcname was affected in archive.c

git follow --func funcname -- archive.c

Display commits in range from aa03428 to b354ef9 which affected worktree.c

git follow --range aa03428,b354ef9 -- worktree.c

Display commits in range from tag v1.5.3 to tag v1.5.4 which affected apply.c

git follow --range v1.5.3,v1.5.4 -- apply.c

Display commits up to tag v1.5.3 which affected graph.c

git follow --tag v1.5.3 -- graph.c

Display total number of commits which affected rebase.c

git follow --total -- rebase.c

See Also

git(1), git-branch(1), git-check-ref-format(1), git-config(1), git-diff(1), git-log(1), git-remote(1), gitrevisions(1), git-tag(1)