git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] check-ignore: Add option to ignore index contents

From
Junio C Hamano <gitster@pobox.com>
Date
Aug 30, 2013, 00:57 UTC
Message-ID
<7vob8gj8qv.fsf@alter.siamese.dyndns.org>
In-Reply-To
<20130829224652.GA13621@opensourcesolutions.co.uk>
Dave Williams <dave@opensourcesolutions.co.uk> writes:
Show 30 quoted lines
> check-ignore currently shows how .gitignore rules would treat untracked
> paths. Tracked paths do not generate useful output.  This prevents
> debugging of why a path became tracked unexpectedly unless that path is
> first removed from the index with git rm --cached <path>
>
> This option (-i, --ignore-index) simply by-passes the check for the path
> being in the index and hence allows tracked path to be checked too.
>
> Whilst this behaviour deviates from the characteristics of git add and
> git status its use case is unlikely to cause any user confusion.
>
> Signed-off-by: Dave Williams <dave@opensourcesolutions.co.uk>
> ---
>  Documentation/git-check-ignore.txt |  6 ++++++
>  builtin/check-ignore.c             | 10 +++++++---
>  2 files changed, 13 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/git-check-ignore.txt b/Documentation/git-check-ignore.txt
> index d2df487..bb878ff 100644
> --- a/Documentation/git-check-ignore.txt
> +++ b/Documentation/git-check-ignore.txt
> @@ -45,6 +45,12 @@ OPTIONS
>  	not be possible to distinguish between paths which match a
>  	pattern and those which don't.
>  
> +-i, --ignore-index::
> +	Don't look in the index when undertaking the checks. This means
> +	the results deviate from those seen by git add and git status
> +	but is useful when understanding why a path became tracked by
> +	e.g. git add . and was not ignored as expected by the rules.

Please think twice after you write "This means", "What this means is", etc. to see if you can get rid of sentence before that, which needed such clarification. If the sentence can stand on its own, and what follows "This means" is also useful information, then it is a sign that "What this means is" is better rephrased as "Note that".

Also, I think `git add .` should be quoted to make it clear where the sample command begins and ends. Using a pair of `` would be the most appropriate here.

Show 45 quoted lines
>  OUTPUT
>  ------
>  
> diff --git a/builtin/check-ignore.c b/builtin/check-ignore.c
> index 4a8fc70..c8f6ae1 100644
> --- a/builtin/check-ignore.c
> +++ b/builtin/check-ignore.c
> @@ -5,7 +5,7 @@
>  #include "pathspec.h"
>  #include "parse-options.h"
>  
> -static int quiet, verbose, stdin_paths, show_non_matching;
> +static int quiet, verbose, stdin_paths, show_non_matching, ignore_index;
>  static const char * const check_ignore_usage[] = {
>  "git check-ignore [options] pathname...",
>  "git check-ignore [options] --stdin < <list-of-paths>",
> @@ -24,6 +24,8 @@ static const struct option check_ignore_options[] = {
>  		    N_("input paths are terminated by a null character")),
>  	OPT_BOOLEAN('n', "non-matching", &show_non_matching,
>  		    N_("show non-matching input paths")),
> +	OPT_BOOLEAN('i', "ignore-index", &ignore_index,
> +		    N_("ignore index when checking")),
>  	OPT_END()
>  };
>  
> @@ -82,7 +84,9 @@ static int check_ignore(struct dir_struct *dir,
>  	 * should not be ignored, in order to be consistent with
>  	 * 'git status', 'git add' etc.
>  	 */
> -	seen = find_pathspecs_matching_against_index(pathspec);
> +	if (!ignore_index) {
> +		seen = find_pathspecs_matching_against_index(pathspec);
> +	}
>  	for (i = 0; pathspec[i]; i++) {
>  		path = pathspec[i];
>  		full_path = prefix_path(prefix, prefix
> @@ -90,7 +94,7 @@ static int check_ignore(struct dir_struct *dir,
>  		full_path = check_path_for_gitlink(full_path);
>  		die_if_path_beyond_symlink(full_path, prefix);
>  		exclude = NULL;
> -		if (!seen[i]) {
> +		if (ignore_index || !seen[i]) {
>  			exclude = last_exclude_matching(dir, full_path, &dtype);
>  		}
>  		if (!quiet && (exclude || show_non_matching))

Hmph, if ignoring what is in the index is what the new feature wants to do, why does it even need to touch check_ignore() function at all and add a global variable ignore_index to keep track of that state?

Isn't it sufficient to skip the call to read_cache() when that option is given?

You would need to add tests for this, too.
Thanks.
Previous: Junio C HamanoNext: Johannes Sixt
Message 5 of 6 in “check-ignore: Add option to ignore index contents”
  1. check-ignore: Add option to ignore index contentsDave Williams, Aug 29, 2013
  2. Adam SpiersAug 30, 2013
  3. Duy NguyenAug 30, 2013
  4. Junio C HamanoAug 30, 2013
  5. Junio C HamanoAug 30, 2013
  6. Johannes SixtAug 30, 2013

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.