3 # bash/zsh completion support for core Git.
5 # Copyright (C) 2006,2007 Shawn O. Pearce <spearce@spearce.org>
6 # Conceptually based on gitcompletion (http://gitweb.hawaga.org.uk/).
7 # Distributed under the GNU General Public License, version 2.0.
9 # The contained completion routines provide support for completing:
11 # *) local and remote branch names
12 # *) local and remote tag names
13 # *) .git/remotes file names
14 # *) git 'subcommands'
15 # *) tree paths within 'ref:path/to/file' expressions
16 # *) common --long-options
18 # To use these routines:
20 # 1) Copy this file to somewhere (e.g. ~/.git-completion.sh).
21 # 2) Add the following line to your .bashrc/.zshrc:
22 # source ~/.git-completion.sh
24 # 3) Consider changing your PS1 to also show the current branch:
25 # Bash: PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ '
26 # ZSH: PS1='[%n@%m %c$(__git_ps1 " (%s)")]\$ '
28 # The argument to __git_ps1 will be displayed only if you
29 # are currently in a git repository. The %s token will be
30 # the name of the current branch.
32 # In addition, if you set GIT_PS1_SHOWDIRTYSTATE to a nonempty
33 # value, unstaged (*) and staged (+) changes will be shown next
34 # to the branch name. You can configure this per-repository
35 # with the bash.showDirtyState variable, which defaults to true
36 # once GIT_PS1_SHOWDIRTYSTATE is enabled.
38 # You can also see if currently something is stashed, by setting
39 # GIT_PS1_SHOWSTASHSTATE to a nonempty value. If something is stashed,
40 # then a '$' will be shown next to the branch name.
42 # If you would like to see if there're untracked files, then you can
43 # set GIT_PS1_SHOWUNTRACKEDFILES to a nonempty value. If there're
44 # untracked files, then a '%' will be shown next to the branch name.
46 # If you would like to see the difference between HEAD and its
47 # upstream, set GIT_PS1_SHOWUPSTREAM="auto". A "<" indicates
48 # you are behind, ">" indicates you are ahead, and "<>"
49 # indicates you have diverged. You can further control
50 # behaviour by setting GIT_PS1_SHOWUPSTREAM to a space-separated
52 # verbose show number of commits ahead/behind (+/-) upstream
53 # legacy don't use the '--count' option available in recent
54 # versions of git-rev-list
55 # git always compare HEAD to @{upstream}
56 # svn always compare HEAD to your SVN upstream
57 # By default, __git_ps1 will compare HEAD to your SVN upstream
58 # if it can find one, or @{upstream} otherwise. Once you have
59 # set GIT_PS1_SHOWUPSTREAM, you can override it on a
60 # per-repository basis by setting the bash.showUpstream config
64 if [[ -n ${ZSH_VERSION-} ]]; then
65 autoload -U +X bashcompinit && bashcompinit
68 case "$COMP_WORDBREAKS" in
70 *) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
73 # __gitdir accepts 0 or 1 arguments (i.e., location)
74 # returns location of .git repo
77 if [ -z "${1-}" ]; then
78 if [ -n "${__git_dir-}" ]; then
80 elif [ -d .git ]; then
83 git rev-parse --git-dir 2>/dev/null
85 elif [ -d "$1/.git" ]; then
92 # stores the divergence from upstream in $p
93 # used by GIT_PS1_SHOWUPSTREAM
94 __git_ps1_show_upstream ()
97 local svn_remote svn_url_pattern count n
98 local upstream=git legacy="" verbose=""
101 # get some config options from git-config
102 local output="$(git config -z --get-regexp '^(svn-remote\..*\.url|bash\.showupstream)$' 2>/dev/null | tr '\0\n' '\n ')"
103 while read -r key value; do
106 GIT_PS1_SHOWUPSTREAM="$value"
107 if [[ -z "${GIT_PS1_SHOWUPSTREAM}" ]]; then
113 svn_remote[ $((${#svn_remote[@]} + 1)) ]="$value"
114 svn_url_pattern+="\\|$value"
115 upstream=svn+git # default upstream is SVN if available, else git
120 # parse configuration values
121 for option in ${GIT_PS1_SHOWUPSTREAM}; do
123 git|svn) upstream="$option" ;;
124 verbose) verbose=1 ;;
131 git) upstream="@{upstream}" ;;
133 # get the upstream from the "git-svn-id: ..." in a commit message
134 # (git-svn uses essentially the same procedure internally)
135 local svn_upstream=($(git log --first-parent -1 \
136 --grep="^git-svn-id: \(${svn_url_pattern#??}\)" 2>/dev/null))
137 if [[ 0 -ne ${#svn_upstream[@]} ]]; then
138 svn_upstream=${svn_upstream[ ${#svn_upstream[@]} - 2 ]}
139 svn_upstream=${svn_upstream%@*}
140 local n_stop="${#svn_remote[@]}"
141 for ((n=1; n <= n_stop; n++)); do
142 svn_upstream=${svn_upstream#${svn_remote[$n]}}
145 if [[ -z "$svn_upstream" ]]; then
146 # default branch name for checkouts with no layout:
147 upstream=${GIT_SVN_ID:-git-svn}
149 upstream=${svn_upstream#/}
151 elif [[ "svn+git" = "$upstream" ]]; then
152 upstream="@{upstream}"
157 # Find how many commits we are ahead/behind our upstream
158 if [[ -z "$legacy" ]]; then
159 count="$(git rev-list --count --left-right \
160 "$upstream"...HEAD 2>/dev/null)"
162 # produce equivalent output to --count for older versions of git
164 if commits="$(git rev-list --left-right "$upstream"...HEAD 2>/dev/null)"
166 local commit behind=0 ahead=0
167 for commit in $commits
170 "<"*) ((behind++)) ;;
174 count="$behind $ahead"
180 # calculate the result
181 if [[ -z "$verbose" ]]; then
185 "0 0") # equal to upstream
187 "0 "*) # ahead of upstream
189 *" 0") # behind upstream
191 *) # diverged from upstream
198 "0 0") # equal to upstream
200 "0 "*) # ahead of upstream
201 p=" u+${count#0 }" ;;
202 *" 0") # behind upstream
203 p=" u-${count% 0}" ;;
204 *) # diverged from upstream
205 p=" u+${count#* }-${count% *}" ;;
212 # __git_ps1 accepts 0 or 1 arguments (i.e., format string)
213 # returns text to add to bash PS1 prompt (includes branch name)
216 local g="$(__gitdir)"
220 if [ -f "$g/rebase-merge/interactive" ]; then
222 b="$(cat "$g/rebase-merge/head-name")"
223 elif [ -d "$g/rebase-merge" ]; then
225 b="$(cat "$g/rebase-merge/head-name")"
227 if [ -d "$g/rebase-apply" ]; then
228 if [ -f "$g/rebase-apply/rebasing" ]; then
230 elif [ -f "$g/rebase-apply/applying" ]; then
235 elif [ -f "$g/MERGE_HEAD" ]; then
237 elif [ -f "$g/CHERRY_PICK_HEAD" ]; then
239 elif [ -f "$g/BISECT_LOG" ]; then
243 b="$(git symbolic-ref HEAD 2>/dev/null)" || {
246 case "${GIT_PS1_DESCRIBE_STYLE-}" in
248 git describe --contains HEAD ;;
250 git describe --contains --all HEAD ;;
254 git describe --tags --exact-match HEAD ;;
255 esac 2>/dev/null)" ||
257 b="$(cut -c1-7 "$g/HEAD" 2>/dev/null)..." ||
270 if [ "true" = "$(git rev-parse --is-inside-git-dir 2>/dev/null)" ]; then
271 if [ "true" = "$(git rev-parse --is-bare-repository 2>/dev/null)" ]; then
276 elif [ "true" = "$(git rev-parse --is-inside-work-tree 2>/dev/null)" ]; then
277 if [ -n "${GIT_PS1_SHOWDIRTYSTATE-}" ]; then
278 if [ "$(git config --bool bash.showDirtyState)" != "false" ]; then
279 git diff --no-ext-diff --quiet --exit-code || w="*"
280 if git rev-parse --quiet --verify HEAD >/dev/null; then
281 git diff-index --cached --quiet HEAD -- || i="+"
287 if [ -n "${GIT_PS1_SHOWSTASHSTATE-}" ]; then
288 git rev-parse --verify refs/stash >/dev/null 2>&1 && s="$"
291 if [ -n "${GIT_PS1_SHOWUNTRACKEDFILES-}" ]; then
292 if [ -n "$(git ls-files --others --exclude-standard)" ]; then
297 if [ -n "${GIT_PS1_SHOWUPSTREAM-}" ]; then
298 __git_ps1_show_upstream
303 printf -- "${1:- (%s)}" "$c${b##refs/heads/}${f:+ $f}$r$p"
320 # The following function is based on code from:
322 # bash_completion - programmable completion functions for bash 3.2+
324 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
325 # © 2009-2010, Bash Completion Maintainers
326 # <bash-completion-devel@lists.alioth.debian.org>
328 # This program is free software; you can redistribute it and/or modify
329 # it under the terms of the GNU General Public License as published by
330 # the Free Software Foundation; either version 2, or (at your option)
333 # This program is distributed in the hope that it will be useful,
334 # but WITHOUT ANY WARRANTY; without even the implied warranty of
335 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
336 # GNU General Public License for more details.
338 # You should have received a copy of the GNU General Public License
339 # along with this program; if not, write to the Free Software Foundation,
340 # Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
342 # The latest version of this software can be obtained here:
344 # http://bash-completion.alioth.debian.org/
348 # This function can be used to access a tokenized list of words
349 # on the command line:
351 # __git_reassemble_comp_words_by_ref '=:'
352 # if test "${words_[cword_-1]}" = -w
357 # The argument should be a collection of characters from the list of
358 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
361 # This is roughly equivalent to going back in time and setting
362 # COMP_WORDBREAKS to exclude those characters. The intent is to
363 # make option types like --date=<type> and <rev>:<path> easy to
364 # recognize by treating each shell word as a single token.
366 # It is best not to set COMP_WORDBREAKS directly because the value is
367 # shared with other completion scripts. By the time the completion
368 # function gets called, COMP_WORDS has already been populated so local
369 # changes to COMP_WORDBREAKS have no effect.
371 # Output: words_, cword_, cur_.
373 __git_reassemble_comp_words_by_ref()
375 local exclude i j first
376 # Which word separators to exclude?
377 exclude="${1//[^$COMP_WORDBREAKS]}"
379 if [ -z "$exclude" ]; then
380 words_=("${COMP_WORDS[@]}")
383 # List of word completion separators has shrunk;
384 # re-assemble words to complete.
385 for ((i=0, j=0; i < ${#COMP_WORDS[@]}; i++, j++)); do
386 # Append each nonempty word consisting of just
387 # word separator characters to the current word.
391 [ -n "${COMP_WORDS[$i]}" ] &&
392 # word consists of excluded word separators
393 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
395 # Attach to the previous token,
396 # unless the previous token is the command name.
397 if [ $j -ge 2 ] && [ -n "$first" ]; then
401 words_[$j]=${words_[j]}${COMP_WORDS[i]}
402 if [ $i = $COMP_CWORD ]; then
405 if (($i < ${#COMP_WORDS[@]} - 1)); then
412 words_[$j]=${words_[j]}${COMP_WORDS[i]}
413 if [ $i = $COMP_CWORD ]; then
419 if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
420 if [[ -z ${ZSH_VERSION:+set} ]]; then
421 _get_comp_words_by_ref ()
423 local exclude cur_ words_ cword_
424 if [ "$1" = "-n" ]; then
428 __git_reassemble_comp_words_by_ref "$exclude"
429 cur_=${words_[cword_]}
430 while [ $# -gt 0 ]; do
436 prev=${words_[$cword_-1]}
439 words=("${words_[@]}")
449 _get_comp_words_by_ref ()
451 while [ $# -gt 0 ]; do
454 cur=${COMP_WORDS[COMP_CWORD]}
457 prev=${COMP_WORDS[COMP_CWORD-1]}
460 words=("${COMP_WORDS[@]}")
466 # assume COMP_WORDBREAKS is already set sanely
476 # Generates completion reply with compgen, appending a space to possible
477 # completion words, if necessary.
478 # It accepts 1 to 4 arguments:
479 # 1: List of possible completion words.
480 # 2: A prefix to be added to each possible completion word (optional).
481 # 3: Generate possible completion matches for this word (optional).
482 # 4: A suffix to be appended to each possible completion word (optional).
485 local cur_="${3-$cur}"
493 COMPREPLY=($(compgen -P "${2-}" \
494 -W "$(__gitcomp_1 "${1-}" "${4-}")" \
500 # Generates completion reply with compgen from newline-separated possible
501 # completion words by appending a space to all of them.
502 # It accepts 1 to 4 arguments:
503 # 1: List of possible completion words, separated by a single newline.
504 # 2: A prefix to be added to each possible completion word (optional).
505 # 3: Generate possible completion matches for this word (optional).
506 # 4: A suffix to be appended to each possible completion word instead of
507 # the default space (optional). If specified but empty, nothing is
512 COMPREPLY=($(compgen -P "${2-}" -S "${4- }" -W "$1" -- "${3-$cur}"))
517 local dir="$(__gitdir)"
518 if [ -d "$dir" ]; then
519 git --git-dir="$dir" for-each-ref --format='%(refname:short)' \
527 local dir="$(__gitdir)"
528 if [ -d "$dir" ]; then
529 git --git-dir="$dir" for-each-ref --format='%(refname:short)' \
535 # __git_refs accepts 0, 1 (to pass to __gitdir), or 2 arguments
536 # presence of 2nd argument means use the guess heuristic employed
537 # by checkout for tracking branches
540 local i hash dir="$(__gitdir "${1-}")" track="${2-}"
542 if [ -d "$dir" ]; then
550 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD; do
551 if [ -e "$dir/$i" ]; then echo $i; fi
553 format="refname:short"
554 refs="refs/tags refs/heads refs/remotes"
557 git --git-dir="$dir" for-each-ref --format="%($format)" \
559 if [ -n "$track" ]; then
560 # employ the heuristic used by git checkout
561 # Try to find a remote branch that matches the completion word
562 # but only output if the branch name is unique
564 git --git-dir="$dir" for-each-ref --shell --format="ref=%(refname:short)" \
566 while read -r entry; do
569 if [[ "$ref" == "$cur"* ]]; then
578 git ls-remote "$dir" "$cur*" 2>/dev/null | \
579 while read -r hash i; do
587 git ls-remote "$dir" HEAD ORIG_HEAD 'refs/tags/*' 'refs/heads/*' 'refs/remotes/*' 2>/dev/null | \
588 while read -r hash i; do
591 refs/*) echo "${i#refs/*/}" ;;
599 # __git_refs2 requires 1 argument (to pass to __git_refs)
603 for i in $(__git_refs "$1"); do
608 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
609 __git_refs_remotes ()
612 git ls-remote "$1" 'refs/heads/*' 2>/dev/null | \
613 while read -r hash i; do
614 echo "$i:refs/remotes/$1/${i#refs/heads/}"
620 local i IFS=$'\n' d="$(__gitdir)"
621 test -d "$d/remotes" && ls -1 "$d/remotes"
622 for i in $(git --git-dir="$d" config --get-regexp 'remote\..*\.url' 2>/dev/null); do
628 __git_list_merge_strategies ()
630 git merge -s help 2>&1 |
631 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
640 __git_merge_strategies=
641 # 'git merge -s help' (and thus detection of the merge strategy
642 # list) fails, unfortunately, if run outside of any git working
643 # tree. __git_merge_strategies is set to the empty string in
644 # that case, and the detection will be repeated the next time it
646 __git_compute_merge_strategies ()
648 test -n "$__git_merge_strategies" ||
649 __git_merge_strategies=$(__git_list_merge_strategies)
652 __git_complete_revlist_file ()
654 local pfx ls ref cur_="$cur"
674 case "$COMP_WORDBREAKS" in
676 *) pfx="$ref:$pfx" ;;
679 __gitcomp_nl "$(git --git-dir="$(__gitdir)" ls-tree "$ls" \
680 | sed '/^100... blob /{
696 pfx="${cur_%...*}..."
698 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
703 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
706 __gitcomp_nl "$(__git_refs)"
712 __git_complete_file ()
714 __git_complete_revlist_file
717 __git_complete_revlist ()
719 __git_complete_revlist_file
722 __git_complete_remote_or_refspec ()
724 local cur_="$cur" cmd="${words[1]}"
725 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
726 if [ "$cmd" = "remote" ]; then
729 while [ $c -lt $cword ]; do
732 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
735 push) no_complete_refspec=1 ;;
744 *) remote="$i"; break ;;
748 if [ -z "$remote" ]; then
749 __gitcomp_nl "$(__git_remotes)"
752 if [ $no_complete_refspec = 1 ]; then
756 [ "$remote" = "." ] && remote=
759 case "$COMP_WORDBREAKS" in
761 *) pfx="${cur_%%:*}:" ;;
773 if [ $lhs = 1 ]; then
774 __gitcomp_nl "$(__git_refs2 "$remote")" "$pfx" "$cur_"
776 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
780 if [ $lhs = 1 ]; then
781 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
783 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
787 if [ $lhs = 1 ]; then
788 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
790 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
796 __git_complete_strategy ()
798 __git_compute_merge_strategies
801 __gitcomp "$__git_merge_strategies"
806 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
813 __git_list_all_commands ()
816 for i in $(git help -a|egrep '^ [a-zA-Z0-9]')
819 *--*) : helper pattern;;
826 __git_compute_all_commands ()
828 test -n "$__git_all_commands" ||
829 __git_all_commands=$(__git_list_all_commands)
832 __git_list_porcelain_commands ()
835 __git_compute_all_commands
836 for i in "help" $__git_all_commands
839 *--*) : helper pattern;;
840 applymbox) : ask gittus;;
841 applypatch) : ask gittus;;
842 archimport) : import;;
843 cat-file) : plumbing;;
844 check-attr) : plumbing;;
845 check-ref-format) : plumbing;;
846 checkout-index) : plumbing;;
847 commit-tree) : plumbing;;
848 count-objects) : infrequent;;
849 cvsexportcommit) : export;;
850 cvsimport) : import;;
851 cvsserver) : daemon;;
853 diff-files) : plumbing;;
854 diff-index) : plumbing;;
855 diff-tree) : plumbing;;
856 fast-import) : import;;
857 fast-export) : export;;
858 fsck-objects) : plumbing;;
859 fetch-pack) : plumbing;;
860 fmt-merge-msg) : plumbing;;
861 for-each-ref) : plumbing;;
862 hash-object) : plumbing;;
863 http-*) : transport;;
864 index-pack) : plumbing;;
865 init-db) : deprecated;;
866 local-fetch) : plumbing;;
867 lost-found) : infrequent;;
868 ls-files) : plumbing;;
869 ls-remote) : plumbing;;
870 ls-tree) : plumbing;;
871 mailinfo) : plumbing;;
872 mailsplit) : plumbing;;
873 merge-*) : plumbing;;
876 pack-objects) : plumbing;;
877 pack-redundant) : plumbing;;
878 pack-refs) : plumbing;;
879 parse-remote) : plumbing;;
880 patch-id) : plumbing;;
881 peek-remote) : plumbing;;
883 prune-packed) : plumbing;;
884 quiltimport) : import;;
885 read-tree) : plumbing;;
886 receive-pack) : plumbing;;
887 remote-*) : transport;;
888 repo-config) : deprecated;;
890 rev-list) : plumbing;;
891 rev-parse) : plumbing;;
892 runstatus) : plumbing;;
893 sh-setup) : internal;;
895 show-ref) : plumbing;;
896 send-pack) : plumbing;;
897 show-index) : plumbing;;
899 stripspace) : plumbing;;
900 symbolic-ref) : plumbing;;
901 tar-tree) : deprecated;;
902 unpack-file) : plumbing;;
903 unpack-objects) : plumbing;;
904 update-index) : plumbing;;
905 update-ref) : plumbing;;
906 update-server-info) : daemon;;
907 upload-archive) : plumbing;;
908 upload-pack) : plumbing;;
909 write-tree) : plumbing;;
911 verify-pack) : infrequent;;
912 verify-tag) : plumbing;;
918 __git_porcelain_commands=
919 __git_compute_porcelain_commands ()
921 __git_compute_all_commands
922 test -n "$__git_porcelain_commands" ||
923 __git_porcelain_commands=$(__git_list_porcelain_commands)
926 __git_pretty_aliases ()
929 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "pretty\..*" 2>/dev/null); do
942 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "alias\..*" 2>/dev/null); do
952 # __git_aliased_command requires 1 argument
953 __git_aliased_command ()
955 local word cmdline=$(git --git-dir="$(__gitdir)" \
956 config --get "alias.$1")
957 for word in $cmdline; do
963 \!*) : shell command alias ;;
965 *=*) : setting env ;;
974 # __git_find_on_cmdline requires 1 argument
975 __git_find_on_cmdline ()
977 local word subcommand c=1
978 while [ $c -lt $cword ]; do
980 for subcommand in $1; do
981 if [ "$subcommand" = "$word" ]; then
990 __git_has_doubledash ()
993 while [ $c -lt $cword ]; do
994 if [ "--" = "${words[c]}" ]; then
1002 __git_whitespacelist="nowarn warn error error-all fix"
1006 local dir="$(__gitdir)"
1007 if [ -d "$dir"/rebase-apply ]; then
1008 __gitcomp "--skip --continue --resolved --abort"
1013 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1018 --3way --committer-date-is-author-date --ignore-date
1019 --ignore-whitespace --ignore-space-change
1020 --interactive --keep --no-utf8 --signoff --utf8
1021 --whitespace= --scissors
1032 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1037 --stat --numstat --summary --check --index
1038 --cached --index-info --reverse --reject --unidiff-zero
1039 --apply --no-add --exclude=
1040 --ignore-whitespace --ignore-space-change
1041 --whitespace= --inaccurate-eof --verbose
1050 __git_has_doubledash && return
1055 --interactive --refresh --patch --update --dry-run
1056 --ignore-errors --intent-to-add
1067 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
1071 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
1076 --format= --list --verbose
1077 --prefix= --remote= --exec=
1087 __git_has_doubledash && return
1089 local subcommands="start bad good skip reset visualize replay log run"
1090 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1091 if [ -z "$subcommand" ]; then
1092 if [ -f "$(__gitdir)"/BISECT_START ]; then
1093 __gitcomp "$subcommands"
1095 __gitcomp "replay start"
1100 case "$subcommand" in
1101 bad|good|reset|skip|start)
1102 __gitcomp_nl "$(__git_refs)"
1112 local i c=1 only_local_ref="n" has_r="n"
1114 while [ $c -lt $cword ]; do
1117 -d|-m) only_local_ref="y" ;;
1126 --color --no-color --verbose --abbrev= --no-abbrev
1127 --track --no-track --contains --merged --no-merged
1128 --set-upstream --edit-description --list
1132 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
1133 __gitcomp_nl "$(__git_heads)"
1135 __gitcomp_nl "$(__git_refs)"
1143 local cmd="${words[2]}"
1146 __gitcomp "create list-heads verify unbundle"
1149 # looking for a file
1154 __git_complete_revlist
1163 __git_has_doubledash && return
1167 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1171 --quiet --ours --theirs --track --no-track --merge
1172 --conflict= --orphan --patch
1176 # check if --track, --no-track, or --no-guess was specified
1177 # if so, disable DWIM mode
1178 local flags="--track --no-track --no-guess" track=1
1179 if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1182 __gitcomp_nl "$(__git_refs '' $track)"
1189 __gitcomp "$(__git_refs)"
1196 __gitcomp "--edit --no-commit"
1199 __gitcomp_nl "$(__git_refs)"
1206 __git_has_doubledash && return
1210 __gitcomp "--dry-run --quiet"
1243 __git_has_doubledash && return
1247 __gitcomp "default strip verbatim whitespace
1248 " "" "${cur##--cleanup=}"
1251 --reuse-message=*|--reedit-message=*|\
1252 --fixup=*|--squash=*)
1253 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1256 --untracked-files=*)
1257 __gitcomp "all no normal" "" "${cur##--untracked-files=}"
1262 --all --author= --signoff --verify --no-verify
1263 --edit --amend --include --only --interactive
1264 --dry-run --reuse-message= --reedit-message=
1265 --reset-author --file= --message= --template=
1266 --cleanup= --untracked-files --untracked-files=
1267 --verbose --quiet --fixup= --squash=
1279 --all --tags --contains --abbrev= --candidates=
1280 --exact-match --debug --long --match --always
1284 __gitcomp_nl "$(__git_refs)"
1287 __git_diff_common_options="--stat --numstat --shortstat --summary
1288 --patch-with-stat --name-only --name-status --color
1289 --no-color --color-words --no-renames --check
1290 --full-index --binary --abbrev --diff-filter=
1291 --find-copies-harder
1292 --text --ignore-space-at-eol --ignore-space-change
1293 --ignore-all-space --exit-code --quiet --ext-diff
1295 --no-prefix --src-prefix= --dst-prefix=
1296 --inter-hunk-context=
1299 --dirstat --dirstat= --dirstat-by-file
1300 --dirstat-by-file= --cumulative
1305 __git_has_doubledash && return
1309 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1310 --base --ours --theirs --no-index
1311 $__git_diff_common_options
1316 __git_complete_revlist_file
1319 __git_mergetools_common="diffuse ecmerge emerge kdiff3 meld opendiff
1320 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc3
1325 __git_has_doubledash && return
1329 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1333 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1334 --base --ours --theirs
1335 --no-renames --diff-filter= --find-copies-harder
1336 --relative --ignore-submodules
1344 __git_fetch_options="
1345 --quiet --verbose --append --upload-pack --force --keep --depth=
1346 --tags --no-tags --all --prune --dry-run
1353 __gitcomp "$__git_fetch_options"
1357 __git_complete_remote_or_refspec
1360 _git_format_patch ()
1366 " "" "${cur##--thread=}"
1371 --stdout --attach --no-attach --thread --thread=
1373 --numbered --start-number
1376 --signoff --signature --no-signature
1377 --in-reply-to= --cc=
1378 --full-index --binary
1381 --no-prefix --src-prefix= --dst-prefix=
1382 --inline --suffix= --ignore-if-in-upstream
1388 __git_complete_revlist
1396 --tags --root --unreachable --cache --no-reflogs --full
1397 --strict --verbose --lost-found
1409 __gitcomp "--prune --aggressive"
1421 __git_match_ctag() {
1422 awk "/^${1////\\/}/ { print \$1 }" "$2"
1427 __git_has_doubledash && return
1433 --text --ignore-case --word-regexp --invert-match
1434 --full-name --line-number
1435 --extended-regexp --basic-regexp --fixed-strings
1437 --files-with-matches --name-only
1438 --files-without-match
1441 --and --or --not --all-match
1447 case "$cword,$prev" in
1449 if test -r tags; then
1450 __gitcomp_nl "$(__git_match_ctag "$cur" tags)"
1456 __gitcomp_nl "$(__git_refs)"
1463 __gitcomp "--all --info --man --web"
1467 __git_compute_all_commands
1468 __gitcomp "$__git_all_commands $(__git_aliases)
1469 attributes cli core-tutorial cvs-migration
1470 diffcore gitk glossary hooks ignore modules
1471 namespaces repository-layout tutorial tutorial-2
1481 false true umask group all world everybody
1482 " "" "${cur##--shared=}"
1486 __gitcomp "--quiet --bare --template= --shared --shared="
1495 __git_has_doubledash && return
1499 __gitcomp "--cached --deleted --modified --others --ignored
1500 --stage --directory --no-empty-directory --unmerged
1501 --killed --exclude= --exclude-from=
1502 --exclude-per-directory= --exclude-standard
1503 --error-unmatch --with-tree= --full-name
1504 --abbrev --ignored --exclude-per-directory
1514 __gitcomp_nl "$(__git_remotes)"
1522 # Options that go well for log, shortlog and gitk
1523 __git_log_common_options="
1525 --branches --tags --remotes
1526 --first-parent --merges --no-merges
1528 --max-age= --since= --after=
1529 --min-age= --until= --before=
1530 --min-parents= --max-parents=
1531 --no-min-parents --no-max-parents
1533 # Options that go well for log and gitk (not shortlog)
1534 __git_log_gitk_options="
1535 --dense --sparse --full-history
1536 --simplify-merges --simplify-by-decoration
1537 --left-right --notes --no-notes
1539 # Options that go well for log and shortlog (not gitk)
1540 __git_log_shortlog_options="
1541 --author= --committer= --grep=
1545 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1546 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1550 __git_has_doubledash && return
1552 local g="$(git rev-parse --git-dir 2>/dev/null)"
1554 if [ -f "$g/MERGE_HEAD" ]; then
1558 --pretty=*|--format=*)
1559 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1564 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1568 __gitcomp "long short" "" "${cur##--decorate=}"
1573 $__git_log_common_options
1574 $__git_log_shortlog_options
1575 $__git_log_gitk_options
1576 --root --topo-order --date-order --reverse
1577 --follow --full-diff
1578 --abbrev-commit --abbrev=
1579 --relative-date --date=
1580 --pretty= --format= --oneline
1583 --decorate --decorate=
1585 --parents --children
1587 $__git_diff_common_options
1588 --pickaxe-all --pickaxe-regex
1593 __git_complete_revlist
1596 __git_merge_options="
1597 --no-commit --no-stat --log --no-log --squash --strategy
1598 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1603 __git_complete_strategy && return
1607 __gitcomp "$__git_merge_options"
1610 __gitcomp_nl "$(__git_refs)"
1617 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1630 __gitcomp_nl "$(__git_refs)"
1637 __gitcomp "--dry-run"
1646 __gitcomp "--tags --all --stdin"
1651 local subcommands='add append copy edit list prune remove show'
1652 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1654 case "$subcommand,$cur" in
1661 __gitcomp_nl "$(__git_refs)"
1664 __gitcomp "$subcommands --ref"
1668 add,--reuse-message=*|append,--reuse-message=*|\
1669 add,--reedit-message=*|append,--reedit-message=*)
1670 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1673 __gitcomp '--file= --message= --reedit-message=
1680 __gitcomp '--dry-run --verbose'
1689 __gitcomp_nl "$(__git_refs)"
1698 __git_complete_strategy && return
1703 --rebase --no-rebase
1704 $__git_merge_options
1705 $__git_fetch_options
1710 __git_complete_remote_or_refspec
1717 __gitcomp_nl "$(__git_remotes)"
1722 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1727 --all --mirror --tags --dry-run --force --verbose
1728 --receive-pack= --repo= --set-upstream
1733 __git_complete_remote_or_refspec
1738 local dir="$(__gitdir)"
1739 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1740 __gitcomp "--continue --skip --abort"
1743 __git_complete_strategy && return
1746 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1751 --onto --merge --strategy --interactive
1752 --preserve-merges --stat --no-stat
1753 --committer-date-is-author-date --ignore-date
1754 --ignore-whitespace --whitespace=
1760 __gitcomp_nl "$(__git_refs)"
1765 local subcommands="show delete expire"
1766 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1768 if [ -z "$subcommand" ]; then
1769 __gitcomp "$subcommands"
1771 __gitcomp_nl "$(__git_refs)"
1775 __git_send_email_confirm_options="always never auto cc compose"
1776 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1783 $__git_send_email_confirm_options
1784 " "" "${cur##--confirm=}"
1789 $__git_send_email_suppresscc_options
1790 " "" "${cur##--suppress-cc=}"
1794 --smtp-encryption=*)
1795 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1799 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1800 --compose --confirm= --dry-run --envelope-sender
1802 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1803 --no-suppress-from --no-thread --quiet
1804 --signed-off-by-cc --smtp-pass --smtp-server
1805 --smtp-server-port --smtp-encryption= --smtp-user
1806 --subject --suppress-cc= --suppress-from --thread --to
1807 --validate --no-validate"
1819 __git_config_get_set_variables ()
1821 local prevword word config_file= c=$cword
1822 while [ $c -gt 1 ]; do
1825 --global|--system|--file=*)
1830 config_file="$word $prevword"
1838 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1853 __gitcomp_nl "$(__git_remotes)"
1857 __gitcomp_nl "$(__git_refs)"
1861 local remote="${prev#remote.}"
1862 remote="${remote%.fetch}"
1863 if [ -z "$cur" ]; then
1864 COMPREPLY=("refs/heads/")
1867 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1871 local remote="${prev#remote.}"
1872 remote="${remote%.push}"
1873 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1874 for-each-ref --format='%(refname):%(refname)' \
1878 pull.twohead|pull.octopus)
1879 __git_compute_merge_strategies
1880 __gitcomp "$__git_merge_strategies"
1883 color.branch|color.diff|color.interactive|\
1884 color.showbranch|color.status|color.ui)
1885 __gitcomp "always never auto"
1889 __gitcomp "false true"
1894 normal black red green yellow blue magenta cyan white
1895 bold dim ul blink reverse
1900 __gitcomp "man info web html"
1904 __gitcomp "$__git_log_date_formats"
1907 sendemail.aliasesfiletype)
1908 __gitcomp "mutt mailrc pine elm gnus"
1912 __gitcomp "$__git_send_email_confirm_options"
1915 sendemail.suppresscc)
1916 __gitcomp "$__git_send_email_suppresscc_options"
1919 --get|--get-all|--unset|--unset-all)
1920 __gitcomp_nl "$(__git_config_get_set_variables)"
1931 --global --system --file=
1932 --list --replace-all
1933 --get --get-all --get-regexp
1934 --add --unset --unset-all
1935 --remove-section --rename-section
1940 local pfx="${cur%.*}." cur_="${cur##*.}"
1941 __gitcomp "remote merge mergeoptions rebase" "$pfx" "$cur_"
1945 local pfx="${cur%.*}." cur_="${cur#*.}"
1946 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1950 local pfx="${cur%.*}." cur_="${cur##*.}"
1952 argprompt cmd confirm needsfile noconsole norescan
1953 prompt revprompt revunmerged title
1958 local pfx="${cur%.*}." cur_="${cur##*.}"
1959 __gitcomp "cmd path" "$pfx" "$cur_"
1963 local pfx="${cur%.*}." cur_="${cur##*.}"
1964 __gitcomp "cmd path" "$pfx" "$cur_"
1968 local pfx="${cur%.*}." cur_="${cur##*.}"
1969 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1973 local pfx="${cur%.*}." cur_="${cur#*.}"
1974 __git_compute_all_commands
1975 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1979 local pfx="${cur%.*}." cur_="${cur##*.}"
1981 url proxy fetch push mirror skipDefaultUpdate
1982 receivepack uploadpack tagopt pushurl
1987 local pfx="${cur%.*}." cur_="${cur#*.}"
1988 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1992 local pfx="${cur%.*}." cur_="${cur##*.}"
1993 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1999 advice.commitBeforeMerge
2001 advice.implicitIdentity
2002 advice.pushNonFastForward
2003 advice.resolveConflict
2007 apply.ignorewhitespace
2009 branch.autosetupmerge
2010 branch.autosetuprebase
2014 color.branch.current
2019 color.decorate.branch
2020 color.decorate.remoteBranch
2021 color.decorate.stash
2031 color.diff.whitespace
2036 color.grep.linenumber
2039 color.grep.separator
2041 color.interactive.error
2042 color.interactive.header
2043 color.interactive.help
2044 color.interactive.prompt
2049 color.status.changed
2051 color.status.nobranch
2052 color.status.untracked
2053 color.status.updated
2062 core.bigFileThreshold
2065 core.deltaBaseCacheLimit
2070 core.fsyncobjectfiles
2072 core.ignoreCygwinFSTricks
2075 core.logAllRefUpdates
2076 core.loosecompression
2079 core.packedGitWindowSize
2081 core.preferSymlinkRefs
2084 core.repositoryFormatVersion
2086 core.sharedRepository
2090 core.warnAmbiguousRefs
2093 diff.autorefreshindex
2096 diff.ignoreSubmodules
2101 diff.suppressBlankEmpty
2106 fetch.recurseSubmodules
2115 format.subjectprefix
2126 gc.reflogexpireunreachable
2130 gitcvs.commitmsgannotation
2131 gitcvs.dbTableNamePrefix
2142 gui.copyblamethreshold
2146 gui.matchtrackingbranch
2147 gui.newbranchtemplate
2148 gui.pruneduringfetch
2149 gui.spellingdictionary
2164 http.sslCertPasswordProtected
2169 i18n.logOutputEncoding
2175 imap.preformattedHTML
2185 interactive.singlekey
2201 mergetool.keepBackup
2202 mergetool.keepTemporaries
2207 notes.rewrite.rebase
2211 pack.deltaCacheLimit
2227 receive.denyCurrentBranch
2228 receive.denyDeleteCurrent
2230 receive.denyNonFastForwards
2233 receive.updateserverinfo
2235 repack.usedeltabaseoffset
2239 sendemail.aliasesfile
2240 sendemail.aliasfiletype
2244 sendemail.chainreplyto
2246 sendemail.envelopesender
2250 sendemail.signedoffbycc
2251 sendemail.smtpdomain
2252 sendemail.smtpencryption
2254 sendemail.smtpserver
2255 sendemail.smtpserveroption
2256 sendemail.smtpserverport
2258 sendemail.suppresscc
2259 sendemail.suppressfrom
2264 status.relativePaths
2265 status.showUntrackedFiles
2266 status.submodulesummary
2269 transfer.unpackLimit
2281 local subcommands="add rename rm set-head set-branches set-url show prune update"
2282 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2283 if [ -z "$subcommand" ]; then
2284 __gitcomp "$subcommands"
2288 case "$subcommand" in
2289 rename|rm|set-url|show|prune)
2290 __gitcomp_nl "$(__git_remotes)"
2292 set-head|set-branches)
2293 __git_complete_remote_or_refspec
2296 local i c='' IFS=$'\n'
2297 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "remotes\..*" 2>/dev/null); do
2311 __gitcomp_nl "$(__git_refs)"
2316 __git_has_doubledash && return
2320 __gitcomp "--merge --mixed --hard --soft --patch"
2324 __gitcomp_nl "$(__git_refs)"
2331 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2335 __gitcomp_nl "$(__git_refs)"
2340 __git_has_doubledash && return
2344 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2353 __git_has_doubledash && return
2358 $__git_log_common_options
2359 $__git_log_shortlog_options
2360 --numbered --summary
2365 __git_complete_revlist
2370 __git_has_doubledash && return
2373 --pretty=*|--format=*)
2374 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2379 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2380 $__git_diff_common_options
2393 --all --remotes --topo-order --current --more=
2394 --list --independent --merge-base --no-name
2396 --sha1-name --sparse --topics --reflog
2401 __git_complete_revlist
2406 local save_opts='--keep-index --no-keep-index --quiet --patch'
2407 local subcommands='save list show apply clear drop pop create branch'
2408 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2409 if [ -z "$subcommand" ]; then
2412 __gitcomp "$save_opts"
2415 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2416 __gitcomp "$subcommands"
2423 case "$subcommand,$cur" in
2425 __gitcomp "$save_opts"
2428 __gitcomp "--index --quiet"
2430 show,--*|drop,--*|branch,--*)
2433 show,*|apply,*|drop,*|pop,*|branch,*)
2434 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2435 | sed -n -e 's/:.*//p')"
2446 __git_has_doubledash && return
2448 local subcommands="add status init update summary foreach sync"
2449 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2452 __gitcomp "--quiet --cached"
2455 __gitcomp "$subcommands"
2465 init fetch clone rebase dcommit log find-rev
2466 set-tree commit-diff info create-ignore propget
2467 proplist show-ignore show-externals branch tag blame
2468 migrate mkdirs reset gc
2470 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2471 if [ -z "$subcommand" ]; then
2472 __gitcomp "$subcommands"
2474 local remote_opts="--username= --config-dir= --no-auth-cache"
2476 --follow-parent --authors-file= --repack=
2477 --no-metadata --use-svm-props --use-svnsync-props
2478 --log-window-size= --no-checkout --quiet
2479 --repack-flags --use-log-author --localtime
2480 --ignore-paths= $remote_opts
2483 --template= --shared= --trunk= --tags=
2484 --branches= --stdlayout --minimize-url
2485 --no-metadata --use-svm-props --use-svnsync-props
2486 --rewrite-root= --prefix= --use-log-author
2487 --add-author-from $remote_opts
2490 --edit --rmdir --find-copies-harder --copy-similarity=
2493 case "$subcommand,$cur" in
2495 __gitcomp "--revision= --fetch-all $fc_opts"
2498 __gitcomp "--revision= $fc_opts $init_opts"
2501 __gitcomp "$init_opts"
2505 --merge --strategy= --verbose --dry-run
2506 --fetch-all --no-rebase --commit-url
2507 --revision --interactive $cmt_opts $fc_opts
2511 __gitcomp "--stdin $cmt_opts $fc_opts"
2513 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2514 show-externals,--*|mkdirs,--*)
2515 __gitcomp "--revision="
2519 --limit= --revision= --verbose --incremental
2520 --oneline --show-commit --non-recursive
2521 --authors-file= --color
2526 --merge --verbose --strategy= --local
2527 --fetch-all --dry-run $fc_opts
2531 __gitcomp "--message= --file= --revision= $cmt_opts"
2537 __gitcomp "--dry-run --message --tag"
2540 __gitcomp "--dry-run --message"
2543 __gitcomp "--git-format"
2547 --config-dir= --ignore-paths= --minimize
2548 --no-auth-cache --username=
2552 __gitcomp "--revision= --parent"
2564 while [ $c -lt $cword ]; do
2568 __gitcomp_nl "$(__git_tags)"
2584 __gitcomp_nl "$(__git_tags)"
2590 __gitcomp_nl "$(__git_refs)"
2602 local i c=1 command __git_dir
2604 while [ $c -lt $cword ]; do
2607 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2608 --bare) __git_dir="." ;;
2609 --help) command="help"; break ;;
2612 *) command="$i"; break ;;
2617 if [ -z "$command" ]; then
2631 --no-replace-objects
2635 *) __git_compute_porcelain_commands
2636 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2641 local completion_func="_git_${command//-/_}"
2642 declare -f $completion_func >/dev/null && $completion_func && return
2644 local expansion=$(__git_aliased_command "$command")
2645 if [ -n "$expansion" ]; then
2646 completion_func="_git_${expansion//-/_}"
2647 declare -f $completion_func >/dev/null && $completion_func
2653 __git_has_doubledash && return
2655 local g="$(__gitdir)"
2657 if [ -f "$g/MERGE_HEAD" ]; then
2663 $__git_log_common_options
2664 $__git_log_gitk_options
2670 __git_complete_revlist
2675 if [[ -n ${ZSH_VERSION-} ]]; then
2679 # workaround zsh's bug that leaves 'words' as a special
2680 # variable in versions < 4.3.12
2683 # workaround zsh's bug that quotes spaces in the COMPREPLY
2684 # array if IFS doesn't contain spaces.
2687 local cur words cword prev
2688 _get_comp_words_by_ref -n =: cur words cword prev
2692 # Setup completion for certain functions defined above by setting common
2693 # variables and workarounds.
2694 # This is NOT a public function; use at your own risk.
2697 local wrapper="__git_wrap${2}"
2698 eval "$wrapper () { __git_func_wrap $2 ; }"
2699 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2700 || complete -o default -o nospace -F $wrapper $1
2703 __git_complete git _git
2704 __git_complete gitk _gitk
2706 # The following are necessary only for Cygwin, and only are needed
2707 # when the user has tab-completed the executable name and consequently
2708 # included the '.exe' suffix.
2710 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2711 __git_complete git.exe _git