Skip to content

Commit

Permalink
Merge branch 'nd/ignore-then-not-ignore'
Browse files Browse the repository at this point in the history
Allow a later "!/abc/def" to override an earlier "/abc" that
appears in the same .gitignore file to make it easier to express
"everything in /abc directory is ignored, except for ...".

* nd/ignore-then-not-ignore:
  dir.c: don't exclude whole dir prematurely if neg pattern may match
  dir.c: make last_exclude_matching_from_list() run til the end
  • Loading branch information
Junio C Hamano committed Oct 7, 2015
2 parents 2b72dbb + 57534ee commit 506d8f1
Show file tree
Hide file tree
Showing 3 changed files with 127 additions and 10 deletions.
23 changes: 19 additions & 4 deletions Documentation/gitignore.txt
Original file line number Diff line number Diff line change
Expand Up @@ -82,12 +82,12 @@ PATTERN FORMAT

- An optional prefix "`!`" which negates the pattern; any
matching file excluded by a previous pattern will become
included again. It is not possible to re-include a file if a parent
directory of that file is excluded. Git doesn't list excluded
directories for performance reasons, so any patterns on contained
files have no effect, no matter where they are defined.
included again.
Put a backslash ("`\`") in front of the first "`!`" for patterns
that begin with a literal "`!`", for example, "`\!important!.txt`".
It is possible to re-include a file if a parent directory of that
file is excluded if certain conditions are met. See section NOTES
for detail.

- If the pattern ends with a slash, it is removed for the
purpose of the following description, but it would only find
Expand Down Expand Up @@ -141,6 +141,21 @@ not tracked by Git remain untracked.
To stop tracking a file that is currently tracked, use
'git rm --cached'.

To re-include files or directories when their parent directory is
excluded, the following conditions must be met:

- The rules to exclude a directory and re-include a subset back must
be in the same .gitignore file.

- The directory part in the re-include rules must be literal (i.e. no
wildcards)

- The rules to exclude the parent directory must not end with a
trailing slash.

- The rules to exclude the parent directory must have at least one
slash.

EXAMPLES
--------

Expand Down
89 changes: 83 additions & 6 deletions dir.c
Original file line number Diff line number Diff line change
Expand Up @@ -882,13 +882,74 @@ int match_pathname(const char *pathname, int pathlen,
*/
if (!patternlen && !namelen)
return 1;
/*
* This can happen when we ignore some exclude rules
* on directories in other to see if negative rules
* may match. E.g.
*
* /abc
* !/abc/def/ghi
*
* The pattern of interest is "/abc". On the first
* try, we should match path "abc" with this pattern
* in the "if" statement right above, but the caller
* ignores it.
*
* On the second try with paths within "abc",
* e.g. "abc/xyz", we come here and try to match it
* with "/abc".
*/
if (!patternlen && namelen && *name == '/')
return 1;
}

return fnmatch_icase_mem(pattern, patternlen,
name, namelen,
WM_PATHNAME) == 0;
}

/*
* Return non-zero if pathname is a directory and an ancestor of the
* literal path in a (negative) pattern. This is used to keep
* descending in "foo" and "foo/bar" when the pattern is
* "!foo/bar/.gitignore". "foo/notbar" will not be descended however.
*/
static int match_neg_path(const char *pathname, int pathlen, int *dtype,
const char *base, int baselen,
const char *pattern, int prefix, int patternlen,
int flags)
{
assert((flags & EXC_FLAG_NEGATIVE) && !(flags & EXC_FLAG_NODIR));

if (*dtype == DT_UNKNOWN)
*dtype = get_dtype(NULL, pathname, pathlen);
if (*dtype != DT_DIR)
return 0;

if (*pattern == '/') {
pattern++;
patternlen--;
prefix--;
}

if (baselen) {
if (((pathlen < baselen && base[pathlen] == '/') ||
pathlen == baselen) &&
!strncmp_icase(pathname, base, pathlen))
return 1;
pathname += baselen + 1;
pathlen -= baselen + 1;
}


if (prefix &&
((pathlen < prefix && pattern[pathlen] == '/') &&
!strncmp_icase(pathname, pattern, pathlen)))
return 1;

return 0;
}

/*
* Scan the given exclude list in reverse to see whether pathname
* should be ignored. The first match (i.e. the last on the list), if
Expand All @@ -901,7 +962,8 @@ static struct exclude *last_exclude_matching_from_list(const char *pathname,
int *dtype,
struct exclude_list *el)
{
int i;
struct exclude *exc = NULL; /* undecided */
int i, matched_negative_path = 0;

if (!el->nr)
return NULL; /* undefined */
Expand All @@ -922,18 +984,33 @@ static struct exclude *last_exclude_matching_from_list(const char *pathname,
if (match_basename(basename,
pathlen - (basename - pathname),
exclude, prefix, x->patternlen,
x->flags))
return x;
x->flags)) {
exc = x;
break;
}
continue;
}

assert(x->baselen == 0 || x->base[x->baselen - 1] == '/');
if (match_pathname(pathname, pathlen,
x->base, x->baselen ? x->baselen - 1 : 0,
exclude, prefix, x->patternlen, x->flags)) {
exc = x;
break;
}

if ((x->flags & EXC_FLAG_NEGATIVE) && !matched_negative_path &&
match_neg_path(pathname, pathlen, dtype, x->base,
x->baselen ? x->baselen - 1 : 0,
exclude, prefix, x->patternlen, x->flags))
return x;
}
return NULL; /* undecided */
matched_negative_path = 1;
}
if (exc &&
!(exc->flags & EXC_FLAG_NEGATIVE) &&
!(exc->flags & EXC_FLAG_NODIR) &&
matched_negative_path)
exc = NULL;
return exc;
}

/*
Expand Down
25 changes: 25 additions & 0 deletions t/t3001-ls-files-others-exclude.sh
Original file line number Diff line number Diff line change
Expand Up @@ -305,4 +305,29 @@ test_expect_success 'ls-files with "**" patterns and no slashes' '
test_cmp expect actual
'

test_expect_success 'negative patterns' '
git init reinclude &&
(
cd reinclude &&
cat >.gitignore <<-\EOF &&
/fooo
/foo
!foo/bar/bar
EOF
mkdir fooo &&
cat >fooo/.gitignore <<-\EOF &&
!/*
EOF
mkdir -p foo/bar &&
touch abc foo/def foo/bar/ghi foo/bar/bar &&
git ls-files -o --exclude-standard >../actual &&
cat >../expected <<-\EOF &&
.gitignore
abc
foo/bar/bar
EOF
test_cmp ../expected ../actual
)
'

test_done

0 comments on commit 506d8f1

Please sign in to comment.