Re* [PATCH] grep: clarify what `grep.patternType=default` means
From: Junio C Hamano <hidden>
Date: 2021-12-05 20:25:13
Johannes Altmanninger [off-list ref] writes:
On Mon, Nov 29, 2021 at 02:10:48PM -0800, Junio C Hamano wrote:quoted
Back in the days when the "return to the default matching behavior" part was written in 84befcd0 (grep: add a grep.patternType configuration setting, 2012-08-03), grep.extendedRegexp was the only way to configure the behaviour since b22520a3 (grep: allow -E and -n to be turned on by default via configuration, 2011-03-30).The 'the "return to the default matching behavior" part' is a forward reference, so I tried this instead: Commit 84befcd0 (grep: add a grep.patternType configuration setting, 2012-08-03) documented that grep.patternType=default falls back to the "default matching behavior". Prior to that, grep.extendedRegexp was the only way to configure the matching behavior (since b22520a3 (grep: allow -E and -n to be turned on by default via configuration, 2011-03-30)).quoted
It was understandable that we referred to the behaviour that honors"It was" -> "It is"?quoted
the older configuration variable as "the default matching" behaviour. It is fairly clear in its log message:I guess %s/behaviour/behavior/
Let me steal that.
quoted
diff --git a/Documentation/config/grep.txt b/Documentation/config/grep.txt index 44abe45a7c..72f5e03614 100644 --- a/Documentation/config/grep.txt +++ b/Documentation/config/grep.txt@@ -8,7 +8,8 @@ grep.patternType:: Set the default matching behavior. Using a value of 'basic', 'extended', 'fixed', or 'perl' will enable the `--basic-regexp`, `--extended-regexp`, `--fixed-strings`, or `--perl-regexp` option accordingly, while the - value 'default' will return to the default matching behavior. + value 'default' will use the settings of `grep.extendedRegexp` option + to choose between `basic` and `extended`.Yes, much better. Maybe "settings" -> "value". Probably subjective but plural sounds weird since grep.extendedRegexp is just one bit. Also this introduces a local inconsistency: above we write 'basic' and here `basic`.
Thanks for carefully reading.