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 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
1467 --decorate --decorate=
1469 --parents --children
1471 $__git_diff_common_options
1472 --pickaxe-all --pickaxe-regex
1477 __git_complete_revlist
1480 # Common merge options shared by git-merge(1) and git-pull(1).
1481 __git_merge_options="
1482 --no-commit --no-stat --log --no-log --squash --strategy
1483 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1484 --verify-signatures --no-verify-signatures --gpg-sign
1485 --quiet --verbose --progress --no-progress
1490 __git_complete_strategy && return
1494 __gitcomp "$__git_merge_options
1495 --rerere-autoupdate --no-rerere-autoupdate --abort"
1498 __gitcomp_nl "$(__git_refs)"
1505 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1519 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1523 __gitcomp_nl "$(__git_refs)"
1530 __gitcomp "--dry-run"
1535 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1536 # We need to show both cached and untracked files (including
1537 # empty directories) since this may not be the last argument.
1538 __git_complete_index_file "--cached --others --directory"
1540 __git_complete_index_file "--cached"
1546 __gitcomp "--tags --all --stdin"
1551 local subcommands='add append copy edit list prune remove show'
1552 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1554 case "$subcommand,$cur" in
1561 __gitcomp_nl "$(__git_refs)"
1564 __gitcomp "$subcommands --ref"
1568 add,--reuse-message=*|append,--reuse-message=*|\
1569 add,--reedit-message=*|append,--reedit-message=*)
1570 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1573 __gitcomp '--file= --message= --reedit-message=
1580 __gitcomp '--dry-run --verbose'
1589 __gitcomp_nl "$(__git_refs)"
1598 __git_complete_strategy && return
1601 --recurse-submodules=*)
1602 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1607 --rebase --no-rebase
1608 $__git_merge_options
1609 $__git_fetch_options
1614 __git_complete_remote_or_refspec
1617 __git_push_recurse_submodules="check on-demand"
1619 __git_complete_force_with_lease ()
1627 __gitcomp_nl "$(__git_refs)" "" "${cur_#*:}"
1630 __gitcomp_nl "$(__git_refs)" "" "$cur_"
1639 __gitcomp_nl "$(__git_remotes)"
1642 --recurse-submodules)
1643 __gitcomp "$__git_push_recurse_submodules"
1649 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1652 --recurse-submodules=*)
1653 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1656 --force-with-lease=*)
1657 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1662 --all --mirror --tags --dry-run --force --verbose
1663 --quiet --prune --delete --follow-tags
1664 --receive-pack= --repo= --set-upstream
1665 --force-with-lease --force-with-lease= --recurse-submodules=
1670 __git_complete_remote_or_refspec
1675 local dir="$(__gitdir)"
1676 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1677 __gitcomp "--continue --skip --abort"
1680 __git_complete_strategy && return
1683 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1688 --onto --merge --strategy --interactive
1689 --preserve-merges --stat --no-stat
1690 --committer-date-is-author-date --ignore-date
1691 --ignore-whitespace --whitespace=
1692 --autosquash --fork-point --no-fork-point
1698 __gitcomp_nl "$(__git_refs)"
1703 local subcommands="show delete expire"
1704 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1706 if [ -z "$subcommand" ]; then
1707 __gitcomp "$subcommands"
1709 __gitcomp_nl "$(__git_refs)"
1713 __git_send_email_confirm_options="always never auto cc compose"
1714 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1721 $__git_send_email_confirm_options
1722 " "" "${cur##--confirm=}"
1727 $__git_send_email_suppresscc_options
1728 " "" "${cur##--suppress-cc=}"
1732 --smtp-encryption=*)
1733 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1739 " "" "${cur##--thread=}"
1743 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1744 --compose --confirm= --dry-run --envelope-sender
1746 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1747 --no-suppress-from --no-thread --quiet
1748 --signed-off-by-cc --smtp-pass --smtp-server
1749 --smtp-server-port --smtp-encryption= --smtp-user
1750 --subject --suppress-cc= --suppress-from --thread --to
1751 --validate --no-validate
1752 $__git_format_patch_options"
1756 __git_complete_revlist
1764 __git_config_get_set_variables ()
1766 local prevword word config_file= c=$cword
1767 while [ $c -gt 1 ]; do
1770 --system|--global|--local|--file=*)
1775 config_file="$word $prevword"
1783 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1797 branch.*.remote|branch.*.pushremote)
1798 __gitcomp_nl "$(__git_remotes)"
1802 __gitcomp_nl "$(__git_refs)"
1806 __gitcomp "false true"
1810 __gitcomp_nl "$(__git_remotes)"
1814 local remote="${prev#remote.}"
1815 remote="${remote%.fetch}"
1816 if [ -z "$cur" ]; then
1817 __gitcomp_nl "refs/heads/" "" "" ""
1820 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1824 local remote="${prev#remote.}"
1825 remote="${remote%.push}"
1826 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1827 for-each-ref --format='%(refname):%(refname)' \
1831 pull.twohead|pull.octopus)
1832 __git_compute_merge_strategies
1833 __gitcomp "$__git_merge_strategies"
1836 color.branch|color.diff|color.interactive|\
1837 color.showbranch|color.status|color.ui)
1838 __gitcomp "always never auto"
1842 __gitcomp "false true"
1847 normal black red green yellow blue magenta cyan white
1848 bold dim ul blink reverse
1853 __gitcomp "log short"
1857 __gitcomp "man info web html"
1861 __gitcomp "$__git_log_date_formats"
1864 sendemail.aliasesfiletype)
1865 __gitcomp "mutt mailrc pine elm gnus"
1869 __gitcomp "$__git_send_email_confirm_options"
1872 sendemail.suppresscc)
1873 __gitcomp "$__git_send_email_suppresscc_options"
1876 sendemail.transferencoding)
1877 __gitcomp "7bit 8bit quoted-printable base64"
1880 --get|--get-all|--unset|--unset-all)
1881 __gitcomp_nl "$(__git_config_get_set_variables)"
1891 --system --global --local --file=
1892 --list --replace-all
1893 --get --get-all --get-regexp
1894 --add --unset --unset-all
1895 --remove-section --rename-section
1900 local pfx="${cur%.*}." cur_="${cur##*.}"
1901 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1905 local pfx="${cur%.*}." cur_="${cur#*.}"
1906 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1907 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1911 local pfx="${cur%.*}." cur_="${cur##*.}"
1913 argprompt cmd confirm needsfile noconsole norescan
1914 prompt revprompt revunmerged title
1919 local pfx="${cur%.*}." cur_="${cur##*.}"
1920 __gitcomp "cmd path" "$pfx" "$cur_"
1924 local pfx="${cur%.*}." cur_="${cur##*.}"
1925 __gitcomp "cmd path" "$pfx" "$cur_"
1929 local pfx="${cur%.*}." cur_="${cur##*.}"
1930 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1934 local pfx="${cur%.*}." cur_="${cur#*.}"
1935 __git_compute_all_commands
1936 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1940 local pfx="${cur%.*}." cur_="${cur##*.}"
1942 url proxy fetch push mirror skipDefaultUpdate
1943 receivepack uploadpack tagopt pushurl
1948 local pfx="${cur%.*}." cur_="${cur#*.}"
1949 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1950 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1954 local pfx="${cur%.*}." cur_="${cur##*.}"
1955 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1961 advice.commitBeforeMerge
1963 advice.implicitIdentity
1964 advice.pushNonFastForward
1965 advice.resolveConflict
1969 apply.ignorewhitespace
1971 branch.autosetupmerge
1972 branch.autosetuprebase
1976 color.branch.current
1981 color.decorate.branch
1982 color.decorate.remoteBranch
1983 color.decorate.stash
1993 color.diff.whitespace
1998 color.grep.linenumber
2001 color.grep.separator
2003 color.interactive.error
2004 color.interactive.header
2005 color.interactive.help
2006 color.interactive.prompt
2011 color.status.changed
2013 color.status.nobranch
2014 color.status.unmerged
2015 color.status.untracked
2016 color.status.updated
2025 core.bigFileThreshold
2028 core.deltaBaseCacheLimit
2033 core.fsyncobjectfiles
2037 core.logAllRefUpdates
2038 core.loosecompression
2041 core.packedGitWindowSize
2043 core.preferSymlinkRefs
2046 core.repositoryFormatVersion
2048 core.sharedRepository
2052 core.warnAmbiguousRefs
2055 diff.autorefreshindex
2057 diff.ignoreSubmodules
2064 diff.suppressBlankEmpty
2070 fetch.recurseSubmodules
2080 format.subjectprefix
2091 gc.reflogexpireunreachable
2095 gitcvs.commitmsgannotation
2096 gitcvs.dbTableNamePrefix
2107 gui.copyblamethreshold
2111 gui.matchtrackingbranch
2112 gui.newbranchtemplate
2113 gui.pruneduringfetch
2114 gui.spellingdictionary
2129 http.sslCertPasswordProtected
2134 i18n.logOutputEncoding
2140 imap.preformattedHTML
2150 interactive.singlekey
2166 mergetool.keepBackup
2167 mergetool.keepTemporaries
2172 notes.rewrite.rebase
2176 pack.deltaCacheLimit
2193 receive.denyCurrentBranch
2194 receive.denyDeleteCurrent
2196 receive.denyNonFastForwards
2199 receive.updateserverinfo
2202 repack.usedeltabaseoffset
2206 sendemail.aliasesfile
2207 sendemail.aliasfiletype
2211 sendemail.chainreplyto
2213 sendemail.envelopesender
2217 sendemail.signedoffbycc
2218 sendemail.smtpdomain
2219 sendemail.smtpencryption
2221 sendemail.smtpserver
2222 sendemail.smtpserveroption
2223 sendemail.smtpserverport
2225 sendemail.suppresscc
2226 sendemail.suppressfrom
2231 status.relativePaths
2232 status.showUntrackedFiles
2233 status.submodulesummary
2236 transfer.unpackLimit
2248 local subcommands="add rename remove set-head set-branches set-url show prune update"
2249 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2250 if [ -z "$subcommand" ]; then
2251 __gitcomp "$subcommands"
2255 case "$subcommand" in
2256 rename|remove|set-url|show|prune)
2257 __gitcomp_nl "$(__git_remotes)"
2259 set-head|set-branches)
2260 __git_complete_remote_or_refspec
2263 local i c='' IFS=$'\n'
2264 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "remotes\..*" 2>/dev/null); do
2277 __gitcomp_nl "$(__git_refs)"
2282 __git_has_doubledash && return
2286 __gitcomp "--merge --mixed --hard --soft --patch"
2290 __gitcomp_nl "$(__git_refs)"
2297 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2301 __gitcomp_nl "$(__git_refs)"
2308 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2313 __git_complete_index_file "--cached"
2318 __git_has_doubledash && return
2323 $__git_log_common_options
2324 $__git_log_shortlog_options
2325 --numbered --summary
2330 __git_complete_revlist
2335 __git_has_doubledash && return
2338 --pretty=*|--format=*)
2339 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2344 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2348 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2350 $__git_diff_common_options
2355 __git_complete_revlist_file
2363 --all --remotes --topo-order --current --more=
2364 --list --independent --merge-base --no-name
2366 --sha1-name --sparse --topics --reflog
2371 __git_complete_revlist
2376 local save_opts='--keep-index --no-keep-index --quiet --patch'
2377 local subcommands='save list show apply clear drop pop create branch'
2378 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2379 if [ -z "$subcommand" ]; then
2382 __gitcomp "$save_opts"
2385 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2386 __gitcomp "$subcommands"
2391 case "$subcommand,$cur" in
2393 __gitcomp "$save_opts"
2396 __gitcomp "--index --quiet"
2398 show,--*|drop,--*|branch,--*)
2400 show,*|apply,*|drop,*|pop,*|branch,*)
2401 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2402 | sed -n -e 's/:.*//p')"
2412 __git_has_doubledash && return
2414 local subcommands="add status init deinit update summary foreach sync"
2415 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2418 __gitcomp "--quiet --cached"
2421 __gitcomp "$subcommands"
2431 init fetch clone rebase dcommit log find-rev
2432 set-tree commit-diff info create-ignore propget
2433 proplist show-ignore show-externals branch tag blame
2434 migrate mkdirs reset gc
2436 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2437 if [ -z "$subcommand" ]; then
2438 __gitcomp "$subcommands"
2440 local remote_opts="--username= --config-dir= --no-auth-cache"
2442 --follow-parent --authors-file= --repack=
2443 --no-metadata --use-svm-props --use-svnsync-props
2444 --log-window-size= --no-checkout --quiet
2445 --repack-flags --use-log-author --localtime
2446 --ignore-paths= --include-paths= $remote_opts
2449 --template= --shared= --trunk= --tags=
2450 --branches= --stdlayout --minimize-url
2451 --no-metadata --use-svm-props --use-svnsync-props
2452 --rewrite-root= --prefix= --use-log-author
2453 --add-author-from $remote_opts
2456 --edit --rmdir --find-copies-harder --copy-similarity=
2459 case "$subcommand,$cur" in
2461 __gitcomp "--revision= --fetch-all $fc_opts"
2464 __gitcomp "--revision= $fc_opts $init_opts"
2467 __gitcomp "$init_opts"
2471 --merge --strategy= --verbose --dry-run
2472 --fetch-all --no-rebase --commit-url
2473 --revision --interactive $cmt_opts $fc_opts
2477 __gitcomp "--stdin $cmt_opts $fc_opts"
2479 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2480 show-externals,--*|mkdirs,--*)
2481 __gitcomp "--revision="
2485 --limit= --revision= --verbose --incremental
2486 --oneline --show-commit --non-recursive
2487 --authors-file= --color
2492 --merge --verbose --strategy= --local
2493 --fetch-all --dry-run $fc_opts
2497 __gitcomp "--message= --file= --revision= $cmt_opts"
2503 __gitcomp "--dry-run --message --tag"
2506 __gitcomp "--dry-run --message"
2509 __gitcomp "--git-format"
2513 --config-dir= --ignore-paths= --minimize
2514 --no-auth-cache --username=
2518 __gitcomp "--revision= --parent"
2529 while [ $c -lt $cword ]; do
2533 __gitcomp_nl "$(__git_tags)"
2548 __gitcomp_nl "$(__git_tags)"
2552 __gitcomp_nl "$(__git_refs)"
2559 --list --delete --verify --annotate --message --file
2560 --sign --cleanup --local-user --force --column --sort
2561 --contains --points-at
2574 local i c=1 command __git_dir
2576 while [ $c -lt $cword ]; do
2579 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2580 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2581 --bare) __git_dir="." ;;
2582 --help) command="help"; break ;;
2583 -c|--work-tree|--namespace) ((c++)) ;;
2585 *) command="$i"; break ;;
2590 if [ -z "$command" ]; then
2605 --no-replace-objects
2609 *) __git_compute_porcelain_commands
2610 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2615 local completion_func="_git_${command//-/_}"
2616 declare -f $completion_func >/dev/null && $completion_func && return
2618 local expansion=$(__git_aliased_command "$command")
2619 if [ -n "$expansion" ]; then
2621 completion_func="_git_${expansion//-/_}"
2622 declare -f $completion_func >/dev/null && $completion_func
2628 __git_has_doubledash && return
2630 local g="$(__gitdir)"
2632 if [ -f "$g/MERGE_HEAD" ]; then
2638 $__git_log_common_options
2639 $__git_log_gitk_options
2645 __git_complete_revlist
2648 if [[ -n ${ZSH_VERSION-} ]]; then
2649 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2651 autoload -U +X compinit && compinit
2657 local cur_="${3-$cur}"
2663 local c IFS=$' \t\n'
2671 array[${#array[@]}+1]="$c"
2674 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
2685 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2694 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2699 local _ret=1 cur cword prev
2700 cur=${words[CURRENT]}
2701 prev=${words[CURRENT-1]}
2703 emulate ksh -c __${service}_main
2704 let _ret && _default && _ret=0
2708 compdef _git git gitk
2714 local cur words cword prev
2715 _get_comp_words_by_ref -n =: cur words cword prev
2719 # Setup completion for certain functions defined above by setting common
2720 # variables and workarounds.
2721 # This is NOT a public function; use at your own risk.
2724 local wrapper="__git_wrap${2}"
2725 eval "$wrapper () { __git_func_wrap $2 ; }"
2726 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2727 || complete -o default -o nospace -F $wrapper $1
2730 # wrapper for backwards compatibility
2733 __git_wrap__git_main
2736 # wrapper for backwards compatibility
2739 __git_wrap__gitk_main
2742 __git_complete git __git_main
2743 __git_complete gitk __gitk_main
2745 # The following are necessary only for Cygwin, and only are needed
2746 # when the user has tab-completed the executable name and consequently
2747 # included the '.exe' suffix.
2749 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2750 __git_complete git.exe __git_main