Deleting a badly named git branch
Did you try
git branch -D -- --track
? the "--
" is usually the convention for "what follows is not an option, whatever its name"
From "The Art of Unix Programming", section "Command-Line Options":
It is also conventional to recognize a double hyphen as a signal to stop option interpretation and treat all following arguments literally.
You will find that convention in other (not necessary Unix-related) CLI (Command Line Interface) like cleartool:
If a nonoption argument begins with a hyphen (
–
) character, you may need to precede it with a double-hyphen argument, to prevent it from being interpreted as an option:
cleartool rmtype -lbtype -- -temporary_label-
The P18 (a fast and flexible file preprocessor with macro processing capabilities and special support for internationalization) mentions that also and gives a good description of the general idea behind that convention:
All option arguments passed to the commands start with a single hyphen.
All option arguments (if any) must precede all non-option arguments.
The end of the option arguments may be signaled using a double hyphen, this is useful if a non-option argument starts with a hyphen. Terminating the list of option arguments with a double hyphen works for all commands, even those that don't take any option arguments.
The OptionParser tool written in ruby also lays it out quite plainly:*
Option Parsing Termination
It is convention that a double hyphen is a signal to stop option interpretation and to read the remaining statements on the command line literally. So, a command such as:
app -- -x -y -z
will not ‘see’ the three mode-flags. Instead, they will be treated as arguments to the application:
#args = ["-x", "-y", "-z"]
Note: sometimes, it takes three dashes and not two, especially when the CLI follows strictly the Gnu options styles:
The Gnu style command line options provide support for option words (or keywords), yet still maintain compatibility with the Unix style options.
The options in this style are sometimes referred to aslong_options
and the Unix style options asshort_options
.
The compatibility is maintained by preceding the long_options with two dashesSimilar to the Unix style double-hyphen ’
--
’, the Gnu style has a triple-hyphen ’---
’ to signal that option parsing be halted and to treat the remaining text as arguments (that is, read literally from the command line)
So... if ' --
' is not enough (it should be with Git commands), try ' ---
'
git branch -D -- --track
I'm using msysgit 1.7.0.2 and the suggested solution doesn't work:
git branch -D -- --track # doesn't work
No error is reported, but the branch still remains. I ended up forcibly removing the branch via:
rm .git/refs/heads/--track
The double hyphen didn't work for me on remote with a branch name containing double quotes and ampersands. However wrapping the name quotes and escaping the contained quotes did the job:
git push origin --delete "123-my-branch-&-some\"quoted-text\""
and locally:
git branch -D "123-my-branch-&-some\"quoted-text\""