git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Junio C Hamano <gitster@pobox.com>
To: "Carl Smedstad via GitGitGadget" <gitgitgadget@gmail.com>
Cc: git@vger.kernel.org, Carl Smedstad <carl.smedstad@protonmail.com>
Subject: Re: [PATCH] check-ignore: --non-matching without --verbose
Date: Tue, 24 May 2022 10:45:05 -0700	[thread overview]
Message-ID: <xmqqfskyj04e.fsf@gitster.g> (raw)
In-Reply-To: pull.1236.git.1653310466062.gitgitgadget@gmail.com

"Carl Smedstad via GitGitGadget" <gitgitgadget@gmail.com> writes:

>  -n, --non-matching::
> -	Show given paths which don't match any pattern.	 This only
> -	makes sense when `--verbose` is enabled, otherwise it would
> -	not be possible to distinguish between paths which match a
> -	pattern and those which don't.

OK.  In the current code, verbose mode output can show both the
pattern that decided the fate for the path and the path itself, so
we can afford to include paths that match and that do not match.
There may not be any pattern that matched the path, or the last
pattern that matched the path was negative, or the last pattern that
matched was positive.  Users can tell them apart (the first two
cases are the paths that do not match, the last case is the paths
that do match).  But non-verbose mode only show paths, so showing
both matched and non-matching paths to the output would not make
sense.  But we document that it is a silly thing to ask, and
explicitly reject the combination of non-verbose option and
--non-matching option.

So the option is misnamed; it is more like 'include-non-matching',
not 'non-matching-only'.

> +	Only show given paths which don't match any pattern. If `--verbose` is
> +	enabled, show both paths that match a pattern and those which don't.

But this patch proposes the option to 'non-matching-only' only in
non-verbose mode.  Since "check-ignore --non-matching <pathspec>"
without "--verbose" immediately errors out, making it do something
different does not have too much backward-compatibility worries.

It may be confusing to the users that the set of paths included in
the output, when the same "-n" option is given, were different
between the non-verbose and the verbose mode.  That is one thing I
feel uncomfortable about this change.

I wonder if we are better off to invent a new "--non-matching-only"
option, have it support both the non-verbose and the verbose mode,
and leave the current "-n" alone, with an option to perhaps giving
"--include-non-matching" alias to the latter to clarify?

> diff --git a/builtin/check-ignore.c b/builtin/check-ignore.c
> index 21912569650..10e8bba1057 100644
> --- a/builtin/check-ignore.c
> +++ b/builtin/check-ignore.c
> @@ -113,8 +113,17 @@ static int check_ignore(struct dir_struct *dir,
>  			    pattern->flags & PATTERN_FLAG_NEGATIVE)
>  				pattern = NULL;
>  		}
> -		if (!quiet && (pattern || show_non_matching))
> -			output_pattern(pathspec.items[i].original, pattern);
> +		if (!quiet) {
> +			if (verbose) {
> +				if (show_non_matching || pattern)
> +					output_pattern(pathspec.items[i].original, pattern);
> +			} else {
> +				if (show_non_matching && !pattern)
> +					output_pattern(pathspec.items[i].original, pattern);
> +				if (!show_non_matching && pattern)
> +					output_pattern(pathspec.items[i].original, pattern);
> +			}
> +		}
>  		if (pattern)
>  			num_ignored++;
>  	}
> @@ -175,8 +184,6 @@ int cmd_check_ignore(int argc, const char **argv, const char *prefix)
>  		if (verbose)
>  			die(_("cannot have both --quiet and --verbose"));
>  	}
> -	if (show_non_matching && !verbose)
> -		die(_("--non-matching is only valid with --verbose"));
>  
>  	/* read_cache() is only necessary so we can watch out for submodules. */
>  	if (!no_index && read_cache() < 0)
> diff --git a/t/t0008-ignores.sh b/t/t0008-ignores.sh
> index 5575dade8ee..2ea178797bc 100755
> --- a/t/t0008-ignores.sh
> +++ b/t/t0008-ignores.sh
> @@ -90,7 +90,8 @@ test_check_ignore () {
>  #   1. with -q / --quiet
>  #   2. with default verbosity
>  #   3. with -v / --verbose
> -#   4. with -v / --verbose, *and* -n / --non-matching
> +#   4. with -n / --non-matching
> +#   5. with -v / --verbose, *and* -n / --non-matching
>  #
>  # expecting success each time.  Takes advantage of the fact that
>  # check-ignore --verbose output is the same as normal output except
> @@ -102,7 +103,7 @@ test_check_ignore () {
>  # Arguments:
>  #   - (optional) prereqs for this test, e.g. 'SYMLINKS'
>  #   - test name
> -#   - output to expect from the fourth verbosity mode (the output
> +#   - output to expect from the fifth verbosity mode (the output
>  #     from the other verbosity modes is automatically inferred
>  #     from this value)
>  #   - code to run (should invoke test_check_ignore)
> @@ -124,6 +125,7 @@ test_expect_success_multiple () {
>  
>  	expect_verbose=$( echo "$expect_all" | grep -v '^::	' )
>  	expect=$( echo "$expect_verbose" | sed -e 's/.*	//' )
> +	expect_non_matching=$( echo "$expect_all" | grep '^::	' | sed -e 's/.*	//')
>  
>  	test_expect_success $prereq "$testname${no_index_opt:+ with $no_index_opt}" '
>  		expect "$expect" &&
> @@ -144,6 +146,17 @@ test_expect_success_multiple () {
>  		quiet_opt=
>  	fi
>  
> +	for non_matching_opt in '-n' '--non-matching'
> +	do
> +		test_code="
> +			expect '$expect_non_matching' &&
> +			$code
> +		"
> +		opts="${no_index_opt:+$no_index_opt }$non_matching_opt"
> +		test_expect_success $prereq "$testname${opts:+ with $opts}" "$test_code"
> +	done
> +	non_matching_opt=
> +
>  	for verbose_opt in '-v' '--verbose'
>  	do
>  		for non_matching_opt in '' '-n' '--non-matching'
>
> base-commit: f9b95943b68b6b8ca5a6072f50a08411c6449b55

      parent reply	other threads:[~2022-05-24 17:45 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-05-23 12:54 [PATCH] check-ignore: --non-matching without --verbose Carl Smedstad via GitGitGadget
2022-05-23 18:14 ` Junio C Hamano
2022-05-24 13:03   ` Carl Smedstad
2022-05-24 19:18     ` Junio C Hamano
2022-05-24 19:26       ` Ævar Arnfjörð Bjarmason
2022-05-23 20:44 ` Derrick Stolee
2022-05-24 13:06   ` Carl Smedstad
2022-05-24 13:01 ` [PATCH v2] " Carl Smedstad via GitGitGadget
2022-05-24 17:45 ` Junio C Hamano [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=xmqqfskyj04e.fsf@gitster.g \
    --to=gitster@pobox.com \
    --cc=carl.smedstad@protonmail.com \
    --cc=git@vger.kernel.org \
    --cc=gitgitgadget@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).