1 # bash/zsh completion support for core Git.
3 # Copyright (C) 2006,2007 Shawn O. Pearce <spearce@spearce.org>
4 # Conceptually based on gitcompletion (http://gitweb.hawaga.org.uk/).
5 # Distributed under the GNU General Public License, version 2.0.
7 # The contained completion routines provide support for completing:
9 # *) local and remote branch names
10 # *) local and remote tag names
11 # *) .git/remotes file names
12 # *) git 'subcommands'
13 # *) tree paths within 'ref:path/to/file' expressions
14 # *) file paths within current working directory and index
15 # *) common --long-options
17 # To use these routines:
19 # 1) Copy this file to somewhere (e.g. ~/.git-completion.bash).
20 # 2) Add the following line to your .bashrc/.zshrc:
21 # source ~/.git-completion.bash
22 # 3) Consider changing your PS1 to also show the current branch,
23 # see git-prompt.sh for details.
25 # If you use complex aliases of form '!f() { ... }; f', you can use the null
26 # command ':' as the first command in the function body to declare the desired
27 # completion style. For example '!f() { : git commit ; ... }; f' will
28 # tell the completion to use commit completion. This also works with aliases
29 # of form "!sh -c '...'". For example, "!sh -c ': git commit ; ... '".
31 case "$COMP_WORDBREAKS" in
33 *) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
36 # __gitdir accepts 0 or 1 arguments (i.e., location)
37 # returns location of .git repo
40 if [ -z "${1-}" ]; then
41 if [ -n "${__git_dir-}" ]; then
43 elif [ -n "${GIT_DIR-}" ]; then
44 test -d "${GIT_DIR-}" || return 1
46 elif [ -d .git ]; then
49 git rev-parse --git-dir 2>/dev/null
51 elif [ -d "$1/.git" ]; then
58 # The following function is based on code from:
60 # bash_completion - programmable completion functions for bash 3.2+
62 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
63 # © 2009-2010, Bash Completion Maintainers
64 # <bash-completion-devel@lists.alioth.debian.org>
66 # This program is free software; you can redistribute it and/or modify
67 # it under the terms of the GNU General Public License as published by
68 # the Free Software Foundation; either version 2, or (at your option)
71 # This program is distributed in the hope that it will be useful,
72 # but WITHOUT ANY WARRANTY; without even the implied warranty of
73 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
74 # GNU General Public License for more details.
76 # You should have received a copy of the GNU General Public License
77 # along with this program; if not, write to the Free Software Foundation,
78 # Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
80 # The latest version of this software can be obtained here:
82 # http://bash-completion.alioth.debian.org/
86 # This function can be used to access a tokenized list of words
87 # on the command line:
89 # __git_reassemble_comp_words_by_ref '=:'
90 # if test "${words_[cword_-1]}" = -w
95 # The argument should be a collection of characters from the list of
96 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
99 # This is roughly equivalent to going back in time and setting
100 # COMP_WORDBREAKS to exclude those characters. The intent is to
101 # make option types like --date=<type> and <rev>:<path> easy to
102 # recognize by treating each shell word as a single token.
104 # It is best not to set COMP_WORDBREAKS directly because the value is
105 # shared with other completion scripts. By the time the completion
106 # function gets called, COMP_WORDS has already been populated so local
107 # changes to COMP_WORDBREAKS have no effect.
109 # Output: words_, cword_, cur_.
111 __git_reassemble_comp_words_by_ref()
113 local exclude i j first
114 # Which word separators to exclude?
115 exclude="${1//[^$COMP_WORDBREAKS]}"
117 if [ -z "$exclude" ]; then
118 words_=("${COMP_WORDS[@]}")
121 # List of word completion separators has shrunk;
122 # re-assemble words to complete.
123 for ((i=0, j=0; i < ${#COMP_WORDS[@]}; i++, j++)); do
124 # Append each nonempty word consisting of just
125 # word separator characters to the current word.
129 [ -n "${COMP_WORDS[$i]}" ] &&
130 # word consists of excluded word separators
131 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
133 # Attach to the previous token,
134 # unless the previous token is the command name.
135 if [ $j -ge 2 ] && [ -n "$first" ]; then
139 words_[$j]=${words_[j]}${COMP_WORDS[i]}
140 if [ $i = $COMP_CWORD ]; then
143 if (($i < ${#COMP_WORDS[@]} - 1)); then
150 words_[$j]=${words_[j]}${COMP_WORDS[i]}
151 if [ $i = $COMP_CWORD ]; then
157 if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
158 _get_comp_words_by_ref ()
160 local exclude cur_ words_ cword_
161 if [ "$1" = "-n" ]; then
165 __git_reassemble_comp_words_by_ref "$exclude"
166 cur_=${words_[cword_]}
167 while [ $# -gt 0 ]; do
173 prev=${words_[$cword_-1]}
176 words=("${words_[@]}")
189 local x i=${#COMPREPLY[@]}
191 if [[ "$x" == "$3"* ]]; then
192 COMPREPLY[i++]="$2$x$4"
203 # Generates completion reply, appending a space to possible completion words,
205 # It accepts 1 to 4 arguments:
206 # 1: List of possible completion words.
207 # 2: A prefix to be added to each possible completion word (optional).
208 # 3: Generate possible completion matches for this word (optional).
209 # 4: A suffix to be appended to each possible completion word (optional).
212 local cur_="${3-$cur}"
218 local c i=0 IFS=$' \t\n'
221 if [[ $c == "$cur_"* ]]; then
226 COMPREPLY[i++]="${2-}$c"
233 # Variation of __gitcomp_nl () that appends to the existing list of
234 # completion candidates, COMPREPLY.
235 __gitcomp_nl_append ()
238 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
241 # Generates completion reply from newline-separated possible completion words
242 # by appending a space to all of them.
243 # It accepts 1 to 4 arguments:
244 # 1: List of possible completion words, separated by a single newline.
245 # 2: A prefix to be added to each possible completion word (optional).
246 # 3: Generate possible completion matches for this word (optional).
247 # 4: A suffix to be appended to each possible completion word instead of
248 # the default space (optional). If specified but empty, nothing is
253 __gitcomp_nl_append "$@"
256 # Generates completion reply with compgen from newline-separated possible
257 # completion filenames.
258 # It accepts 1 to 3 arguments:
259 # 1: List of possible completion filenames, separated by a single newline.
260 # 2: A directory prefix to be added to each possible completion filename
262 # 3: Generate possible completion matches for this word (optional).
267 # XXX does not work when the directory prefix contains a tilde,
268 # since tilde expansion is not applied.
269 # This means that COMPREPLY will be empty and Bash default
270 # completion will be used.
271 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
273 # use a hack to enable file mode in bash < 4
274 compopt -o filenames +o nospace 2>/dev/null ||
275 compgen -f /non-existing-dir/ > /dev/null
278 # Execute 'git ls-files', unless the --committable option is specified, in
279 # which case it runs 'git diff-index' to find out the files that can be
280 # committed. It return paths relative to the directory specified in the first
281 # argument, and using the options specified in the second argument.
282 __git_ls_files_helper ()
284 if [ "$2" == "--committable" ]; then
285 git -C "$1" diff-index --name-only --relative HEAD
287 # NOTE: $2 is not quoted in order to support multiple options
288 git -C "$1" ls-files --exclude-standard $2
293 # __git_index_files accepts 1 or 2 arguments:
294 # 1: Options to pass to ls-files (required).
295 # 2: A directory path (optional).
296 # If provided, only files within the specified directory are listed.
297 # Sub directories are never recursed. Path must have a trailing
301 local dir="$(__gitdir)" root="${2-.}" file
303 if [ -d "$dir" ]; then
304 __git_ls_files_helper "$root" "$1" |
305 while read -r file; do
307 ?*/*) echo "${file%%/*}" ;;
316 local dir="$(__gitdir)"
317 if [ -d "$dir" ]; then
318 git --git-dir="$dir" for-each-ref --format='%(refname:short)' \
326 local dir="$(__gitdir)"
327 if [ -d "$dir" ]; then
328 git --git-dir="$dir" for-each-ref --format='%(refname:short)' \
334 # __git_refs accepts 0, 1 (to pass to __gitdir), or 2 arguments
335 # presence of 2nd argument means use the guess heuristic employed
336 # by checkout for tracking branches
339 local i hash dir="$(__gitdir "${1-}")" track="${2-}"
341 if [ -d "$dir" ]; then
349 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD; do
350 if [ -e "$dir/$i" ]; then echo $i; fi
352 format="refname:short"
353 refs="refs/tags refs/heads refs/remotes"
356 git --git-dir="$dir" for-each-ref --format="%($format)" \
358 if [ -n "$track" ]; then
359 # employ the heuristic used by git checkout
360 # Try to find a remote branch that matches the completion word
361 # but only output if the branch name is unique
363 git --git-dir="$dir" for-each-ref --shell --format="ref=%(refname:short)" \
365 while read -r entry; do
368 if [[ "$ref" == "$cur"* ]]; then
371 done | sort | uniq -u
377 git ls-remote "$dir" "$cur*" 2>/dev/null | \
378 while read -r hash i; do
387 git for-each-ref --format="%(refname:short)" -- \
388 "refs/remotes/$dir/" 2>/dev/null | sed -e "s#^$dir/##"
393 # __git_refs2 requires 1 argument (to pass to __git_refs)
397 for i in $(__git_refs "$1"); do
402 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
403 __git_refs_remotes ()
406 git ls-remote "$1" 'refs/heads/*' 2>/dev/null | \
407 while read -r hash i; do
408 echo "$i:refs/remotes/$1/${i#refs/heads/}"
414 local d="$(__gitdir)"
415 test -d "$d/remotes" && ls -1 "$d/remotes"
416 git --git-dir="$d" remote
419 __git_list_merge_strategies ()
421 git merge -s help 2>&1 |
422 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
431 __git_merge_strategies=
432 # 'git merge -s help' (and thus detection of the merge strategy
433 # list) fails, unfortunately, if run outside of any git working
434 # tree. __git_merge_strategies is set to the empty string in
435 # that case, and the detection will be repeated the next time it
437 __git_compute_merge_strategies ()
439 test -n "$__git_merge_strategies" ||
440 __git_merge_strategies=$(__git_list_merge_strategies)
443 __git_complete_revlist_file ()
445 local pfx ls ref cur_="$cur"
465 case "$COMP_WORDBREAKS" in
467 *) pfx="$ref:$pfx" ;;
470 __gitcomp_nl "$(git --git-dir="$(__gitdir)" ls-tree "$ls" 2>/dev/null \
471 | sed '/^100... blob /{
487 pfx="${cur_%...*}..."
489 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
494 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
497 __gitcomp_nl "$(__git_refs)"
503 # __git_complete_index_file requires 1 argument:
504 # 1: the options to pass to ls-file
506 # The exception is --committable, which finds the files appropriate commit.
507 __git_complete_index_file ()
509 local pfx="" cur_="$cur"
519 __gitcomp_file "$(__git_index_files "$1" ${pfx:+"$pfx"})" "$pfx" "$cur_"
522 __git_complete_file ()
524 __git_complete_revlist_file
527 __git_complete_revlist ()
529 __git_complete_revlist_file
532 __git_complete_remote_or_refspec ()
534 local cur_="$cur" cmd="${words[1]}"
535 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
536 if [ "$cmd" = "remote" ]; then
539 while [ $c -lt $cword ]; do
542 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
545 push) no_complete_refspec=1 ;;
553 *) remote="$i"; break ;;
557 if [ -z "$remote" ]; then
558 __gitcomp_nl "$(__git_remotes)"
561 if [ $no_complete_refspec = 1 ]; then
564 [ "$remote" = "." ] && remote=
567 case "$COMP_WORDBREAKS" in
569 *) pfx="${cur_%%:*}:" ;;
581 if [ $lhs = 1 ]; then
582 __gitcomp_nl "$(__git_refs2 "$remote")" "$pfx" "$cur_"
584 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
588 if [ $lhs = 1 ]; then
589 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
591 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
595 if [ $lhs = 1 ]; then
596 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
598 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
604 __git_complete_strategy ()
606 __git_compute_merge_strategies
609 __gitcomp "$__git_merge_strategies"
614 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
622 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
624 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
626 git help -a|egrep '^ [a-zA-Z0-9]'
630 __git_list_all_commands ()
633 for i in $(__git_commands)
636 *--*) : helper pattern;;
643 __git_compute_all_commands ()
645 test -n "$__git_all_commands" ||
646 __git_all_commands=$(__git_list_all_commands)
649 __git_list_porcelain_commands ()
652 __git_compute_all_commands
653 for i in $__git_all_commands
656 *--*) : helper pattern;;
657 applymbox) : ask gittus;;
658 applypatch) : ask gittus;;
659 archimport) : import;;
660 cat-file) : plumbing;;
661 check-attr) : plumbing;;
662 check-ignore) : plumbing;;
663 check-mailmap) : plumbing;;
664 check-ref-format) : plumbing;;
665 checkout-index) : plumbing;;
666 commit-tree) : plumbing;;
667 count-objects) : infrequent;;
668 credential-cache) : credentials helper;;
669 credential-store) : credentials helper;;
670 cvsexportcommit) : export;;
671 cvsimport) : import;;
672 cvsserver) : daemon;;
674 diff-files) : plumbing;;
675 diff-index) : plumbing;;
676 diff-tree) : plumbing;;
677 fast-import) : import;;
678 fast-export) : export;;
679 fsck-objects) : plumbing;;
680 fetch-pack) : plumbing;;
681 fmt-merge-msg) : plumbing;;
682 for-each-ref) : plumbing;;
683 hash-object) : plumbing;;
684 http-*) : transport;;
685 index-pack) : plumbing;;
686 init-db) : deprecated;;
687 local-fetch) : plumbing;;
688 ls-files) : plumbing;;
689 ls-remote) : plumbing;;
690 ls-tree) : plumbing;;
691 mailinfo) : plumbing;;
692 mailsplit) : plumbing;;
693 merge-*) : plumbing;;
696 pack-objects) : plumbing;;
697 pack-redundant) : plumbing;;
698 pack-refs) : plumbing;;
699 parse-remote) : plumbing;;
700 patch-id) : plumbing;;
702 prune-packed) : plumbing;;
703 quiltimport) : import;;
704 read-tree) : plumbing;;
705 receive-pack) : plumbing;;
706 remote-*) : transport;;
708 rev-list) : plumbing;;
709 rev-parse) : plumbing;;
710 runstatus) : plumbing;;
711 sh-setup) : internal;;
713 show-ref) : plumbing;;
714 send-pack) : plumbing;;
715 show-index) : plumbing;;
717 stripspace) : plumbing;;
718 symbolic-ref) : plumbing;;
719 unpack-file) : plumbing;;
720 unpack-objects) : plumbing;;
721 update-index) : plumbing;;
722 update-ref) : plumbing;;
723 update-server-info) : daemon;;
724 upload-archive) : plumbing;;
725 upload-pack) : plumbing;;
726 write-tree) : plumbing;;
728 verify-pack) : infrequent;;
729 verify-tag) : plumbing;;
735 __git_porcelain_commands=
736 __git_compute_porcelain_commands ()
738 __git_compute_all_commands
739 test -n "$__git_porcelain_commands" ||
740 __git_porcelain_commands=$(__git_list_porcelain_commands)
743 __git_pretty_aliases ()
746 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "pretty\..*" 2>/dev/null); do
759 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "alias\..*" 2>/dev/null); do
769 # __git_aliased_command requires 1 argument
770 __git_aliased_command ()
772 local word cmdline=$(git --git-dir="$(__gitdir)" \
773 config --get "alias.$1")
774 for word in $cmdline; do
780 \!*) : shell command alias ;;
782 *=*) : setting env ;;
784 \(\)) : skip parens of shell function definition ;;
785 {) : skip start of shell helper function ;;
786 :) : skip null command ;;
787 \'*) : skip opening quote after sh -c ;;
795 # __git_find_on_cmdline requires 1 argument
796 __git_find_on_cmdline ()
798 local word subcommand c=1
799 while [ $c -lt $cword ]; do
801 for subcommand in $1; do
802 if [ "$subcommand" = "$word" ]; then
811 __git_has_doubledash ()
814 while [ $c -lt $cword ]; do
815 if [ "--" = "${words[c]}" ]; then
823 # Try to count non option arguments passed on the command line for the
824 # specified git command.
825 # When options are used, it is necessary to use the special -- option to
826 # tell the implementation were non option arguments begin.
827 # XXX this can not be improved, since options can appear everywhere, as
831 # __git_count_arguments requires 1 argument: the git command executed.
832 __git_count_arguments ()
836 # Skip "git" (first argument)
837 for ((i=1; i < ${#words[@]}; i++)); do
842 # Good; we can assume that the following are only non
847 # Skip the specified git command and discard git
860 __git_whitespacelist="nowarn warn error error-all fix"
864 local dir="$(__gitdir)"
865 if [ -d "$dir"/rebase-apply ]; then
866 __gitcomp "--skip --continue --resolved --abort"
871 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
876 --3way --committer-date-is-author-date --ignore-date
877 --ignore-whitespace --ignore-space-change
878 --interactive --keep --no-utf8 --signoff --utf8
879 --whitespace= --scissors
889 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
894 --stat --numstat --summary --check --index
895 --cached --index-info --reverse --reject --unidiff-zero
896 --apply --no-add --exclude=
897 --ignore-whitespace --ignore-space-change
898 --whitespace= --inaccurate-eof --verbose
909 --interactive --refresh --patch --update --dry-run
910 --ignore-errors --intent-to-add
915 # XXX should we check for --update and --all options ?
916 __git_complete_index_file "--others --modified --directory --no-empty-directory"
923 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
927 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
932 --format= --list --verbose
933 --prefix= --remote= --exec=
943 __git_has_doubledash && return
945 local subcommands="start bad good skip reset visualize replay log run"
946 local subcommand="$(__git_find_on_cmdline "$subcommands")"
947 if [ -z "$subcommand" ]; then
948 if [ -f "$(__gitdir)"/BISECT_START ]; then
949 __gitcomp "$subcommands"
951 __gitcomp "replay start"
956 case "$subcommand" in
957 bad|good|reset|skip|start)
958 __gitcomp_nl "$(__git_refs)"
967 local i c=1 only_local_ref="n" has_r="n"
969 while [ $c -lt $cword ]; do
972 -d|-m) only_local_ref="y" ;;
980 __gitcomp_nl "$(__git_refs)" "" "${cur##--set-upstream-to=}"
984 --color --no-color --verbose --abbrev= --no-abbrev
985 --track --no-track --contains --merged --no-merged
986 --set-upstream-to= --edit-description --list
991 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
992 __gitcomp_nl "$(__git_heads)"
994 __gitcomp_nl "$(__git_refs)"
1002 local cmd="${words[2]}"
1005 __gitcomp "create list-heads verify unbundle"
1008 # looking for a file
1013 __git_complete_revlist
1022 __git_has_doubledash && return
1026 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1030 --quiet --ours --theirs --track --no-track --merge
1031 --conflict= --orphan --patch
1035 # check if --track, --no-track, or --no-guess was specified
1036 # if so, disable DWIM mode
1037 local flags="--track --no-track --no-guess" track=1
1038 if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1041 __gitcomp_nl "$(__git_refs '' $track)"
1048 __gitcomp_nl "$(__git_refs)"
1053 local dir="$(__gitdir)"
1054 if [ -f "$dir"/CHERRY_PICK_HEAD ]; then
1055 __gitcomp "--continue --quit --abort"
1060 __gitcomp "--edit --no-commit --signoff --strategy= --mainline"
1063 __gitcomp_nl "$(__git_refs)"
1072 __gitcomp "--dry-run --quiet"
1077 # XXX should we check for -x option ?
1078 __git_complete_index_file "--others --directory"
1110 __gitcomp_nl "$(__git_refs)" "" "${cur}"
1117 __gitcomp "default scissors strip verbatim whitespace
1118 " "" "${cur##--cleanup=}"
1121 --reuse-message=*|--reedit-message=*|\
1122 --fixup=*|--squash=*)
1123 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1126 --untracked-files=*)
1127 __gitcomp "all no normal" "" "${cur##--untracked-files=}"
1132 --all --author= --signoff --verify --no-verify
1134 --amend --include --only --interactive
1135 --dry-run --reuse-message= --reedit-message=
1136 --reset-author --file= --message= --template=
1137 --cleanup= --untracked-files --untracked-files=
1138 --verbose --quiet --fixup= --squash=
1143 if git rev-parse --verify --quiet HEAD >/dev/null; then
1144 __git_complete_index_file "--committable"
1146 # This is the first commit
1147 __git_complete_index_file "--cached"
1156 --all --tags --contains --abbrev= --candidates=
1157 --exact-match --debug --long --match --always
1161 __gitcomp_nl "$(__git_refs)"
1164 __git_diff_algorithms="myers minimal patience histogram"
1166 __git_diff_common_options="--stat --numstat --shortstat --summary
1167 --patch-with-stat --name-only --name-status --color
1168 --no-color --color-words --no-renames --check
1169 --full-index --binary --abbrev --diff-filter=
1170 --find-copies-harder
1171 --text --ignore-space-at-eol --ignore-space-change
1172 --ignore-all-space --ignore-blank-lines --exit-code
1173 --quiet --ext-diff --no-ext-diff
1174 --no-prefix --src-prefix= --dst-prefix=
1175 --inter-hunk-context=
1176 --patience --histogram --minimal
1178 --dirstat --dirstat= --dirstat-by-file
1179 --dirstat-by-file= --cumulative
1185 __git_has_doubledash && return
1189 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1193 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1194 --base --ours --theirs --no-index
1195 $__git_diff_common_options
1200 __git_complete_revlist_file
1203 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1204 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc codecompare
1209 __git_has_doubledash && return
1213 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1217 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1218 --base --ours --theirs
1219 --no-renames --diff-filter= --find-copies-harder
1220 --relative --ignore-submodules
1225 __git_complete_revlist_file
1228 __git_fetch_recurse_submodules="yes on-demand no"
1230 __git_fetch_options="
1231 --quiet --verbose --append --upload-pack --force --keep --depth=
1232 --tags --no-tags --all --prune --dry-run --recurse-submodules=
1238 --recurse-submodules=*)
1239 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1243 __gitcomp "$__git_fetch_options"
1247 __git_complete_remote_or_refspec
1250 __git_format_patch_options="
1251 --stdout --attach --no-attach --thread --thread= --no-thread
1252 --numbered --start-number --numbered-files --keep-subject --signoff
1253 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1254 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1255 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1256 --output-directory --reroll-count --to= --quiet --notes
1259 _git_format_patch ()
1265 " "" "${cur##--thread=}"
1269 __gitcomp "$__git_format_patch_options"
1273 __git_complete_revlist
1281 --tags --root --unreachable --cache --no-reflogs --full
1282 --strict --verbose --lost-found
1293 __gitcomp "--prune --aggressive"
1304 __git_match_ctag() {
1305 awk "/^${1//\//\\/}/ { print \$1 }" "$2"
1310 __git_has_doubledash && return
1316 --text --ignore-case --word-regexp --invert-match
1317 --full-name --line-number
1318 --extended-regexp --basic-regexp --fixed-strings
1320 --files-with-matches --name-only
1321 --files-without-match
1324 --and --or --not --all-match
1330 case "$cword,$prev" in
1332 if test -r tags; then
1333 __gitcomp_nl "$(__git_match_ctag "$cur" tags)"
1339 __gitcomp_nl "$(__git_refs)"
1346 __gitcomp "--all --info --man --web"
1350 __git_compute_all_commands
1351 __gitcomp "$__git_all_commands $(__git_aliases)
1352 attributes cli core-tutorial cvs-migration
1353 diffcore gitk glossary hooks ignore modules
1354 namespaces repository-layout tutorial tutorial-2
1364 false true umask group all world everybody
1365 " "" "${cur##--shared=}"
1369 __gitcomp "--quiet --bare --template= --shared --shared="
1379 __gitcomp "--cached --deleted --modified --others --ignored
1380 --stage --directory --no-empty-directory --unmerged
1381 --killed --exclude= --exclude-from=
1382 --exclude-per-directory= --exclude-standard
1383 --error-unmatch --with-tree= --full-name
1384 --abbrev --ignored --exclude-per-directory
1390 # XXX ignore options like --modified and always suggest all cached
1392 __git_complete_index_file "--cached"
1397 __gitcomp_nl "$(__git_remotes)"
1405 # Options that go well for log, shortlog and gitk
1406 __git_log_common_options="
1408 --branches --tags --remotes
1409 --first-parent --merges --no-merges
1411 --max-age= --since= --after=
1412 --min-age= --until= --before=
1413 --min-parents= --max-parents=
1414 --no-min-parents --no-max-parents
1416 # Options that go well for log and gitk (not shortlog)
1417 __git_log_gitk_options="
1418 --dense --sparse --full-history
1419 --simplify-merges --simplify-by-decoration
1420 --left-right --notes --no-notes
1422 # Options that go well for log and shortlog (not gitk)
1423 __git_log_shortlog_options="
1424 --author= --committer= --grep=
1425 --all-match --invert-grep
1428 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1429 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1433 __git_has_doubledash && return
1435 local g="$(git rev-parse --git-dir 2>/dev/null)"
1437 if [ -f "$g/MERGE_HEAD" ]; then
1441 --pretty=*|--format=*)
1442 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1447 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1451 __gitcomp "full short no" "" "${cur##--decorate=}"
1456 $__git_log_common_options
1457 $__git_log_shortlog_options
1458 $__git_log_gitk_options
1459 --root --topo-order --date-order --reverse
1460 --follow --full-diff
1461 --abbrev-commit --abbrev=
1462 --relative-date --date=
1463 --pretty= --format= --oneline
1468 --decorate --decorate=
1470 --parents --children
1472 $__git_diff_common_options
1473 --pickaxe-all --pickaxe-regex
1478 __git_complete_revlist
1481 # Common merge options shared by git-merge(1) and git-pull(1).
1482 __git_merge_options="
1483 --no-commit --no-stat --log --no-log --squash --strategy
1484 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1485 --verify-signatures --no-verify-signatures --gpg-sign
1486 --quiet --verbose --progress --no-progress
1491 __git_complete_strategy && return
1495 __gitcomp "$__git_merge_options
1496 --rerere-autoupdate --no-rerere-autoupdate --abort"
1499 __gitcomp_nl "$(__git_refs)"
1506 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1520 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1524 __gitcomp_nl "$(__git_refs)"
1531 __gitcomp "--dry-run"
1536 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1537 # We need to show both cached and untracked files (including
1538 # empty directories) since this may not be the last argument.
1539 __git_complete_index_file "--cached --others --directory"
1541 __git_complete_index_file "--cached"
1547 __gitcomp "--tags --all --stdin"
1552 local subcommands='add append copy edit list prune remove show'
1553 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1555 case "$subcommand,$cur" in
1562 __gitcomp_nl "$(__git_refs)"
1565 __gitcomp "$subcommands --ref"
1569 add,--reuse-message=*|append,--reuse-message=*|\
1570 add,--reedit-message=*|append,--reedit-message=*)
1571 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1574 __gitcomp '--file= --message= --reedit-message=
1581 __gitcomp '--dry-run --verbose'
1590 __gitcomp_nl "$(__git_refs)"
1599 __git_complete_strategy && return
1602 --recurse-submodules=*)
1603 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1608 --rebase --no-rebase
1609 $__git_merge_options
1610 $__git_fetch_options
1615 __git_complete_remote_or_refspec
1618 __git_push_recurse_submodules="check on-demand"
1620 __git_complete_force_with_lease ()
1628 __gitcomp_nl "$(__git_refs)" "" "${cur_#*:}"
1631 __gitcomp_nl "$(__git_refs)" "" "$cur_"
1640 __gitcomp_nl "$(__git_remotes)"
1643 --recurse-submodules)
1644 __gitcomp "$__git_push_recurse_submodules"
1650 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1653 --recurse-submodules=*)
1654 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1657 --force-with-lease=*)
1658 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1663 --all --mirror --tags --dry-run --force --verbose
1664 --quiet --prune --delete --follow-tags
1665 --receive-pack= --repo= --set-upstream
1666 --force-with-lease --force-with-lease= --recurse-submodules=
1671 __git_complete_remote_or_refspec
1676 local dir="$(__gitdir)"
1677 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1678 __gitcomp "--continue --skip --abort"
1681 __git_complete_strategy && return
1684 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1689 --onto --merge --strategy --interactive
1690 --preserve-merges --stat --no-stat
1691 --committer-date-is-author-date --ignore-date
1692 --ignore-whitespace --whitespace=
1693 --autosquash --fork-point --no-fork-point
1699 __gitcomp_nl "$(__git_refs)"
1704 local subcommands="show delete expire"
1705 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1707 if [ -z "$subcommand" ]; then
1708 __gitcomp "$subcommands"
1710 __gitcomp_nl "$(__git_refs)"
1714 __git_send_email_confirm_options="always never auto cc compose"
1715 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1722 $__git_send_email_confirm_options
1723 " "" "${cur##--confirm=}"
1728 $__git_send_email_suppresscc_options
1729 " "" "${cur##--suppress-cc=}"
1733 --smtp-encryption=*)
1734 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1740 " "" "${cur##--thread=}"
1744 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1745 --compose --confirm= --dry-run --envelope-sender
1747 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1748 --no-suppress-from --no-thread --quiet
1749 --signed-off-by-cc --smtp-pass --smtp-server
1750 --smtp-server-port --smtp-encryption= --smtp-user
1751 --subject --suppress-cc= --suppress-from --thread --to
1752 --validate --no-validate
1753 $__git_format_patch_options"
1757 __git_complete_revlist
1765 __git_config_get_set_variables ()
1767 local prevword word config_file= c=$cword
1768 while [ $c -gt 1 ]; do
1771 --system|--global|--local|--file=*)
1776 config_file="$word $prevword"
1784 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1798 branch.*.remote|branch.*.pushremote)
1799 __gitcomp_nl "$(__git_remotes)"
1803 __gitcomp_nl "$(__git_refs)"
1807 __gitcomp "false true"
1811 __gitcomp_nl "$(__git_remotes)"
1815 local remote="${prev#remote.}"
1816 remote="${remote%.fetch}"
1817 if [ -z "$cur" ]; then
1818 __gitcomp_nl "refs/heads/" "" "" ""
1821 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1825 local remote="${prev#remote.}"
1826 remote="${remote%.push}"
1827 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1828 for-each-ref --format='%(refname):%(refname)' \
1832 pull.twohead|pull.octopus)
1833 __git_compute_merge_strategies
1834 __gitcomp "$__git_merge_strategies"
1837 color.branch|color.diff|color.interactive|\
1838 color.showbranch|color.status|color.ui)
1839 __gitcomp "always never auto"
1843 __gitcomp "false true"
1848 normal black red green yellow blue magenta cyan white
1849 bold dim ul blink reverse
1854 __gitcomp "log short"
1858 __gitcomp "man info web html"
1862 __gitcomp "$__git_log_date_formats"
1865 sendemail.aliasesfiletype)
1866 __gitcomp "mutt mailrc pine elm gnus"
1870 __gitcomp "$__git_send_email_confirm_options"
1873 sendemail.suppresscc)
1874 __gitcomp "$__git_send_email_suppresscc_options"
1877 sendemail.transferencoding)
1878 __gitcomp "7bit 8bit quoted-printable base64"
1881 --get|--get-all|--unset|--unset-all)
1882 __gitcomp_nl "$(__git_config_get_set_variables)"
1892 --system --global --local --file=
1893 --list --replace-all
1894 --get --get-all --get-regexp
1895 --add --unset --unset-all
1896 --remove-section --rename-section
1901 local pfx="${cur%.*}." cur_="${cur##*.}"
1902 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1906 local pfx="${cur%.*}." cur_="${cur#*.}"
1907 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1908 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1912 local pfx="${cur%.*}." cur_="${cur##*.}"
1914 argprompt cmd confirm needsfile noconsole norescan
1915 prompt revprompt revunmerged title
1920 local pfx="${cur%.*}." cur_="${cur##*.}"
1921 __gitcomp "cmd path" "$pfx" "$cur_"
1925 local pfx="${cur%.*}." cur_="${cur##*.}"
1926 __gitcomp "cmd path" "$pfx" "$cur_"
1930 local pfx="${cur%.*}." cur_="${cur##*.}"
1931 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1935 local pfx="${cur%.*}." cur_="${cur#*.}"
1936 __git_compute_all_commands
1937 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1941 local pfx="${cur%.*}." cur_="${cur##*.}"
1943 url proxy fetch push mirror skipDefaultUpdate
1944 receivepack uploadpack tagopt pushurl
1949 local pfx="${cur%.*}." cur_="${cur#*.}"
1950 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1951 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1955 local pfx="${cur%.*}." cur_="${cur##*.}"
1956 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1962 advice.commitBeforeMerge
1964 advice.implicitIdentity
1965 advice.pushNonFastForward
1966 advice.resolveConflict
1970 apply.ignorewhitespace
1972 branch.autosetupmerge
1973 branch.autosetuprebase
1977 color.branch.current
1982 color.decorate.branch
1983 color.decorate.remoteBranch
1984 color.decorate.stash
1994 color.diff.whitespace
1999 color.grep.linenumber
2002 color.grep.separator
2004 color.interactive.error
2005 color.interactive.header
2006 color.interactive.help
2007 color.interactive.prompt
2012 color.status.changed
2014 color.status.nobranch
2015 color.status.unmerged
2016 color.status.untracked
2017 color.status.updated
2026 core.bigFileThreshold
2029 core.deltaBaseCacheLimit
2034 core.fsyncobjectfiles
2038 core.logAllRefUpdates
2039 core.loosecompression
2042 core.packedGitWindowSize
2044 core.preferSymlinkRefs
2047 core.repositoryFormatVersion
2049 core.sharedRepository
2053 core.warnAmbiguousRefs
2056 diff.autorefreshindex
2058 diff.ignoreSubmodules
2065 diff.suppressBlankEmpty
2071 fetch.recurseSubmodules
2081 format.subjectprefix
2092 gc.reflogexpireunreachable
2096 gitcvs.commitmsgannotation
2097 gitcvs.dbTableNamePrefix
2108 gui.copyblamethreshold
2112 gui.matchtrackingbranch
2113 gui.newbranchtemplate
2114 gui.pruneduringfetch
2115 gui.spellingdictionary
2130 http.sslCertPasswordProtected
2135 i18n.logOutputEncoding
2141 imap.preformattedHTML
2151 interactive.singlekey
2167 mergetool.keepBackup
2168 mergetool.keepTemporaries
2173 notes.rewrite.rebase
2177 pack.deltaCacheLimit
2194 receive.denyCurrentBranch
2195 receive.denyDeleteCurrent
2197 receive.denyNonFastForwards
2200 receive.updateserverinfo
2203 repack.usedeltabaseoffset
2207 sendemail.aliasesfile
2208 sendemail.aliasfiletype
2212 sendemail.chainreplyto
2214 sendemail.envelopesender
2218 sendemail.signedoffbycc
2219 sendemail.smtpdomain
2220 sendemail.smtpencryption
2222 sendemail.smtpserver
2223 sendemail.smtpserveroption
2224 sendemail.smtpserverport
2226 sendemail.suppresscc
2227 sendemail.suppressfrom
2232 status.relativePaths
2233 status.showUntrackedFiles
2234 status.submodulesummary
2237 transfer.unpackLimit
2249 local subcommands="add rename remove set-head set-branches set-url show prune update"
2250 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2251 if [ -z "$subcommand" ]; then
2252 __gitcomp "$subcommands"
2256 case "$subcommand" in
2257 rename|remove|set-url|show|prune)
2258 __gitcomp_nl "$(__git_remotes)"
2260 set-head|set-branches)
2261 __git_complete_remote_or_refspec
2264 local i c='' IFS=$'\n'
2265 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "remotes\..*" 2>/dev/null); do
2278 __gitcomp_nl "$(__git_refs)"
2283 __git_has_doubledash && return
2287 __gitcomp "--merge --mixed --hard --soft --patch"
2291 __gitcomp_nl "$(__git_refs)"
2298 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2302 __gitcomp_nl "$(__git_refs)"
2309 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2314 __git_complete_index_file "--cached"
2319 __git_has_doubledash && return
2324 $__git_log_common_options
2325 $__git_log_shortlog_options
2326 --numbered --summary
2331 __git_complete_revlist
2336 __git_has_doubledash && return
2339 --pretty=*|--format=*)
2340 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2345 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2349 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2351 $__git_diff_common_options
2356 __git_complete_revlist_file
2364 --all --remotes --topo-order --current --more=
2365 --list --independent --merge-base --no-name
2367 --sha1-name --sparse --topics --reflog
2372 __git_complete_revlist
2377 local save_opts='--keep-index --no-keep-index --quiet --patch'
2378 local subcommands='save list show apply clear drop pop create branch'
2379 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2380 if [ -z "$subcommand" ]; then
2383 __gitcomp "$save_opts"
2386 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2387 __gitcomp "$subcommands"
2392 case "$subcommand,$cur" in
2394 __gitcomp "$save_opts"
2397 __gitcomp "--index --quiet"
2399 show,--*|drop,--*|branch,--*)
2401 show,*|apply,*|drop,*|pop,*|branch,*)
2402 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2403 | sed -n -e 's/:.*//p')"
2413 __git_has_doubledash && return
2415 local subcommands="add status init deinit update summary foreach sync"
2416 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2419 __gitcomp "--quiet --cached"
2422 __gitcomp "$subcommands"
2432 init fetch clone rebase dcommit log find-rev
2433 set-tree commit-diff info create-ignore propget
2434 proplist show-ignore show-externals branch tag blame
2435 migrate mkdirs reset gc
2437 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2438 if [ -z "$subcommand" ]; then
2439 __gitcomp "$subcommands"
2441 local remote_opts="--username= --config-dir= --no-auth-cache"
2443 --follow-parent --authors-file= --repack=
2444 --no-metadata --use-svm-props --use-svnsync-props
2445 --log-window-size= --no-checkout --quiet
2446 --repack-flags --use-log-author --localtime
2447 --ignore-paths= --include-paths= $remote_opts
2450 --template= --shared= --trunk= --tags=
2451 --branches= --stdlayout --minimize-url
2452 --no-metadata --use-svm-props --use-svnsync-props
2453 --rewrite-root= --prefix= --use-log-author
2454 --add-author-from $remote_opts
2457 --edit --rmdir --find-copies-harder --copy-similarity=
2460 case "$subcommand,$cur" in
2462 __gitcomp "--revision= --fetch-all $fc_opts"
2465 __gitcomp "--revision= $fc_opts $init_opts"
2468 __gitcomp "$init_opts"
2472 --merge --strategy= --verbose --dry-run
2473 --fetch-all --no-rebase --commit-url
2474 --revision --interactive $cmt_opts $fc_opts
2478 __gitcomp "--stdin $cmt_opts $fc_opts"
2480 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2481 show-externals,--*|mkdirs,--*)
2482 __gitcomp "--revision="
2486 --limit= --revision= --verbose --incremental
2487 --oneline --show-commit --non-recursive
2488 --authors-file= --color
2493 --merge --verbose --strategy= --local
2494 --fetch-all --dry-run $fc_opts
2498 __gitcomp "--message= --file= --revision= $cmt_opts"
2504 __gitcomp "--dry-run --message --tag"
2507 __gitcomp "--dry-run --message"
2510 __gitcomp "--git-format"
2514 --config-dir= --ignore-paths= --minimize
2515 --no-auth-cache --username=
2519 __gitcomp "--revision= --parent"
2530 while [ $c -lt $cword ]; do
2534 __gitcomp_nl "$(__git_tags)"
2549 __gitcomp_nl "$(__git_tags)"
2553 __gitcomp_nl "$(__git_refs)"
2560 --list --delete --verify --annotate --message --file
2561 --sign --cleanup --local-user --force --column --sort
2562 --contains --points-at
2575 local i c=1 command __git_dir
2577 while [ $c -lt $cword ]; do
2580 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2581 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2582 --bare) __git_dir="." ;;
2583 --help) command="help"; break ;;
2584 -c|--work-tree|--namespace) ((c++)) ;;
2586 *) command="$i"; break ;;
2591 if [ -z "$command" ]; then
2606 --no-replace-objects
2610 *) __git_compute_porcelain_commands
2611 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2616 local completion_func="_git_${command//-/_}"
2617 declare -f $completion_func >/dev/null && $completion_func && return
2619 local expansion=$(__git_aliased_command "$command")
2620 if [ -n "$expansion" ]; then
2622 completion_func="_git_${expansion//-/_}"
2623 declare -f $completion_func >/dev/null && $completion_func
2629 __git_has_doubledash && return
2631 local g="$(__gitdir)"
2633 if [ -f "$g/MERGE_HEAD" ]; then
2639 $__git_log_common_options
2640 $__git_log_gitk_options
2646 __git_complete_revlist
2649 if [[ -n ${ZSH_VERSION-} ]]; then
2650 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2652 autoload -U +X compinit && compinit
2658 local cur_="${3-$cur}"
2664 local c IFS=$' \t\n'
2672 array[${#array[@]}+1]="$c"
2675 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
2686 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2695 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2700 local _ret=1 cur cword prev
2701 cur=${words[CURRENT]}
2702 prev=${words[CURRENT-1]}
2704 emulate ksh -c __${service}_main
2705 let _ret && _default && _ret=0
2709 compdef _git git gitk
2715 local cur words cword prev
2716 _get_comp_words_by_ref -n =: cur words cword prev
2720 # Setup completion for certain functions defined above by setting common
2721 # variables and workarounds.
2722 # This is NOT a public function; use at your own risk.
2725 local wrapper="__git_wrap${2}"
2726 eval "$wrapper () { __git_func_wrap $2 ; }"
2727 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2728 || complete -o default -o nospace -F $wrapper $1
2731 # wrapper for backwards compatibility
2734 __git_wrap__git_main
2737 # wrapper for backwards compatibility
2740 __git_wrap__gitk_main
2743 __git_complete git __git_main
2744 __git_complete gitk __gitk_main
2746 # The following are necessary only for Cygwin, and only are needed
2747 # when the user has tab-completed the executable name and consequently
2748 # included the '.exe' suffix.
2750 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2751 __git_complete git.exe __git_main