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 test -n "$__git_porcelain_commands" ||
739 __git_porcelain_commands=$(__git_list_porcelain_commands)
742 __git_pretty_aliases ()
745 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "pretty\..*" 2>/dev/null); do
758 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "alias\..*" 2>/dev/null); do
768 # __git_aliased_command requires 1 argument
769 __git_aliased_command ()
771 local word cmdline=$(git --git-dir="$(__gitdir)" \
772 config --get "alias.$1")
773 for word in $cmdline; do
779 \!*) : shell command alias ;;
781 *=*) : setting env ;;
783 \(\)) : skip parens of shell function definition ;;
784 {) : skip start of shell helper function ;;
785 :) : skip null command ;;
786 \'*) : skip opening quote after sh -c ;;
794 # __git_find_on_cmdline requires 1 argument
795 __git_find_on_cmdline ()
797 local word subcommand c=1
798 while [ $c -lt $cword ]; do
800 for subcommand in $1; do
801 if [ "$subcommand" = "$word" ]; then
810 __git_has_doubledash ()
813 while [ $c -lt $cword ]; do
814 if [ "--" = "${words[c]}" ]; then
822 # Try to count non option arguments passed on the command line for the
823 # specified git command.
824 # When options are used, it is necessary to use the special -- option to
825 # tell the implementation were non option arguments begin.
826 # XXX this can not be improved, since options can appear everywhere, as
830 # __git_count_arguments requires 1 argument: the git command executed.
831 __git_count_arguments ()
835 # Skip "git" (first argument)
836 for ((i=1; i < ${#words[@]}; i++)); do
841 # Good; we can assume that the following are only non
846 # Skip the specified git command and discard git
859 __git_whitespacelist="nowarn warn error error-all fix"
863 local dir="$(__gitdir)"
864 if [ -d "$dir"/rebase-apply ]; then
865 __gitcomp "--skip --continue --resolved --abort"
870 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
875 --3way --committer-date-is-author-date --ignore-date
876 --ignore-whitespace --ignore-space-change
877 --interactive --keep --no-utf8 --signoff --utf8
878 --whitespace= --scissors
888 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
893 --stat --numstat --summary --check --index
894 --cached --index-info --reverse --reject --unidiff-zero
895 --apply --no-add --exclude=
896 --ignore-whitespace --ignore-space-change
897 --whitespace= --inaccurate-eof --verbose
908 --interactive --refresh --patch --update --dry-run
909 --ignore-errors --intent-to-add
914 # XXX should we check for --update and --all options ?
915 __git_complete_index_file "--others --modified --directory --no-empty-directory"
922 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
926 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
931 --format= --list --verbose
932 --prefix= --remote= --exec=
942 __git_has_doubledash && return
944 local subcommands="start bad good skip reset visualize replay log run"
945 local subcommand="$(__git_find_on_cmdline "$subcommands")"
946 if [ -z "$subcommand" ]; then
947 if [ -f "$(__gitdir)"/BISECT_START ]; then
948 __gitcomp "$subcommands"
950 __gitcomp "replay start"
955 case "$subcommand" in
956 bad|good|reset|skip|start)
957 __gitcomp_nl "$(__git_refs)"
966 local i c=1 only_local_ref="n" has_r="n"
968 while [ $c -lt $cword ]; do
971 -d|-m) only_local_ref="y" ;;
979 __gitcomp_nl "$(__git_refs)" "" "${cur##--set-upstream-to=}"
983 --color --no-color --verbose --abbrev= --no-abbrev
984 --track --no-track --contains --merged --no-merged
985 --set-upstream-to= --edit-description --list
990 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
991 __gitcomp_nl "$(__git_heads)"
993 __gitcomp_nl "$(__git_refs)"
1001 local cmd="${words[2]}"
1004 __gitcomp "create list-heads verify unbundle"
1007 # looking for a file
1012 __git_complete_revlist
1021 __git_has_doubledash && return
1025 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1029 --quiet --ours --theirs --track --no-track --merge
1030 --conflict= --orphan --patch
1034 # check if --track, --no-track, or --no-guess was specified
1035 # if so, disable DWIM mode
1036 local flags="--track --no-track --no-guess" track=1
1037 if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1040 __gitcomp_nl "$(__git_refs '' $track)"
1047 __gitcomp_nl "$(__git_refs)"
1052 local dir="$(__gitdir)"
1053 if [ -f "$dir"/CHERRY_PICK_HEAD ]; then
1054 __gitcomp "--continue --quit --abort"
1059 __gitcomp "--edit --no-commit --signoff --strategy= --mainline"
1062 __gitcomp_nl "$(__git_refs)"
1071 __gitcomp "--dry-run --quiet"
1076 # XXX should we check for -x option ?
1077 __git_complete_index_file "--others --directory"
1109 __gitcomp_nl "$(__git_refs)" "" "${cur}"
1116 __gitcomp "default strip verbatim whitespace
1117 " "" "${cur##--cleanup=}"
1120 --reuse-message=*|--reedit-message=*|\
1121 --fixup=*|--squash=*)
1122 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1125 --untracked-files=*)
1126 __gitcomp "all no normal" "" "${cur##--untracked-files=}"
1131 --all --author= --signoff --verify --no-verify
1133 --amend --include --only --interactive
1134 --dry-run --reuse-message= --reedit-message=
1135 --reset-author --file= --message= --template=
1136 --cleanup= --untracked-files --untracked-files=
1137 --verbose --quiet --fixup= --squash=
1142 if git rev-parse --verify --quiet HEAD >/dev/null; then
1143 __git_complete_index_file "--committable"
1145 # This is the first commit
1146 __git_complete_index_file "--cached"
1155 --all --tags --contains --abbrev= --candidates=
1156 --exact-match --debug --long --match --always
1160 __gitcomp_nl "$(__git_refs)"
1163 __git_diff_algorithms="myers minimal patience histogram"
1165 __git_diff_common_options="--stat --numstat --shortstat --summary
1166 --patch-with-stat --name-only --name-status --color
1167 --no-color --color-words --no-renames --check
1168 --full-index --binary --abbrev --diff-filter=
1169 --find-copies-harder
1170 --text --ignore-space-at-eol --ignore-space-change
1171 --ignore-all-space --ignore-blank-lines --exit-code
1172 --quiet --ext-diff --no-ext-diff
1173 --no-prefix --src-prefix= --dst-prefix=
1174 --inter-hunk-context=
1175 --patience --histogram --minimal
1177 --dirstat --dirstat= --dirstat-by-file
1178 --dirstat-by-file= --cumulative
1184 __git_has_doubledash && return
1188 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1192 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1193 --base --ours --theirs --no-index
1194 $__git_diff_common_options
1199 __git_complete_revlist_file
1202 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1203 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc codecompare
1208 __git_has_doubledash && return
1212 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1216 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1217 --base --ours --theirs
1218 --no-renames --diff-filter= --find-copies-harder
1219 --relative --ignore-submodules
1224 __git_complete_revlist_file
1227 __git_fetch_recurse_submodules="yes on-demand no"
1229 __git_fetch_options="
1230 --quiet --verbose --append --upload-pack --force --keep --depth=
1231 --tags --no-tags --all --prune --dry-run --recurse-submodules=
1237 --recurse-submodules=*)
1238 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1242 __gitcomp "$__git_fetch_options"
1246 __git_complete_remote_or_refspec
1249 __git_format_patch_options="
1250 --stdout --attach --no-attach --thread --thread= --no-thread
1251 --numbered --start-number --numbered-files --keep-subject --signoff
1252 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1253 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1254 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1255 --output-directory --reroll-count --to= --quiet --notes
1258 _git_format_patch ()
1264 " "" "${cur##--thread=}"
1268 __gitcomp "$__git_format_patch_options"
1272 __git_complete_revlist
1280 --tags --root --unreachable --cache --no-reflogs --full
1281 --strict --verbose --lost-found
1292 __gitcomp "--prune --aggressive"
1303 __git_match_ctag() {
1304 awk "/^${1//\//\\/}/ { print \$1 }" "$2"
1309 __git_has_doubledash && return
1315 --text --ignore-case --word-regexp --invert-match
1316 --full-name --line-number
1317 --extended-regexp --basic-regexp --fixed-strings
1319 --files-with-matches --name-only
1320 --files-without-match
1323 --and --or --not --all-match
1329 case "$cword,$prev" in
1331 if test -r tags; then
1332 __gitcomp_nl "$(__git_match_ctag "$cur" tags)"
1338 __gitcomp_nl "$(__git_refs)"
1345 __gitcomp "--all --info --man --web"
1349 __git_compute_all_commands
1350 __gitcomp "$__git_all_commands $(__git_aliases)
1351 attributes cli core-tutorial cvs-migration
1352 diffcore gitk glossary hooks ignore modules
1353 namespaces repository-layout tutorial tutorial-2
1363 false true umask group all world everybody
1364 " "" "${cur##--shared=}"
1368 __gitcomp "--quiet --bare --template= --shared --shared="
1378 __gitcomp "--cached --deleted --modified --others --ignored
1379 --stage --directory --no-empty-directory --unmerged
1380 --killed --exclude= --exclude-from=
1381 --exclude-per-directory= --exclude-standard
1382 --error-unmatch --with-tree= --full-name
1383 --abbrev --ignored --exclude-per-directory
1389 # XXX ignore options like --modified and always suggest all cached
1391 __git_complete_index_file "--cached"
1396 __gitcomp_nl "$(__git_remotes)"
1404 # Options that go well for log, shortlog and gitk
1405 __git_log_common_options="
1407 --branches --tags --remotes
1408 --first-parent --merges --no-merges
1410 --max-age= --since= --after=
1411 --min-age= --until= --before=
1412 --min-parents= --max-parents=
1413 --no-min-parents --no-max-parents
1415 # Options that go well for log and gitk (not shortlog)
1416 __git_log_gitk_options="
1417 --dense --sparse --full-history
1418 --simplify-merges --simplify-by-decoration
1419 --left-right --notes --no-notes
1421 # Options that go well for log and shortlog (not gitk)
1422 __git_log_shortlog_options="
1423 --author= --committer= --grep=
1424 --all-match --invert-grep
1427 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1428 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1432 __git_has_doubledash && return
1434 local g="$(git rev-parse --git-dir 2>/dev/null)"
1436 if [ -f "$g/MERGE_HEAD" ]; then
1440 --pretty=*|--format=*)
1441 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1446 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1450 __gitcomp "full short no" "" "${cur##--decorate=}"
1455 $__git_log_common_options
1456 $__git_log_shortlog_options
1457 $__git_log_gitk_options
1458 --root --topo-order --date-order --reverse
1459 --follow --full-diff
1460 --abbrev-commit --abbrev=
1461 --relative-date --date=
1462 --pretty= --format= --oneline
1466 --decorate --decorate=
1468 --parents --children
1470 $__git_diff_common_options
1471 --pickaxe-all --pickaxe-regex
1476 __git_complete_revlist
1479 # Common merge options shared by git-merge(1) and git-pull(1).
1480 __git_merge_options="
1481 --no-commit --no-stat --log --no-log --squash --strategy
1482 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1483 --verify-signatures --no-verify-signatures --gpg-sign
1484 --quiet --verbose --progress --no-progress
1489 __git_complete_strategy && return
1493 __gitcomp "$__git_merge_options
1494 --rerere-autoupdate --no-rerere-autoupdate --abort"
1497 __gitcomp_nl "$(__git_refs)"
1504 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1518 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1522 __gitcomp_nl "$(__git_refs)"
1529 __gitcomp "--dry-run"
1534 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1535 # We need to show both cached and untracked files (including
1536 # empty directories) since this may not be the last argument.
1537 __git_complete_index_file "--cached --others --directory"
1539 __git_complete_index_file "--cached"
1545 __gitcomp "--tags --all --stdin"
1550 local subcommands='add append copy edit list prune remove show'
1551 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1553 case "$subcommand,$cur" in
1560 __gitcomp_nl "$(__git_refs)"
1563 __gitcomp "$subcommands --ref"
1567 add,--reuse-message=*|append,--reuse-message=*|\
1568 add,--reedit-message=*|append,--reedit-message=*)
1569 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1572 __gitcomp '--file= --message= --reedit-message=
1579 __gitcomp '--dry-run --verbose'
1588 __gitcomp_nl "$(__git_refs)"
1597 __git_complete_strategy && return
1600 --recurse-submodules=*)
1601 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1606 --rebase --no-rebase
1607 $__git_merge_options
1608 $__git_fetch_options
1613 __git_complete_remote_or_refspec
1616 __git_push_recurse_submodules="check on-demand"
1618 __git_complete_force_with_lease ()
1626 __gitcomp_nl "$(__git_refs)" "" "${cur_#*:}"
1629 __gitcomp_nl "$(__git_refs)" "" "$cur_"
1638 __gitcomp_nl "$(__git_remotes)"
1641 --recurse-submodules)
1642 __gitcomp "$__git_push_recurse_submodules"
1648 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1651 --recurse-submodules=*)
1652 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1655 --force-with-lease=*)
1656 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1661 --all --mirror --tags --dry-run --force --verbose
1662 --quiet --prune --delete --follow-tags
1663 --receive-pack= --repo= --set-upstream
1664 --force-with-lease --force-with-lease= --recurse-submodules=
1669 __git_complete_remote_or_refspec
1674 local dir="$(__gitdir)"
1675 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1676 __gitcomp "--continue --skip --abort"
1679 __git_complete_strategy && return
1682 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1687 --onto --merge --strategy --interactive
1688 --preserve-merges --stat --no-stat
1689 --committer-date-is-author-date --ignore-date
1690 --ignore-whitespace --whitespace=
1691 --autosquash --fork-point --no-fork-point
1697 __gitcomp_nl "$(__git_refs)"
1702 local subcommands="show delete expire"
1703 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1705 if [ -z "$subcommand" ]; then
1706 __gitcomp "$subcommands"
1708 __gitcomp_nl "$(__git_refs)"
1712 __git_send_email_confirm_options="always never auto cc compose"
1713 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1720 $__git_send_email_confirm_options
1721 " "" "${cur##--confirm=}"
1726 $__git_send_email_suppresscc_options
1727 " "" "${cur##--suppress-cc=}"
1731 --smtp-encryption=*)
1732 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1738 " "" "${cur##--thread=}"
1742 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1743 --compose --confirm= --dry-run --envelope-sender
1745 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1746 --no-suppress-from --no-thread --quiet
1747 --signed-off-by-cc --smtp-pass --smtp-server
1748 --smtp-server-port --smtp-encryption= --smtp-user
1749 --subject --suppress-cc= --suppress-from --thread --to
1750 --validate --no-validate
1751 $__git_format_patch_options"
1755 __git_complete_revlist
1763 __git_config_get_set_variables ()
1765 local prevword word config_file= c=$cword
1766 while [ $c -gt 1 ]; do
1769 --system|--global|--local|--file=*)
1774 config_file="$word $prevword"
1782 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1796 branch.*.remote|branch.*.pushremote)
1797 __gitcomp_nl "$(__git_remotes)"
1801 __gitcomp_nl "$(__git_refs)"
1805 __gitcomp "false true"
1809 __gitcomp_nl "$(__git_remotes)"
1813 local remote="${prev#remote.}"
1814 remote="${remote%.fetch}"
1815 if [ -z "$cur" ]; then
1816 __gitcomp_nl "refs/heads/" "" "" ""
1819 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1823 local remote="${prev#remote.}"
1824 remote="${remote%.push}"
1825 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1826 for-each-ref --format='%(refname):%(refname)' \
1830 pull.twohead|pull.octopus)
1831 __git_compute_merge_strategies
1832 __gitcomp "$__git_merge_strategies"
1835 color.branch|color.diff|color.interactive|\
1836 color.showbranch|color.status|color.ui)
1837 __gitcomp "always never auto"
1841 __gitcomp "false true"
1846 normal black red green yellow blue magenta cyan white
1847 bold dim ul blink reverse
1852 __gitcomp "log short"
1856 __gitcomp "man info web html"
1860 __gitcomp "$__git_log_date_formats"
1863 sendemail.aliasesfiletype)
1864 __gitcomp "mutt mailrc pine elm gnus"
1868 __gitcomp "$__git_send_email_confirm_options"
1871 sendemail.suppresscc)
1872 __gitcomp "$__git_send_email_suppresscc_options"
1875 sendemail.transferencoding)
1876 __gitcomp "7bit 8bit quoted-printable base64"
1879 --get|--get-all|--unset|--unset-all)
1880 __gitcomp_nl "$(__git_config_get_set_variables)"
1890 --system --global --local --file=
1891 --list --replace-all
1892 --get --get-all --get-regexp
1893 --add --unset --unset-all
1894 --remove-section --rename-section
1899 local pfx="${cur%.*}." cur_="${cur##*.}"
1900 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1904 local pfx="${cur%.*}." cur_="${cur#*.}"
1905 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1906 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1910 local pfx="${cur%.*}." cur_="${cur##*.}"
1912 argprompt cmd confirm needsfile noconsole norescan
1913 prompt revprompt revunmerged title
1918 local pfx="${cur%.*}." cur_="${cur##*.}"
1919 __gitcomp "cmd path" "$pfx" "$cur_"
1923 local pfx="${cur%.*}." cur_="${cur##*.}"
1924 __gitcomp "cmd path" "$pfx" "$cur_"
1928 local pfx="${cur%.*}." cur_="${cur##*.}"
1929 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1933 local pfx="${cur%.*}." cur_="${cur#*.}"
1934 __git_compute_all_commands
1935 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1939 local pfx="${cur%.*}." cur_="${cur##*.}"
1941 url proxy fetch push mirror skipDefaultUpdate
1942 receivepack uploadpack tagopt pushurl
1947 local pfx="${cur%.*}." cur_="${cur#*.}"
1948 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1949 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1953 local pfx="${cur%.*}." cur_="${cur##*.}"
1954 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1960 advice.commitBeforeMerge
1962 advice.implicitIdentity
1963 advice.pushNonFastForward
1964 advice.resolveConflict
1968 apply.ignorewhitespace
1970 branch.autosetupmerge
1971 branch.autosetuprebase
1975 color.branch.current
1980 color.decorate.branch
1981 color.decorate.remoteBranch
1982 color.decorate.stash
1992 color.diff.whitespace
1997 color.grep.linenumber
2000 color.grep.separator
2002 color.interactive.error
2003 color.interactive.header
2004 color.interactive.help
2005 color.interactive.prompt
2010 color.status.changed
2012 color.status.nobranch
2013 color.status.unmerged
2014 color.status.untracked
2015 color.status.updated
2024 core.bigFileThreshold
2027 core.deltaBaseCacheLimit
2032 core.fsyncobjectfiles
2036 core.logAllRefUpdates
2037 core.loosecompression
2040 core.packedGitWindowSize
2042 core.preferSymlinkRefs
2045 core.repositoryFormatVersion
2047 core.sharedRepository
2051 core.warnAmbiguousRefs
2054 diff.autorefreshindex
2056 diff.ignoreSubmodules
2063 diff.suppressBlankEmpty
2069 fetch.recurseSubmodules
2079 format.subjectprefix
2090 gc.reflogexpireunreachable
2094 gitcvs.commitmsgannotation
2095 gitcvs.dbTableNamePrefix
2106 gui.copyblamethreshold
2110 gui.matchtrackingbranch
2111 gui.newbranchtemplate
2112 gui.pruneduringfetch
2113 gui.spellingdictionary
2128 http.sslCertPasswordProtected
2133 i18n.logOutputEncoding
2139 imap.preformattedHTML
2149 interactive.singlekey
2165 mergetool.keepBackup
2166 mergetool.keepTemporaries
2171 notes.rewrite.rebase
2175 pack.deltaCacheLimit
2192 receive.denyCurrentBranch
2193 receive.denyDeleteCurrent
2195 receive.denyNonFastForwards
2198 receive.updateserverinfo
2201 repack.usedeltabaseoffset
2205 sendemail.aliasesfile
2206 sendemail.aliasfiletype
2210 sendemail.chainreplyto
2212 sendemail.envelopesender
2216 sendemail.signedoffbycc
2217 sendemail.smtpdomain
2218 sendemail.smtpencryption
2220 sendemail.smtpserver
2221 sendemail.smtpserveroption
2222 sendemail.smtpserverport
2224 sendemail.suppresscc
2225 sendemail.suppressfrom
2230 status.relativePaths
2231 status.showUntrackedFiles
2232 status.submodulesummary
2235 transfer.unpackLimit
2247 local subcommands="add rename remove set-head set-branches set-url show prune update"
2248 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2249 if [ -z "$subcommand" ]; then
2250 __gitcomp "$subcommands"
2254 case "$subcommand" in
2255 rename|remove|set-url|show|prune)
2256 __gitcomp_nl "$(__git_remotes)"
2258 set-head|set-branches)
2259 __git_complete_remote_or_refspec
2262 local i c='' IFS=$'\n'
2263 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "remotes\..*" 2>/dev/null); do
2276 __gitcomp_nl "$(__git_refs)"
2281 __git_has_doubledash && return
2285 __gitcomp "--merge --mixed --hard --soft --patch"
2289 __gitcomp_nl "$(__git_refs)"
2296 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2300 __gitcomp_nl "$(__git_refs)"
2307 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2312 __git_complete_index_file "--cached"
2317 __git_has_doubledash && return
2322 $__git_log_common_options
2323 $__git_log_shortlog_options
2324 --numbered --summary
2329 __git_complete_revlist
2334 __git_has_doubledash && return
2337 --pretty=*|--format=*)
2338 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2343 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2347 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2349 $__git_diff_common_options
2354 __git_complete_revlist_file
2362 --all --remotes --topo-order --current --more=
2363 --list --independent --merge-base --no-name
2365 --sha1-name --sparse --topics --reflog
2370 __git_complete_revlist
2375 local save_opts='--keep-index --no-keep-index --quiet --patch'
2376 local subcommands='save list show apply clear drop pop create branch'
2377 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2378 if [ -z "$subcommand" ]; then
2381 __gitcomp "$save_opts"
2384 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2385 __gitcomp "$subcommands"
2390 case "$subcommand,$cur" in
2392 __gitcomp "$save_opts"
2395 __gitcomp "--index --quiet"
2397 show,--*|drop,--*|branch,--*)
2399 show,*|apply,*|drop,*|pop,*|branch,*)
2400 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2401 | sed -n -e 's/:.*//p')"
2411 __git_has_doubledash && return
2413 local subcommands="add status init deinit update summary foreach sync"
2414 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2417 __gitcomp "--quiet --cached"
2420 __gitcomp "$subcommands"
2430 init fetch clone rebase dcommit log find-rev
2431 set-tree commit-diff info create-ignore propget
2432 proplist show-ignore show-externals branch tag blame
2433 migrate mkdirs reset gc
2435 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2436 if [ -z "$subcommand" ]; then
2437 __gitcomp "$subcommands"
2439 local remote_opts="--username= --config-dir= --no-auth-cache"
2441 --follow-parent --authors-file= --repack=
2442 --no-metadata --use-svm-props --use-svnsync-props
2443 --log-window-size= --no-checkout --quiet
2444 --repack-flags --use-log-author --localtime
2445 --ignore-paths= --include-paths= $remote_opts
2448 --template= --shared= --trunk= --tags=
2449 --branches= --stdlayout --minimize-url
2450 --no-metadata --use-svm-props --use-svnsync-props
2451 --rewrite-root= --prefix= --use-log-author
2452 --add-author-from $remote_opts
2455 --edit --rmdir --find-copies-harder --copy-similarity=
2458 case "$subcommand,$cur" in
2460 __gitcomp "--revision= --fetch-all $fc_opts"
2463 __gitcomp "--revision= $fc_opts $init_opts"
2466 __gitcomp "$init_opts"
2470 --merge --strategy= --verbose --dry-run
2471 --fetch-all --no-rebase --commit-url
2472 --revision --interactive $cmt_opts $fc_opts
2476 __gitcomp "--stdin $cmt_opts $fc_opts"
2478 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2479 show-externals,--*|mkdirs,--*)
2480 __gitcomp "--revision="
2484 --limit= --revision= --verbose --incremental
2485 --oneline --show-commit --non-recursive
2486 --authors-file= --color
2491 --merge --verbose --strategy= --local
2492 --fetch-all --dry-run $fc_opts
2496 __gitcomp "--message= --file= --revision= $cmt_opts"
2502 __gitcomp "--dry-run --message --tag"
2505 __gitcomp "--dry-run --message"
2508 __gitcomp "--git-format"
2512 --config-dir= --ignore-paths= --minimize
2513 --no-auth-cache --username=
2517 __gitcomp "--revision= --parent"
2528 while [ $c -lt $cword ]; do
2532 __gitcomp_nl "$(__git_tags)"
2547 __gitcomp_nl "$(__git_tags)"
2551 __gitcomp_nl "$(__git_refs)"
2558 --list --delete --verify --annotate --message --file
2559 --sign --cleanup --local-user --force --column --sort
2560 --contains --points-at
2573 local i c=1 command __git_dir
2575 while [ $c -lt $cword ]; do
2578 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2579 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2580 --bare) __git_dir="." ;;
2581 --help) command="help"; break ;;
2582 -c|--work-tree|--namespace) ((c++)) ;;
2584 *) command="$i"; break ;;
2589 if [ -z "$command" ]; then
2604 --no-replace-objects
2608 *) __git_compute_porcelain_commands
2609 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2614 local completion_func="_git_${command//-/_}"
2615 declare -f $completion_func >/dev/null && $completion_func && return
2617 local expansion=$(__git_aliased_command "$command")
2618 if [ -n "$expansion" ]; then
2620 completion_func="_git_${expansion//-/_}"
2621 declare -f $completion_func >/dev/null && $completion_func
2627 __git_has_doubledash && return
2629 local g="$(__gitdir)"
2631 if [ -f "$g/MERGE_HEAD" ]; then
2637 $__git_log_common_options
2638 $__git_log_gitk_options
2644 __git_complete_revlist
2647 if [[ -n ${ZSH_VERSION-} ]]; then
2648 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2650 autoload -U +X compinit && compinit
2656 local cur_="${3-$cur}"
2662 local c IFS=$' \t\n'
2670 array[${#array[@]}+1]="$c"
2673 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
2684 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2693 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2698 local _ret=1 cur cword prev
2699 cur=${words[CURRENT]}
2700 prev=${words[CURRENT-1]}
2702 emulate ksh -c __${service}_main
2703 let _ret && _default && _ret=0
2707 compdef _git git gitk
2713 local cur words cword prev
2714 _get_comp_words_by_ref -n =: cur words cword prev
2718 # Setup completion for certain functions defined above by setting common
2719 # variables and workarounds.
2720 # This is NOT a public function; use at your own risk.
2723 local wrapper="__git_wrap${2}"
2724 eval "$wrapper () { __git_func_wrap $2 ; }"
2725 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2726 || complete -o default -o nospace -F $wrapper $1
2729 # wrapper for backwards compatibility
2732 __git_wrap__git_main
2735 # wrapper for backwards compatibility
2738 __git_wrap__gitk_main
2741 __git_complete git __git_main
2742 __git_complete gitk __gitk_main
2744 # The following are necessary only for Cygwin, and only are needed
2745 # when the user has tab-completed the executable name and consequently
2746 # included the '.exe' suffix.
2748 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2749 __git_complete git.exe __git_main