On Sun, Oct 08, 2017 at 05:07:12AM -0400, Robert P. J. Day wrote:
> On Sun, 8 Oct 2017, Junio C Hamano wrote:
>
> > "Robert P. J. Day" <rpj...@crashcourse.ca> writes:
> >
> > > ... so if, in the kernel source
> > > tree, i ran:
> > >
> > > $ git rm \*.c
> > >
> > > i would end up removing *all* 25,569 "*.c" files in the kernel source
> > > repository.
> >
> > Yes, as that is exactly what the command line asks Git to do.
>
> so if i wanted git to remove, say, all files named "Makefile*" from
> everywhere in the linux kernel source tree, the (dry run) command
> would be:
>
> $ git rm -n Makefile\*
>
> is that it? let's try that:
>
> $ git rm -n Makefile\*
> rm 'Makefile'
> $
>
> oops.
>
> rday
>
So your question is not su much about the recursive option (delete
mentioned directories, including their contents), but globbing
(expanding the * to any files matching the pattern).
The explanation of <files> mentions this:
Files to remove. Fileglobs (e.g. *.c) can be given to remove all
matching files.
This indicates that git itself (not your shell alone) does file
globbing.
I think the confusing part is that most people have no clear idea of the
separation between what the shell sees and interprets, and what the
program actually gets.
When you execute:
$ git rm Makefile\*
What git actually sees is this:
Makefile*
The shell intepreted the \* to mean just '*' and not interpret it
itself, and provide that to the executed program. Git, in its turn,
would start matching any file to that pattern to see which files
matches.
If you would execute:
$ git rm 'Makefile\*'
Git would see:
Makefile\*
Which does the thing you intended. So you have to deal with 2 levels of
programs interpreting the arguments, not just one.
Whether '*.c' should match just all .c files in the current dir, or all
files ending with .c depends on whether the path seperator is matched by
* or not and is a separate discussion.
GITGLOSSARY(7) under pathspec mentions this:
glob Git treats the pattern as a shell glob suitable for consumption
by fnmatch(3) with the FNM_PATHNAME flag: wildcards in the
pattern will not match a / in the pathname.
So that seems to indicate '*.c' should only match .c files in the
current dir. I'm not sure why that's not the case.
I hope this clears up what's happening a bit, and perhaps can lead to
improvements to the documentation so that it's not so surprising.
Kind regards, Kevin.
