How do I determine the correct git config setting to use in the global config file from an option name?

Question

I want to use the '--compaction-heuristic' option in my global git config file. It's an option of the git log command:

--compaction-heuristic

--no-compaction-heuristic

These are to help debugging and tuning an experimental heuristic (which is off by default) that shifts the hunk boundary in an attempt to make the resulting patch easier to read.

The git config documentation suggests adding config settings like this example:

git config --global core.editor emacs

There doesn't appear to be anything in the git log documentation that states what this config value should be - so what is it and where would I find the specification that explains the format of the line:

git config --global [magic to enable compaction-heuristic here]

This git feature has now been removed anyway

Answer 1

It seems to be an option under diff.

git config --global diff.compactionHeuristic true

BTW this is an option of git diff.

Reference (diff config): https://github.com/git/git/blob/5580b271af518bae30148edfd42cc8459d8da384/Documentation/diff-config.txt#L169-L172

Answer 2

According to this blog post:

This new heuristic is still experimental, and may change in the future, or even become the default. For now, you can enable it with the --compaction-heuristic option on the command line, or by setting diff.compactionHeuristic in your git config.

If you prefer, you can also create an alias for the git log command with your favorite flags:

git config --global alias.log1 "log --decorate=short --oneline --compaction-heuristic"

And use your new alias:

git log1