From bebc7fa3f00e9e9d11db488bef6a76836ac6730c Mon Sep 17 00:00:00 2001 From: Eric Sunshine Date: Wed, 31 Dec 2014 23:41:37 -0500 Subject: 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 Signed-off-by: Alberto Bertogli --- sample.conf | 9 +++++++++ 1 file changed, 9 insertions(+) (limited to 'sample.conf') 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 -- cgit v1.2.3