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.sh).
20 # 2) Add the following line to your .bashrc/.zshrc:
21 # source ~/.git-completion.sh
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 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 ()
285 test -n "${CDPATH+set}" && unset CDPATH
287 if [ "$2" == "--committable" ]; then
288 git diff-index --name-only --relative HEAD
290 # NOTE: $2 is not quoted in order to support multiple options
291 git ls-files --exclude-standard $2
297 # __git_index_files accepts 1 or 2 arguments:
298 # 1: Options to pass to ls-files (required).
299 # 2: A directory path (optional).
300 # If provided, only files within the specified directory are listed.
301 # Sub directories are never recursed. Path must have a trailing
305 local dir="$(__gitdir)" root="${2-.}" file
307 if [ -d "$dir" ]; then
308 __git_ls_files_helper "$root" "$1" |
309 while read -r file; do
311 ?*/*) echo "${file%%/*}" ;;
320 local dir="$(__gitdir)"
321 if [ -d "$dir" ]; then
322 git --git-dir="$dir" for-each-ref --format='%(refname:short)' \
330 local dir="$(__gitdir)"
331 if [ -d "$dir" ]; then
332 git --git-dir="$dir" for-each-ref --format='%(refname:short)' \
338 # __git_refs accepts 0, 1 (to pass to __gitdir), or 2 arguments
339 # presence of 2nd argument means use the guess heuristic employed
340 # by checkout for tracking branches
343 local i hash dir="$(__gitdir "${1-}")" track="${2-}"
345 if [ -d "$dir" ]; then
353 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD; do
354 if [ -e "$dir/$i" ]; then echo $i; fi
356 format="refname:short"
357 refs="refs/tags refs/heads refs/remotes"
360 git --git-dir="$dir" for-each-ref --format="%($format)" \
362 if [ -n "$track" ]; then
363 # employ the heuristic used by git checkout
364 # Try to find a remote branch that matches the completion word
365 # but only output if the branch name is unique
367 git --git-dir="$dir" for-each-ref --shell --format="ref=%(refname:short)" \
369 while read -r entry; do
372 if [[ "$ref" == "$cur"* ]]; then
375 done | sort | uniq -u
381 git ls-remote "$dir" "$cur*" 2>/dev/null | \
382 while read -r hash i; do
391 git for-each-ref --format="%(refname:short)" -- \
392 "refs/remotes/$dir/" 2>/dev/null | sed -e "s#^$dir/##"
397 # __git_refs2 requires 1 argument (to pass to __git_refs)
401 for i in $(__git_refs "$1"); do
406 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
407 __git_refs_remotes ()
410 git ls-remote "$1" 'refs/heads/*' 2>/dev/null | \
411 while read -r hash i; do
412 echo "$i:refs/remotes/$1/${i#refs/heads/}"
418 local i IFS=$'\n' d="$(__gitdir)"
419 test -d "$d/remotes" && ls -1 "$d/remotes"
420 for i in $(git --git-dir="$d" config --get-regexp 'remote\..*\.url' 2>/dev/null); do
426 __git_list_merge_strategies ()
428 git merge -s help 2>&1 |
429 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
438 __git_merge_strategies=
439 # 'git merge -s help' (and thus detection of the merge strategy
440 # list) fails, unfortunately, if run outside of any git working
441 # tree. __git_merge_strategies is set to the empty string in
442 # that case, and the detection will be repeated the next time it
444 __git_compute_merge_strategies ()
446 test -n "$__git_merge_strategies" ||
447 __git_merge_strategies=$(__git_list_merge_strategies)
450 __git_complete_revlist_file ()
452 local pfx ls ref cur_="$cur"
472 case "$COMP_WORDBREAKS" in
474 *) pfx="$ref:$pfx" ;;
477 __gitcomp_nl "$(git --git-dir="$(__gitdir)" ls-tree "$ls" 2>/dev/null \
478 | sed '/^100... blob /{
494 pfx="${cur_%...*}..."
496 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
501 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
504 __gitcomp_nl "$(__git_refs)"
510 # __git_complete_index_file requires 1 argument:
511 # 1: the options to pass to ls-file
513 # The exception is --committable, which finds the files appropriate commit.
514 __git_complete_index_file ()
516 local pfx="" cur_="$cur"
526 __gitcomp_file "$(__git_index_files "$1" "$pfx")" "$pfx" "$cur_"
529 __git_complete_file ()
531 __git_complete_revlist_file
534 __git_complete_revlist ()
536 __git_complete_revlist_file
539 __git_complete_remote_or_refspec ()
541 local cur_="$cur" cmd="${words[1]}"
542 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
543 if [ "$cmd" = "remote" ]; then
546 while [ $c -lt $cword ]; do
549 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
552 push) no_complete_refspec=1 ;;
560 *) remote="$i"; break ;;
564 if [ -z "$remote" ]; then
565 __gitcomp_nl "$(__git_remotes)"
568 if [ $no_complete_refspec = 1 ]; then
571 [ "$remote" = "." ] && remote=
574 case "$COMP_WORDBREAKS" in
576 *) pfx="${cur_%%:*}:" ;;
588 if [ $lhs = 1 ]; then
589 __gitcomp_nl "$(__git_refs2 "$remote")" "$pfx" "$cur_"
591 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
595 if [ $lhs = 1 ]; then
596 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
598 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
602 if [ $lhs = 1 ]; then
603 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
605 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
611 __git_complete_strategy ()
613 __git_compute_merge_strategies
616 __gitcomp "$__git_merge_strategies"
621 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
629 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
631 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
633 git help -a|egrep '^ [a-zA-Z0-9]'
637 __git_list_all_commands ()
640 for i in $(__git_commands)
643 *--*) : helper pattern;;
650 __git_compute_all_commands ()
652 test -n "$__git_all_commands" ||
653 __git_all_commands=$(__git_list_all_commands)
656 __git_list_porcelain_commands ()
659 __git_compute_all_commands
660 for i in $__git_all_commands
663 *--*) : helper pattern;;
664 applymbox) : ask gittus;;
665 applypatch) : ask gittus;;
666 archimport) : import;;
667 cat-file) : plumbing;;
668 check-attr) : plumbing;;
669 check-ignore) : plumbing;;
670 check-mailmap) : plumbing;;
671 check-ref-format) : plumbing;;
672 checkout-index) : plumbing;;
673 commit-tree) : plumbing;;
674 count-objects) : infrequent;;
675 credential-cache) : credentials helper;;
676 credential-store) : credentials helper;;
677 cvsexportcommit) : export;;
678 cvsimport) : import;;
679 cvsserver) : daemon;;
681 diff-files) : plumbing;;
682 diff-index) : plumbing;;
683 diff-tree) : plumbing;;
684 fast-import) : import;;
685 fast-export) : export;;
686 fsck-objects) : plumbing;;
687 fetch-pack) : plumbing;;
688 fmt-merge-msg) : plumbing;;
689 for-each-ref) : plumbing;;
690 hash-object) : plumbing;;
691 http-*) : transport;;
692 index-pack) : plumbing;;
693 init-db) : deprecated;;
694 local-fetch) : plumbing;;
695 ls-files) : plumbing;;
696 ls-remote) : plumbing;;
697 ls-tree) : plumbing;;
698 mailinfo) : plumbing;;
699 mailsplit) : plumbing;;
700 merge-*) : plumbing;;
703 pack-objects) : plumbing;;
704 pack-redundant) : plumbing;;
705 pack-refs) : plumbing;;
706 parse-remote) : plumbing;;
707 patch-id) : plumbing;;
709 prune-packed) : plumbing;;
710 quiltimport) : import;;
711 read-tree) : plumbing;;
712 receive-pack) : plumbing;;
713 remote-*) : transport;;
715 rev-list) : plumbing;;
716 rev-parse) : plumbing;;
717 runstatus) : plumbing;;
718 sh-setup) : internal;;
720 show-ref) : plumbing;;
721 send-pack) : plumbing;;
722 show-index) : plumbing;;
724 stripspace) : plumbing;;
725 symbolic-ref) : plumbing;;
726 unpack-file) : plumbing;;
727 unpack-objects) : plumbing;;
728 update-index) : plumbing;;
729 update-ref) : plumbing;;
730 update-server-info) : daemon;;
731 upload-archive) : plumbing;;
732 upload-pack) : plumbing;;
733 write-tree) : plumbing;;
735 verify-pack) : infrequent;;
736 verify-tag) : plumbing;;
742 __git_porcelain_commands=
743 __git_compute_porcelain_commands ()
745 __git_compute_all_commands
746 test -n "$__git_porcelain_commands" ||
747 __git_porcelain_commands=$(__git_list_porcelain_commands)
750 __git_pretty_aliases ()
753 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "pretty\..*" 2>/dev/null); do
766 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "alias\..*" 2>/dev/null); do
776 # __git_aliased_command requires 1 argument
777 __git_aliased_command ()
779 local word cmdline=$(git --git-dir="$(__gitdir)" \
780 config --get "alias.$1")
781 for word in $cmdline; do
787 \!*) : shell command alias ;;
789 *=*) : setting env ;;
791 \(\)) : skip parens of shell function definition ;;
792 {) : skip start of shell helper function ;;
793 :) : skip null command ;;
794 \'*) : skip opening quote after sh -c ;;
802 # __git_find_on_cmdline requires 1 argument
803 __git_find_on_cmdline ()
805 local word subcommand c=1
806 while [ $c -lt $cword ]; do
808 for subcommand in $1; do
809 if [ "$subcommand" = "$word" ]; then
818 __git_has_doubledash ()
821 while [ $c -lt $cword ]; do
822 if [ "--" = "${words[c]}" ]; then
830 # Try to count non option arguments passed on the command line for the
831 # specified git command.
832 # When options are used, it is necessary to use the special -- option to
833 # tell the implementation were non option arguments begin.
834 # XXX this can not be improved, since options can appear everywhere, as
838 # __git_count_arguments requires 1 argument: the git command executed.
839 __git_count_arguments ()
843 # Skip "git" (first argument)
844 for ((i=1; i < ${#words[@]}; i++)); do
849 # Good; we can assume that the following are only non
854 # Skip the specified git command and discard git
867 __git_whitespacelist="nowarn warn error error-all fix"
871 local dir="$(__gitdir)"
872 if [ -d "$dir"/rebase-apply ]; then
873 __gitcomp "--skip --continue --resolved --abort"
878 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
883 --3way --committer-date-is-author-date --ignore-date
884 --ignore-whitespace --ignore-space-change
885 --interactive --keep --no-utf8 --signoff --utf8
886 --whitespace= --scissors
896 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
901 --stat --numstat --summary --check --index
902 --cached --index-info --reverse --reject --unidiff-zero
903 --apply --no-add --exclude=
904 --ignore-whitespace --ignore-space-change
905 --whitespace= --inaccurate-eof --verbose
916 --interactive --refresh --patch --update --dry-run
917 --ignore-errors --intent-to-add
922 # XXX should we check for --update and --all options ?
923 __git_complete_index_file "--others --modified --directory --no-empty-directory"
930 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
934 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
939 --format= --list --verbose
940 --prefix= --remote= --exec=
950 __git_has_doubledash && return
952 local subcommands="start bad good skip reset visualize replay log run"
953 local subcommand="$(__git_find_on_cmdline "$subcommands")"
954 if [ -z "$subcommand" ]; then
955 if [ -f "$(__gitdir)"/BISECT_START ]; then
956 __gitcomp "$subcommands"
958 __gitcomp "replay start"
963 case "$subcommand" in
964 bad|good|reset|skip|start)
965 __gitcomp_nl "$(__git_refs)"
974 local i c=1 only_local_ref="n" has_r="n"
976 while [ $c -lt $cword ]; do
979 -d|-m) only_local_ref="y" ;;
987 __gitcomp "$(__git_refs)" "" "${cur##--set-upstream-to=}"
991 --color --no-color --verbose --abbrev= --no-abbrev
992 --track --no-track --contains --merged --no-merged
993 --set-upstream-to= --edit-description --list
998 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
999 __gitcomp_nl "$(__git_heads)"
1001 __gitcomp_nl "$(__git_refs)"
1009 local cmd="${words[2]}"
1012 __gitcomp "create list-heads verify unbundle"
1015 # looking for a file
1020 __git_complete_revlist
1029 __git_has_doubledash && return
1033 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1037 --quiet --ours --theirs --track --no-track --merge
1038 --conflict= --orphan --patch
1042 # check if --track, --no-track, or --no-guess was specified
1043 # if so, disable DWIM mode
1044 local flags="--track --no-track --no-guess" track=1
1045 if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1048 __gitcomp_nl "$(__git_refs '' $track)"
1055 __gitcomp "$(__git_refs)"
1060 local dir="$(__gitdir)"
1061 if [ -f "$dir"/CHERRY_PICK_HEAD ]; then
1062 __gitcomp "--continue --quit --abort"
1067 __gitcomp "--edit --no-commit --signoff --strategy= --mainline"
1070 __gitcomp_nl "$(__git_refs)"
1079 __gitcomp "--dry-run --quiet"
1084 # XXX should we check for -x option ?
1085 __git_complete_index_file "--others --directory"
1117 __gitcomp_nl "$(__git_refs)" "" "${cur}"
1124 __gitcomp "default strip verbatim whitespace
1125 " "" "${cur##--cleanup=}"
1128 --reuse-message=*|--reedit-message=*|\
1129 --fixup=*|--squash=*)
1130 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1133 --untracked-files=*)
1134 __gitcomp "all no normal" "" "${cur##--untracked-files=}"
1139 --all --author= --signoff --verify --no-verify
1141 --amend --include --only --interactive
1142 --dry-run --reuse-message= --reedit-message=
1143 --reset-author --file= --message= --template=
1144 --cleanup= --untracked-files --untracked-files=
1145 --verbose --quiet --fixup= --squash=
1150 if git rev-parse --verify --quiet HEAD >/dev/null; then
1151 __git_complete_index_file "--committable"
1153 # This is the first commit
1154 __git_complete_index_file "--cached"
1163 --all --tags --contains --abbrev= --candidates=
1164 --exact-match --debug --long --match --always
1168 __gitcomp_nl "$(__git_refs)"
1171 __git_diff_algorithms="myers minimal patience histogram"
1173 __git_diff_common_options="--stat --numstat --shortstat --summary
1174 --patch-with-stat --name-only --name-status --color
1175 --no-color --color-words --no-renames --check
1176 --full-index --binary --abbrev --diff-filter=
1177 --find-copies-harder
1178 --text --ignore-space-at-eol --ignore-space-change
1179 --ignore-all-space --ignore-blank-lines --exit-code
1180 --quiet --ext-diff --no-ext-diff
1181 --no-prefix --src-prefix= --dst-prefix=
1182 --inter-hunk-context=
1183 --patience --histogram --minimal
1185 --dirstat --dirstat= --dirstat-by-file
1186 --dirstat-by-file= --cumulative
1192 __git_has_doubledash && return
1196 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1200 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1201 --base --ours --theirs --no-index
1202 $__git_diff_common_options
1207 __git_complete_revlist_file
1210 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1211 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc3 codecompare
1216 __git_has_doubledash && return
1220 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1224 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1225 --base --ours --theirs
1226 --no-renames --diff-filter= --find-copies-harder
1227 --relative --ignore-submodules
1232 __git_complete_revlist_file
1235 __git_fetch_recurse_submodules="yes on-demand no"
1237 __git_fetch_options="
1238 --quiet --verbose --append --upload-pack --force --keep --depth=
1239 --tags --no-tags --all --prune --dry-run --recurse-submodules=
1245 --recurse-submodules=*)
1246 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1250 __gitcomp "$__git_fetch_options"
1254 __git_complete_remote_or_refspec
1257 __git_format_patch_options="
1258 --stdout --attach --no-attach --thread --thread= --no-thread
1259 --numbered --start-number --numbered-files --keep-subject --signoff
1260 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1261 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1262 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1263 --output-directory --reroll-count --to= --quiet --notes
1266 _git_format_patch ()
1272 " "" "${cur##--thread=}"
1276 __gitcomp "$__git_format_patch_options"
1280 __git_complete_revlist
1288 --tags --root --unreachable --cache --no-reflogs --full
1289 --strict --verbose --lost-found
1300 __gitcomp "--prune --aggressive"
1311 __git_match_ctag() {
1312 awk "/^${1////\\/}/ { print \$1 }" "$2"
1317 __git_has_doubledash && return
1323 --text --ignore-case --word-regexp --invert-match
1324 --full-name --line-number
1325 --extended-regexp --basic-regexp --fixed-strings
1327 --files-with-matches --name-only
1328 --files-without-match
1331 --and --or --not --all-match
1337 case "$cword,$prev" in
1339 if test -r tags; then
1340 __gitcomp_nl "$(__git_match_ctag "$cur" tags)"
1346 __gitcomp_nl "$(__git_refs)"
1353 __gitcomp "--all --info --man --web"
1357 __git_compute_all_commands
1358 __gitcomp "$__git_all_commands $(__git_aliases)
1359 attributes cli core-tutorial cvs-migration
1360 diffcore gitk glossary hooks ignore modules
1361 namespaces repository-layout tutorial tutorial-2
1371 false true umask group all world everybody
1372 " "" "${cur##--shared=}"
1376 __gitcomp "--quiet --bare --template= --shared --shared="
1386 __gitcomp "--cached --deleted --modified --others --ignored
1387 --stage --directory --no-empty-directory --unmerged
1388 --killed --exclude= --exclude-from=
1389 --exclude-per-directory= --exclude-standard
1390 --error-unmatch --with-tree= --full-name
1391 --abbrev --ignored --exclude-per-directory
1397 # XXX ignore options like --modified and always suggest all cached
1399 __git_complete_index_file "--cached"
1404 __gitcomp_nl "$(__git_remotes)"
1412 # Options that go well for log, shortlog and gitk
1413 __git_log_common_options="
1415 --branches --tags --remotes
1416 --first-parent --merges --no-merges
1418 --max-age= --since= --after=
1419 --min-age= --until= --before=
1420 --min-parents= --max-parents=
1421 --no-min-parents --no-max-parents
1423 # Options that go well for log and gitk (not shortlog)
1424 __git_log_gitk_options="
1425 --dense --sparse --full-history
1426 --simplify-merges --simplify-by-decoration
1427 --left-right --notes --no-notes
1429 # Options that go well for log and shortlog (not gitk)
1430 __git_log_shortlog_options="
1431 --author= --committer= --grep=
1435 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1436 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1440 __git_has_doubledash && return
1442 local g="$(git rev-parse --git-dir 2>/dev/null)"
1444 if [ -f "$g/MERGE_HEAD" ]; then
1448 --pretty=*|--format=*)
1449 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1454 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1458 __gitcomp "long short" "" "${cur##--decorate=}"
1463 $__git_log_common_options
1464 $__git_log_shortlog_options
1465 $__git_log_gitk_options
1466 --root --topo-order --date-order --reverse
1467 --follow --full-diff
1468 --abbrev-commit --abbrev=
1469 --relative-date --date=
1470 --pretty= --format= --oneline
1474 --decorate --decorate=
1476 --parents --children
1478 $__git_diff_common_options
1479 --pickaxe-all --pickaxe-regex
1484 __git_complete_revlist
1487 # Common merge options shared by git-merge(1) and git-pull(1).
1488 __git_merge_options="
1489 --no-commit --no-stat --log --no-log --squash --strategy
1490 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1491 --verify-signatures --no-verify-signatures --gpg-sign
1492 --quiet --verbose --progress --no-progress
1497 __git_complete_strategy && return
1501 __gitcomp "$__git_merge_options
1502 --rerere-autoupdate --no-rerere-autoupdate --abort"
1505 __gitcomp_nl "$(__git_refs)"
1512 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1526 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1530 __gitcomp_nl "$(__git_refs)"
1537 __gitcomp "--dry-run"
1542 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1543 # We need to show both cached and untracked files (including
1544 # empty directories) since this may not be the last argument.
1545 __git_complete_index_file "--cached --others --directory"
1547 __git_complete_index_file "--cached"
1553 __gitcomp "--tags --all --stdin"
1558 local subcommands='add append copy edit list prune remove show'
1559 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1561 case "$subcommand,$cur" in
1568 __gitcomp_nl "$(__git_refs)"
1571 __gitcomp "$subcommands --ref"
1575 add,--reuse-message=*|append,--reuse-message=*|\
1576 add,--reedit-message=*|append,--reedit-message=*)
1577 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1580 __gitcomp '--file= --message= --reedit-message=
1587 __gitcomp '--dry-run --verbose'
1596 __gitcomp_nl "$(__git_refs)"
1605 __git_complete_strategy && return
1608 --recurse-submodules=*)
1609 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1614 --rebase --no-rebase
1615 $__git_merge_options
1616 $__git_fetch_options
1621 __git_complete_remote_or_refspec
1624 __git_push_recurse_submodules="check on-demand"
1626 __git_complete_force_with_lease ()
1634 __gitcomp_nl "$(__git_refs)" "" "${cur_#*:}"
1637 __gitcomp_nl "$(__git_refs)" "" "$cur_"
1646 __gitcomp_nl "$(__git_remotes)"
1649 --recurse-submodules)
1650 __gitcomp "$__git_push_recurse_submodules"
1656 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1659 --recurse-submodules=*)
1660 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1663 --force-with-lease=*)
1664 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1669 --all --mirror --tags --dry-run --force --verbose
1670 --quiet --prune --delete --follow-tags
1671 --receive-pack= --repo= --set-upstream
1672 --force-with-lease --force-with-lease= --recurse-submodules=
1677 __git_complete_remote_or_refspec
1682 local dir="$(__gitdir)"
1683 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1684 __gitcomp "--continue --skip --abort"
1687 __git_complete_strategy && return
1690 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1695 --onto --merge --strategy --interactive
1696 --preserve-merges --stat --no-stat
1697 --committer-date-is-author-date --ignore-date
1698 --ignore-whitespace --whitespace=
1699 --autosquash --fork-point --no-fork-point
1704 __gitcomp_nl "$(__git_refs)"
1709 local subcommands="show delete expire"
1710 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1712 if [ -z "$subcommand" ]; then
1713 __gitcomp "$subcommands"
1715 __gitcomp_nl "$(__git_refs)"
1719 __git_send_email_confirm_options="always never auto cc compose"
1720 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1727 $__git_send_email_confirm_options
1728 " "" "${cur##--confirm=}"
1733 $__git_send_email_suppresscc_options
1734 " "" "${cur##--suppress-cc=}"
1738 --smtp-encryption=*)
1739 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1745 " "" "${cur##--thread=}"
1749 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1750 --compose --confirm= --dry-run --envelope-sender
1752 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1753 --no-suppress-from --no-thread --quiet
1754 --signed-off-by-cc --smtp-pass --smtp-server
1755 --smtp-server-port --smtp-encryption= --smtp-user
1756 --subject --suppress-cc= --suppress-from --thread --to
1757 --validate --no-validate
1758 $__git_format_patch_options"
1762 __git_complete_revlist
1770 __git_config_get_set_variables ()
1772 local prevword word config_file= c=$cword
1773 while [ $c -gt 1 ]; do
1776 --system|--global|--local|--file=*)
1781 config_file="$word $prevword"
1789 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1803 branch.*.remote|branch.*.pushremote)
1804 __gitcomp_nl "$(__git_remotes)"
1808 __gitcomp_nl "$(__git_refs)"
1812 __gitcomp "false true"
1816 __gitcomp_nl "$(__git_remotes)"
1820 local remote="${prev#remote.}"
1821 remote="${remote%.fetch}"
1822 if [ -z "$cur" ]; then
1823 __gitcomp_nl "refs/heads/" "" "" ""
1826 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1830 local remote="${prev#remote.}"
1831 remote="${remote%.push}"
1832 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1833 for-each-ref --format='%(refname):%(refname)' \
1837 pull.twohead|pull.octopus)
1838 __git_compute_merge_strategies
1839 __gitcomp "$__git_merge_strategies"
1842 color.branch|color.diff|color.interactive|\
1843 color.showbranch|color.status|color.ui)
1844 __gitcomp "always never auto"
1848 __gitcomp "false true"
1853 normal black red green yellow blue magenta cyan white
1854 bold dim ul blink reverse
1859 __gitcomp "log short"
1863 __gitcomp "man info web html"
1867 __gitcomp "$__git_log_date_formats"
1870 sendemail.aliasesfiletype)
1871 __gitcomp "mutt mailrc pine elm gnus"
1875 __gitcomp "$__git_send_email_confirm_options"
1878 sendemail.suppresscc)
1879 __gitcomp "$__git_send_email_suppresscc_options"
1882 --get|--get-all|--unset|--unset-all)
1883 __gitcomp_nl "$(__git_config_get_set_variables)"
1893 --system --global --local --file=
1894 --list --replace-all
1895 --get --get-all --get-regexp
1896 --add --unset --unset-all
1897 --remove-section --rename-section
1902 local pfx="${cur%.*}." cur_="${cur##*.}"
1903 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1907 local pfx="${cur%.*}." cur_="${cur#*.}"
1908 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1909 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1913 local pfx="${cur%.*}." cur_="${cur##*.}"
1915 argprompt cmd confirm needsfile noconsole norescan
1916 prompt revprompt revunmerged title
1921 local pfx="${cur%.*}." cur_="${cur##*.}"
1922 __gitcomp "cmd path" "$pfx" "$cur_"
1926 local pfx="${cur%.*}." cur_="${cur##*.}"
1927 __gitcomp "cmd path" "$pfx" "$cur_"
1931 local pfx="${cur%.*}." cur_="${cur##*.}"
1932 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1936 local pfx="${cur%.*}." cur_="${cur#*.}"
1937 __git_compute_all_commands
1938 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1942 local pfx="${cur%.*}." cur_="${cur##*.}"
1944 url proxy fetch push mirror skipDefaultUpdate
1945 receivepack uploadpack tagopt pushurl
1950 local pfx="${cur%.*}." cur_="${cur#*.}"
1951 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1952 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1956 local pfx="${cur%.*}." cur_="${cur##*.}"
1957 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1963 advice.commitBeforeMerge
1965 advice.implicitIdentity
1966 advice.pushNonFastForward
1967 advice.resolveConflict
1971 apply.ignorewhitespace
1973 branch.autosetupmerge
1974 branch.autosetuprebase
1978 color.branch.current
1983 color.decorate.branch
1984 color.decorate.remoteBranch
1985 color.decorate.stash
1995 color.diff.whitespace
2000 color.grep.linenumber
2003 color.grep.separator
2005 color.interactive.error
2006 color.interactive.header
2007 color.interactive.help
2008 color.interactive.prompt
2013 color.status.changed
2015 color.status.nobranch
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
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)"
2564 local i c=1 command __git_dir
2566 while [ $c -lt $cword ]; do
2569 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2570 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2571 --bare) __git_dir="." ;;
2572 --help) command="help"; break ;;
2573 -c|--work-tree|--namespace) ((c++)) ;;
2575 *) command="$i"; break ;;
2580 if [ -z "$command" ]; then
2595 --no-replace-objects
2599 *) __git_compute_porcelain_commands
2600 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2605 local completion_func="_git_${command//-/_}"
2606 declare -f $completion_func >/dev/null && $completion_func && return
2608 local expansion=$(__git_aliased_command "$command")
2609 if [ -n "$expansion" ]; then
2611 completion_func="_git_${expansion//-/_}"
2612 declare -f $completion_func >/dev/null && $completion_func
2618 __git_has_doubledash && return
2620 local g="$(__gitdir)"
2622 if [ -f "$g/MERGE_HEAD" ]; then
2628 $__git_log_common_options
2629 $__git_log_gitk_options
2635 __git_complete_revlist
2638 if [[ -n ${ZSH_VERSION-} ]]; then
2639 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2641 autoload -U +X compinit && compinit
2647 local cur_="${3-$cur}"
2653 local c IFS=$' \t\n'
2661 array[${#array[@]}+1]="$c"
2664 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
2675 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2684 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2689 local _ret=1 cur cword prev
2690 cur=${words[CURRENT]}
2691 prev=${words[CURRENT-1]}
2693 emulate ksh -c __${service}_main
2694 let _ret && _default && _ret=0
2698 compdef _git git gitk
2704 local cur words cword prev
2705 _get_comp_words_by_ref -n =: cur words cword prev
2709 # Setup completion for certain functions defined above by setting common
2710 # variables and workarounds.
2711 # This is NOT a public function; use at your own risk.
2714 local wrapper="__git_wrap${2}"
2715 eval "$wrapper () { __git_func_wrap $2 ; }"
2716 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2717 || complete -o default -o nospace -F $wrapper $1
2720 # wrapper for backwards compatibility
2723 __git_wrap__git_main
2726 # wrapper for backwards compatibility
2729 __git_wrap__gitk_main
2732 __git_complete git __git_main
2733 __git_complete gitk __gitk_main
2735 # The following are necessary only for Cygwin, and only are needed
2736 # when the user has tab-completed the executable name and consequently
2737 # included the '.exe' suffix.
2739 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2740 __git_complete git.exe __git_main