93

I always used git checkout -- . to clear my working directory. I thought I read somewhere that the -- was required to avoid git thinking you are passing parameters (or something)

Now a colleague told me I could drop the --, and indeed, a quick test did exactly the same.

Is there are any difference between those two commands?

PS: Asking here because git checkout -- . vs git checkout . is kind of hard to google...

Gurwinder Singh
  • 38,557
  • 6
  • 51
  • 76
Laoujin
  • 9,962
  • 7
  • 42
  • 69
  • Where did you read this? Have you read the [official documentation](https://git-scm.com/docs/git-checkout)? – axiac Dec 12 '16 at 13:30

2 Answers2

139

I seem to recall that the -- is a way to tell Git to treat what follows checkout as a file and not as a branch. Suppose that you had both a file and a branch called stuff. Then the following command would seem ambiguous:

git checkout stuff

because it is not clear whether you are asking to checkout a file or a branch. By using -- you explicitly tell Git to checkout a file by that name/path. So in this case the following commands allow checking out a branch and a file called stuff:

git checkout stuff       # checkout the branch stuff
git checkout -- stuff    # checkout the file stuff

Note that git checkout <name> is really meant for branches, but Git syntax is relaxed, and if Git can't find a branch, then it will look for a file.

Closely related: Git change branch when file of same name is present

Community
  • 1
  • 1
Tim Biegeleisen
  • 502,043
  • 27
  • 286
  • 360
  • I really did mean `git co .` aka `git reset HEAD --hard`. But I guess I've been typing those two dashes superfluously for the past 2 years :) – Laoujin Dec 12 '16 at 13:37
  • 1
    @Laoujin `git co .` is definitely not *aka* `git reset --hard`. Those two commands do different things. – poke Dec 12 '16 at 14:21
37

-- as a standalone argument (i.e. not part of another argument) is used by many UNIX command line programs to indicate that anything that follows it is not an argument.

Why? Well, in this case, it's being used in case you have a path whose name starts with --, which shouldn't be interpreted as its own argument.

i.e. git checkout -- --mydirectory which, without the -- would throw an error.

Powerlord
  • 87,612
  • 17
  • 125
  • 175