diff options
| author | Eric Sunshine <sunshine@sunshineco.com> | 2015-01-01 05:41:37 +0100 |
|---|---|---|
| committer | Alberto Bertogli <albertito@blitiri.com.ar> | 2015-01-11 22:18:22 +0100 |
| commit | bebc7fa3f00e9e9d11db488bef6a76836ac6730c (patch) | |
| tree | c9c6555e110c8f285d5daef190abffbc91657a81 /sample.conf | |
| parent | 9ef78aaffd9ca5100659b8737cbd41523be330e2 (diff) | |
| download | git-arr-fork-bebc7fa3f00e9e9d11db488bef6a76836ac6730c.zip | |
repo: diff: add option to show "creation event" diff for root commit
At its inception, Git did not show a "creation event" diff for a
project's root commit since early projects, such as the Linux kernel,
were already well established, and a large root diff was considered
uninteresting noise.
On the other hand, new projects adopting Git typically have small root
commits, and such a "creation event" is likely to have meaning, rather
than being pure noise. Consequently, git-diff-tree gained a --root flag
in dc26bd89 (diff-tree: add "--root" flag to show a root commit as a big
creation event, 2005-05-19), though it was disabled by default.
Displaying the root "creation event" diff, however, became the default
behavior when configuration option 'log.showroot' was added to git-log
in 0f03ca94 (config option log.showroot to show the diff of root
commits; 2006-11-23). And, gitk (belatedly) followed suit when it
learned to respect 'log.showroot' in b2b76d10 (gitk: Teach gitk to
respect log.showroot; 2011-10-04).
By default, these tools now all show the root diff as a "creation
event", however, git-arr suppresses it unconditionally. Resolve this
shortcoming by adding a new git-arr configuration option "rootdiff" to
control the behavior (enabled by default).
Signed-off-by: Eric Sunshine <sunshine@sunshineco.com>
Signed-off-by: Alberto Bertogli <albertito@blitiri.com.ar>
Diffstat (limited to 'sample.conf')
| -rw-r--r-- | sample.conf | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/sample.conf b/sample.conf index 705a022..f5e950a 100644 --- a/sample.conf +++ b/sample.conf @@ -11,6 +11,15 @@ path = /srv/git/repo/ # Useful to disable an expensive operation in very large repositories. #tree = yes +# Show a "creation event" diff for a root commit? (optional) +# For projects placed under revision control from inception, the root commit +# diff is often meaningful. However, in cases when a well established, large +# project is placed under revision control belatedly, the root commit may +# represent a lump import of the entire project, in which case such a +# "creation event" diff would likely be considered meaningless noise. +# Default: yes +#rootdiff = yes + # How many commits to show in the summary page (optional). #commits_in_summary = 10 |