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)" -- "refs/remotes/$dir/" | sed -e "s#^$dir/##"
396 # __git_refs2 requires 1 argument (to pass to __git_refs)
400 for i in $(__git_refs "$1"); do
405 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
406 __git_refs_remotes ()
409 git ls-remote "$1" 'refs/heads/*' 2>/dev/null | \
410 while read -r hash i; do
411 echo "$i:refs/remotes/$1/${i#refs/heads/}"
417 local i IFS=$'\n' d="$(__gitdir)"
418 test -d "$d/remotes" && ls -1 "$d/remotes"
419 for i in $(git --git-dir="$d" config --get-regexp 'remote\..*\.url' 2>/dev/null); do
425 __git_list_merge_strategies ()
427 git merge -s help 2>&1 |
428 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
437 __git_merge_strategies=
438 # 'git merge -s help' (and thus detection of the merge strategy
439 # list) fails, unfortunately, if run outside of any git working
440 # tree. __git_merge_strategies is set to the empty string in
441 # that case, and the detection will be repeated the next time it
443 __git_compute_merge_strategies ()
445 test -n "$__git_merge_strategies" ||
446 __git_merge_strategies=$(__git_list_merge_strategies)
449 __git_complete_revlist_file ()
451 local pfx ls ref cur_="$cur"
471 case "$COMP_WORDBREAKS" in
473 *) pfx="$ref:$pfx" ;;
476 __gitcomp_nl "$(git --git-dir="$(__gitdir)" ls-tree "$ls" 2>/dev/null \
477 | sed '/^100... blob /{
493 pfx="${cur_%...*}..."
495 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
500 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
503 __gitcomp_nl "$(__git_refs)"
509 # __git_complete_index_file requires 1 argument:
510 # 1: the options to pass to ls-file
512 # The exception is --committable, which finds the files appropriate commit.
513 __git_complete_index_file ()
515 local pfx="" cur_="$cur"
525 __gitcomp_file "$(__git_index_files "$1" "$pfx")" "$pfx" "$cur_"
528 __git_complete_file ()
530 __git_complete_revlist_file
533 __git_complete_revlist ()
535 __git_complete_revlist_file
538 __git_complete_remote_or_refspec ()
540 local cur_="$cur" cmd="${words[1]}"
541 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
542 if [ "$cmd" = "remote" ]; then
545 while [ $c -lt $cword ]; do
548 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
551 push) no_complete_refspec=1 ;;
559 *) remote="$i"; break ;;
563 if [ -z "$remote" ]; then
564 __gitcomp_nl "$(__git_remotes)"
567 if [ $no_complete_refspec = 1 ]; then
570 [ "$remote" = "." ] && remote=
573 case "$COMP_WORDBREAKS" in
575 *) pfx="${cur_%%:*}:" ;;
587 if [ $lhs = 1 ]; then
588 __gitcomp_nl "$(__git_refs2 "$remote")" "$pfx" "$cur_"
590 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
594 if [ $lhs = 1 ]; then
595 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
597 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
601 if [ $lhs = 1 ]; then
602 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
604 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
610 __git_complete_strategy ()
612 __git_compute_merge_strategies
615 __gitcomp "$__git_merge_strategies"
620 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
628 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
630 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
632 git help -a|egrep '^ [a-zA-Z0-9]'
636 __git_list_all_commands ()
639 for i in $(__git_commands)
642 *--*) : helper pattern;;
649 __git_compute_all_commands ()
651 test -n "$__git_all_commands" ||
652 __git_all_commands=$(__git_list_all_commands)
655 __git_list_porcelain_commands ()
658 __git_compute_all_commands
659 for i in $__git_all_commands
662 *--*) : helper pattern;;
663 applymbox) : ask gittus;;
664 applypatch) : ask gittus;;
665 archimport) : import;;
666 cat-file) : plumbing;;
667 check-attr) : plumbing;;
668 check-ignore) : plumbing;;
669 check-mailmap) : plumbing;;
670 check-ref-format) : plumbing;;
671 checkout-index) : plumbing;;
672 commit-tree) : plumbing;;
673 count-objects) : infrequent;;
674 credential-cache) : credentials helper;;
675 credential-store) : credentials helper;;
676 cvsexportcommit) : export;;
677 cvsimport) : import;;
678 cvsserver) : daemon;;
680 diff-files) : plumbing;;
681 diff-index) : plumbing;;
682 diff-tree) : plumbing;;
683 fast-import) : import;;
684 fast-export) : export;;
685 fsck-objects) : plumbing;;
686 fetch-pack) : plumbing;;
687 fmt-merge-msg) : plumbing;;
688 for-each-ref) : plumbing;;
689 hash-object) : plumbing;;
690 http-*) : transport;;
691 index-pack) : plumbing;;
692 init-db) : deprecated;;
693 local-fetch) : plumbing;;
694 ls-files) : plumbing;;
695 ls-remote) : plumbing;;
696 ls-tree) : plumbing;;
697 mailinfo) : plumbing;;
698 mailsplit) : plumbing;;
699 merge-*) : plumbing;;
702 pack-objects) : plumbing;;
703 pack-redundant) : plumbing;;
704 pack-refs) : plumbing;;
705 parse-remote) : plumbing;;
706 patch-id) : plumbing;;
708 prune-packed) : plumbing;;
709 quiltimport) : import;;
710 read-tree) : plumbing;;
711 receive-pack) : plumbing;;
712 remote-*) : transport;;
714 rev-list) : plumbing;;
715 rev-parse) : plumbing;;
716 runstatus) : plumbing;;
717 sh-setup) : internal;;
719 show-ref) : plumbing;;
720 send-pack) : plumbing;;
721 show-index) : plumbing;;
723 stripspace) : plumbing;;
724 symbolic-ref) : plumbing;;
725 unpack-file) : plumbing;;
726 unpack-objects) : plumbing;;
727 update-index) : plumbing;;
728 update-ref) : plumbing;;
729 update-server-info) : daemon;;
730 upload-archive) : plumbing;;
731 upload-pack) : plumbing;;
732 write-tree) : plumbing;;
734 verify-pack) : infrequent;;
735 verify-tag) : plumbing;;
741 __git_porcelain_commands=
742 __git_compute_porcelain_commands ()
744 __git_compute_all_commands
745 test -n "$__git_porcelain_commands" ||
746 __git_porcelain_commands=$(__git_list_porcelain_commands)
749 __git_pretty_aliases ()
752 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "pretty\..*" 2>/dev/null); do
765 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "alias\..*" 2>/dev/null); do
775 # __git_aliased_command requires 1 argument
776 __git_aliased_command ()
778 local word cmdline=$(git --git-dir="$(__gitdir)" \
779 config --get "alias.$1")
780 for word in $cmdline; do
786 \!*) : shell command alias ;;
788 *=*) : setting env ;;
790 \(\)) : skip parens of shell function definition ;;
791 {) : skip start of shell helper function ;;
792 :) : skip null command ;;
793 \'*) : skip opening quote after sh -c ;;
801 # __git_find_on_cmdline requires 1 argument
802 __git_find_on_cmdline ()
804 local word subcommand c=1
805 while [ $c -lt $cword ]; do
807 for subcommand in $1; do
808 if [ "$subcommand" = "$word" ]; then
817 __git_has_doubledash ()
820 while [ $c -lt $cword ]; do
821 if [ "--" = "${words[c]}" ]; then
829 # Try to count non option arguments passed on the command line for the
830 # specified git command.
831 # When options are used, it is necessary to use the special -- option to
832 # tell the implementation were non option arguments begin.
833 # XXX this can not be improved, since options can appear everywhere, as
837 # __git_count_arguments requires 1 argument: the git command executed.
838 __git_count_arguments ()
842 # Skip "git" (first argument)
843 for ((i=1; i < ${#words[@]}; i++)); do
848 # Good; we can assume that the following are only non
853 # Skip the specified git command and discard git
866 __git_whitespacelist="nowarn warn error error-all fix"
870 local dir="$(__gitdir)"
871 if [ -d "$dir"/rebase-apply ]; then
872 __gitcomp "--skip --continue --resolved --abort"
877 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
882 --3way --committer-date-is-author-date --ignore-date
883 --ignore-whitespace --ignore-space-change
884 --interactive --keep --no-utf8 --signoff --utf8
885 --whitespace= --scissors
895 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
900 --stat --numstat --summary --check --index
901 --cached --index-info --reverse --reject --unidiff-zero
902 --apply --no-add --exclude=
903 --ignore-whitespace --ignore-space-change
904 --whitespace= --inaccurate-eof --verbose
915 --interactive --refresh --patch --update --dry-run
916 --ignore-errors --intent-to-add
921 # XXX should we check for --update and --all options ?
922 __git_complete_index_file "--others --modified --directory --no-empty-directory"
929 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
933 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
938 --format= --list --verbose
939 --prefix= --remote= --exec=
949 __git_has_doubledash && return
951 local subcommands="start bad good skip reset visualize replay log run"
952 local subcommand="$(__git_find_on_cmdline "$subcommands")"
953 if [ -z "$subcommand" ]; then
954 if [ -f "$(__gitdir)"/BISECT_START ]; then
955 __gitcomp "$subcommands"
957 __gitcomp "replay start"
962 case "$subcommand" in
963 bad|good|reset|skip|start)
964 __gitcomp_nl "$(__git_refs)"
973 local i c=1 only_local_ref="n" has_r="n"
975 while [ $c -lt $cword ]; do
978 -d|-m) only_local_ref="y" ;;
986 __gitcomp "$(__git_refs)" "" "${cur##--set-upstream-to=}"
990 --color --no-color --verbose --abbrev= --no-abbrev
991 --track --no-track --contains --merged --no-merged
992 --set-upstream-to= --edit-description --list
997 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
998 __gitcomp_nl "$(__git_heads)"
1000 __gitcomp_nl "$(__git_refs)"
1008 local cmd="${words[2]}"
1011 __gitcomp "create list-heads verify unbundle"
1014 # looking for a file
1019 __git_complete_revlist
1028 __git_has_doubledash && return
1032 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1036 --quiet --ours --theirs --track --no-track --merge
1037 --conflict= --orphan --patch
1041 # check if --track, --no-track, or --no-guess was specified
1042 # if so, disable DWIM mode
1043 local flags="--track --no-track --no-guess" track=1
1044 if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1047 __gitcomp_nl "$(__git_refs '' $track)"
1054 __gitcomp "$(__git_refs)"
1059 local dir="$(__gitdir)"
1060 if [ -f "$dir"/CHERRY_PICK_HEAD ]; then
1061 __gitcomp "--continue --quit --abort"
1066 __gitcomp "--edit --no-commit --signoff --strategy= --mainline"
1069 __gitcomp_nl "$(__git_refs)"
1078 __gitcomp "--dry-run --quiet"
1083 # XXX should we check for -x option ?
1084 __git_complete_index_file "--others --directory"
1116 __gitcomp_nl "$(__git_refs)" "" "${cur}"
1123 __gitcomp "default strip verbatim whitespace
1124 " "" "${cur##--cleanup=}"
1127 --reuse-message=*|--reedit-message=*|\
1128 --fixup=*|--squash=*)
1129 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1132 --untracked-files=*)
1133 __gitcomp "all no normal" "" "${cur##--untracked-files=}"
1138 --all --author= --signoff --verify --no-verify
1140 --amend --include --only --interactive
1141 --dry-run --reuse-message= --reedit-message=
1142 --reset-author --file= --message= --template=
1143 --cleanup= --untracked-files --untracked-files=
1144 --verbose --quiet --fixup= --squash=
1149 if git rev-parse --verify --quiet HEAD >/dev/null; then
1150 __git_complete_index_file "--committable"
1152 # This is the first commit
1153 __git_complete_index_file "--cached"
1162 --all --tags --contains --abbrev= --candidates=
1163 --exact-match --debug --long --match --always
1167 __gitcomp_nl "$(__git_refs)"
1170 __git_diff_algorithms="myers minimal patience histogram"
1172 __git_diff_common_options="--stat --numstat --shortstat --summary
1173 --patch-with-stat --name-only --name-status --color
1174 --no-color --color-words --no-renames --check
1175 --full-index --binary --abbrev --diff-filter=
1176 --find-copies-harder
1177 --text --ignore-space-at-eol --ignore-space-change
1178 --ignore-all-space --ignore-blank-lines --exit-code
1179 --quiet --ext-diff --no-ext-diff
1180 --no-prefix --src-prefix= --dst-prefix=
1181 --inter-hunk-context=
1182 --patience --histogram --minimal
1184 --dirstat --dirstat= --dirstat-by-file
1185 --dirstat-by-file= --cumulative
1191 __git_has_doubledash && return
1195 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1199 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1200 --base --ours --theirs --no-index
1201 $__git_diff_common_options
1206 __git_complete_revlist_file
1209 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1210 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc3 codecompare
1215 __git_has_doubledash && return
1219 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1223 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1224 --base --ours --theirs
1225 --no-renames --diff-filter= --find-copies-harder
1226 --relative --ignore-submodules
1231 __git_complete_revlist_file
1234 __git_fetch_recurse_submodules="yes on-demand no"
1236 __git_fetch_options="
1237 --quiet --verbose --append --upload-pack --force --keep --depth=
1238 --tags --no-tags --all --prune --dry-run --recurse-submodules=
1244 --recurse-submodules=*)
1245 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1249 __gitcomp "$__git_fetch_options"
1253 __git_complete_remote_or_refspec
1256 __git_format_patch_options="
1257 --stdout --attach --no-attach --thread --thread= --no-thread
1258 --numbered --start-number --numbered-files --keep-subject --signoff
1259 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1260 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1261 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1262 --output-directory --reroll-count --to= --quiet --notes
1265 _git_format_patch ()
1271 " "" "${cur##--thread=}"
1275 __gitcomp "$__git_format_patch_options"
1279 __git_complete_revlist
1287 --tags --root --unreachable --cache --no-reflogs --full
1288 --strict --verbose --lost-found
1299 __gitcomp "--prune --aggressive"
1310 __git_match_ctag() {
1311 awk "/^${1////\\/}/ { print \$1 }" "$2"
1316 __git_has_doubledash && return
1322 --text --ignore-case --word-regexp --invert-match
1323 --full-name --line-number
1324 --extended-regexp --basic-regexp --fixed-strings
1326 --files-with-matches --name-only
1327 --files-without-match
1330 --and --or --not --all-match
1336 case "$cword,$prev" in
1338 if test -r tags; then
1339 __gitcomp_nl "$(__git_match_ctag "$cur" tags)"
1345 __gitcomp_nl "$(__git_refs)"
1352 __gitcomp "--all --info --man --web"
1356 __git_compute_all_commands
1357 __gitcomp "$__git_all_commands $(__git_aliases)
1358 attributes cli core-tutorial cvs-migration
1359 diffcore gitk glossary hooks ignore modules
1360 namespaces repository-layout tutorial tutorial-2
1370 false true umask group all world everybody
1371 " "" "${cur##--shared=}"
1375 __gitcomp "--quiet --bare --template= --shared --shared="
1385 __gitcomp "--cached --deleted --modified --others --ignored
1386 --stage --directory --no-empty-directory --unmerged
1387 --killed --exclude= --exclude-from=
1388 --exclude-per-directory= --exclude-standard
1389 --error-unmatch --with-tree= --full-name
1390 --abbrev --ignored --exclude-per-directory
1396 # XXX ignore options like --modified and always suggest all cached
1398 __git_complete_index_file "--cached"
1403 __gitcomp_nl "$(__git_remotes)"
1411 # Options that go well for log, shortlog and gitk
1412 __git_log_common_options="
1414 --branches --tags --remotes
1415 --first-parent --merges --no-merges
1417 --max-age= --since= --after=
1418 --min-age= --until= --before=
1419 --min-parents= --max-parents=
1420 --no-min-parents --no-max-parents
1422 # Options that go well for log and gitk (not shortlog)
1423 __git_log_gitk_options="
1424 --dense --sparse --full-history
1425 --simplify-merges --simplify-by-decoration
1426 --left-right --notes --no-notes
1428 # Options that go well for log and shortlog (not gitk)
1429 __git_log_shortlog_options="
1430 --author= --committer= --grep=
1434 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1435 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1439 __git_has_doubledash && return
1441 local g="$(git rev-parse --git-dir 2>/dev/null)"
1443 if [ -f "$g/MERGE_HEAD" ]; then
1447 --pretty=*|--format=*)
1448 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1453 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1457 __gitcomp "long short" "" "${cur##--decorate=}"
1462 $__git_log_common_options
1463 $__git_log_shortlog_options
1464 $__git_log_gitk_options
1465 --root --topo-order --date-order --reverse
1466 --follow --full-diff
1467 --abbrev-commit --abbrev=
1468 --relative-date --date=
1469 --pretty= --format= --oneline
1472 --decorate --decorate=
1474 --parents --children
1476 $__git_diff_common_options
1477 --pickaxe-all --pickaxe-regex
1482 __git_complete_revlist
1485 # Common merge options shared by git-merge(1) and git-pull(1).
1486 __git_merge_options="
1487 --no-commit --no-stat --log --no-log --squash --strategy
1488 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1489 --verify-signatures --no-verify-signatures --gpg-sign
1490 --quiet --verbose --progress --no-progress
1495 __git_complete_strategy && return
1499 __gitcomp "$__git_merge_options
1500 --rerere-autoupdate --no-rerere-autoupdate --abort"
1503 __gitcomp_nl "$(__git_refs)"
1510 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1524 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1528 __gitcomp_nl "$(__git_refs)"
1535 __gitcomp "--dry-run"
1540 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1541 # We need to show both cached and untracked files (including
1542 # empty directories) since this may not be the last argument.
1543 __git_complete_index_file "--cached --others --directory"
1545 __git_complete_index_file "--cached"
1551 __gitcomp "--tags --all --stdin"
1556 local subcommands='add append copy edit list prune remove show'
1557 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1559 case "$subcommand,$cur" in
1566 __gitcomp_nl "$(__git_refs)"
1569 __gitcomp "$subcommands --ref"
1573 add,--reuse-message=*|append,--reuse-message=*|\
1574 add,--reedit-message=*|append,--reedit-message=*)
1575 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1578 __gitcomp '--file= --message= --reedit-message=
1585 __gitcomp '--dry-run --verbose'
1594 __gitcomp_nl "$(__git_refs)"
1603 __git_complete_strategy && return
1606 --recurse-submodules=*)
1607 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1612 --rebase --no-rebase
1613 $__git_merge_options
1614 $__git_fetch_options
1619 __git_complete_remote_or_refspec
1622 __git_push_recurse_submodules="check on-demand"
1624 __git_complete_force_with_lease ()
1632 __gitcomp_nl "$(__git_refs)" "" "${cur_#*:}"
1635 __gitcomp_nl "$(__git_refs)" "" "$cur_"
1644 __gitcomp_nl "$(__git_remotes)"
1647 --recurse-submodules)
1648 __gitcomp "$__git_push_recurse_submodules"
1654 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1657 --recurse-submodules=*)
1658 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1661 --force-with-lease=*)
1662 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1667 --all --mirror --tags --dry-run --force --verbose
1668 --quiet --prune --delete --follow-tags
1669 --receive-pack= --repo= --set-upstream
1670 --force-with-lease --force-with-lease= --recurse-submodules=
1675 __git_complete_remote_or_refspec
1680 local dir="$(__gitdir)"
1681 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1682 __gitcomp "--continue --skip --abort"
1685 __git_complete_strategy && return
1688 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1693 --onto --merge --strategy --interactive
1694 --preserve-merges --stat --no-stat
1695 --committer-date-is-author-date --ignore-date
1696 --ignore-whitespace --whitespace=
1697 --autosquash --fork-point --no-fork-point
1702 __gitcomp_nl "$(__git_refs)"
1707 local subcommands="show delete expire"
1708 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1710 if [ -z "$subcommand" ]; then
1711 __gitcomp "$subcommands"
1713 __gitcomp_nl "$(__git_refs)"
1717 __git_send_email_confirm_options="always never auto cc compose"
1718 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1725 $__git_send_email_confirm_options
1726 " "" "${cur##--confirm=}"
1731 $__git_send_email_suppresscc_options
1732 " "" "${cur##--suppress-cc=}"
1736 --smtp-encryption=*)
1737 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1743 " "" "${cur##--thread=}"
1747 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1748 --compose --confirm= --dry-run --envelope-sender
1750 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1751 --no-suppress-from --no-thread --quiet
1752 --signed-off-by-cc --smtp-pass --smtp-server
1753 --smtp-server-port --smtp-encryption= --smtp-user
1754 --subject --suppress-cc= --suppress-from --thread --to
1755 --validate --no-validate
1756 $__git_format_patch_options"
1760 __git_complete_revlist
1768 __git_config_get_set_variables ()
1770 local prevword word config_file= c=$cword
1771 while [ $c -gt 1 ]; do
1774 --system|--global|--local|--file=*)
1779 config_file="$word $prevword"
1787 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1801 branch.*.remote|branch.*.pushremote)
1802 __gitcomp_nl "$(__git_remotes)"
1806 __gitcomp_nl "$(__git_refs)"
1810 __gitcomp "false true"
1814 __gitcomp_nl "$(__git_remotes)"
1818 local remote="${prev#remote.}"
1819 remote="${remote%.fetch}"
1820 if [ -z "$cur" ]; then
1821 __gitcomp_nl "refs/heads/" "" "" ""
1824 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1828 local remote="${prev#remote.}"
1829 remote="${remote%.push}"
1830 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1831 for-each-ref --format='%(refname):%(refname)' \
1835 pull.twohead|pull.octopus)
1836 __git_compute_merge_strategies
1837 __gitcomp "$__git_merge_strategies"
1840 color.branch|color.diff|color.interactive|\
1841 color.showbranch|color.status|color.ui)
1842 __gitcomp "always never auto"
1846 __gitcomp "false true"
1851 normal black red green yellow blue magenta cyan white
1852 bold dim ul blink reverse
1857 __gitcomp "log short"
1861 __gitcomp "man info web html"
1865 __gitcomp "$__git_log_date_formats"
1868 sendemail.aliasesfiletype)
1869 __gitcomp "mutt mailrc pine elm gnus"
1873 __gitcomp "$__git_send_email_confirm_options"
1876 sendemail.suppresscc)
1877 __gitcomp "$__git_send_email_suppresscc_options"
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.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
2191 receive.denyCurrentBranch
2192 receive.denyDeleteCurrent
2194 receive.denyNonFastForwards
2197 receive.updateserverinfo
2200 repack.usedeltabaseoffset
2204 sendemail.aliasesfile
2205 sendemail.aliasfiletype
2209 sendemail.chainreplyto
2211 sendemail.envelopesender
2215 sendemail.signedoffbycc
2216 sendemail.smtpdomain
2217 sendemail.smtpencryption
2219 sendemail.smtpserver
2220 sendemail.smtpserveroption
2221 sendemail.smtpserverport
2223 sendemail.suppresscc
2224 sendemail.suppressfrom
2229 status.relativePaths
2230 status.showUntrackedFiles
2231 status.submodulesummary
2234 transfer.unpackLimit
2246 local subcommands="add rename remove set-head set-branches set-url show prune update"
2247 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2248 if [ -z "$subcommand" ]; then
2249 __gitcomp "$subcommands"
2253 case "$subcommand" in
2254 rename|remove|set-url|show|prune)
2255 __gitcomp_nl "$(__git_remotes)"
2257 set-head|set-branches)
2258 __git_complete_remote_or_refspec
2261 local i c='' IFS=$'\n'
2262 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "remotes\..*" 2>/dev/null); do
2275 __gitcomp_nl "$(__git_refs)"
2280 __git_has_doubledash && return
2284 __gitcomp "--merge --mixed --hard --soft --patch"
2288 __gitcomp_nl "$(__git_refs)"
2295 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2299 __gitcomp_nl "$(__git_refs)"
2306 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2311 __git_complete_index_file "--cached"
2316 __git_has_doubledash && return
2321 $__git_log_common_options
2322 $__git_log_shortlog_options
2323 --numbered --summary
2328 __git_complete_revlist
2333 __git_has_doubledash && return
2336 --pretty=*|--format=*)
2337 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2342 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2346 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2347 $__git_diff_common_options
2352 __git_complete_revlist_file
2360 --all --remotes --topo-order --current --more=
2361 --list --independent --merge-base --no-name
2363 --sha1-name --sparse --topics --reflog
2368 __git_complete_revlist
2373 local save_opts='--keep-index --no-keep-index --quiet --patch'
2374 local subcommands='save list show apply clear drop pop create branch'
2375 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2376 if [ -z "$subcommand" ]; then
2379 __gitcomp "$save_opts"
2382 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2383 __gitcomp "$subcommands"
2388 case "$subcommand,$cur" in
2390 __gitcomp "$save_opts"
2393 __gitcomp "--index --quiet"
2395 show,--*|drop,--*|branch,--*)
2397 show,*|apply,*|drop,*|pop,*|branch,*)
2398 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2399 | sed -n -e 's/:.*//p')"
2409 __git_has_doubledash && return
2411 local subcommands="add status init deinit update summary foreach sync"
2412 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2415 __gitcomp "--quiet --cached"
2418 __gitcomp "$subcommands"
2428 init fetch clone rebase dcommit log find-rev
2429 set-tree commit-diff info create-ignore propget
2430 proplist show-ignore show-externals branch tag blame
2431 migrate mkdirs reset gc
2433 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2434 if [ -z "$subcommand" ]; then
2435 __gitcomp "$subcommands"
2437 local remote_opts="--username= --config-dir= --no-auth-cache"
2439 --follow-parent --authors-file= --repack=
2440 --no-metadata --use-svm-props --use-svnsync-props
2441 --log-window-size= --no-checkout --quiet
2442 --repack-flags --use-log-author --localtime
2443 --ignore-paths= --include-paths= $remote_opts
2446 --template= --shared= --trunk= --tags=
2447 --branches= --stdlayout --minimize-url
2448 --no-metadata --use-svm-props --use-svnsync-props
2449 --rewrite-root= --prefix= --use-log-author
2450 --add-author-from $remote_opts
2453 --edit --rmdir --find-copies-harder --copy-similarity=
2456 case "$subcommand,$cur" in
2458 __gitcomp "--revision= --fetch-all $fc_opts"
2461 __gitcomp "--revision= $fc_opts $init_opts"
2464 __gitcomp "$init_opts"
2468 --merge --strategy= --verbose --dry-run
2469 --fetch-all --no-rebase --commit-url
2470 --revision --interactive $cmt_opts $fc_opts
2474 __gitcomp "--stdin $cmt_opts $fc_opts"
2476 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2477 show-externals,--*|mkdirs,--*)
2478 __gitcomp "--revision="
2482 --limit= --revision= --verbose --incremental
2483 --oneline --show-commit --non-recursive
2484 --authors-file= --color
2489 --merge --verbose --strategy= --local
2490 --fetch-all --dry-run $fc_opts
2494 __gitcomp "--message= --file= --revision= $cmt_opts"
2500 __gitcomp "--dry-run --message --tag"
2503 __gitcomp "--dry-run --message"
2506 __gitcomp "--git-format"
2510 --config-dir= --ignore-paths= --minimize
2511 --no-auth-cache --username=
2515 __gitcomp "--revision= --parent"
2526 while [ $c -lt $cword ]; do
2530 __gitcomp_nl "$(__git_tags)"
2545 __gitcomp_nl "$(__git_tags)"
2549 __gitcomp_nl "$(__git_refs)"
2561 local i c=1 command __git_dir
2563 while [ $c -lt $cword ]; do
2566 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2567 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2568 --bare) __git_dir="." ;;
2569 --help) command="help"; break ;;
2570 -c|--work-tree|--namespace) ((c++)) ;;
2572 *) command="$i"; break ;;
2577 if [ -z "$command" ]; then
2592 --no-replace-objects
2596 *) __git_compute_porcelain_commands
2597 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2602 local completion_func="_git_${command//-/_}"
2603 declare -f $completion_func >/dev/null && $completion_func && return
2605 local expansion=$(__git_aliased_command "$command")
2606 if [ -n "$expansion" ]; then
2608 completion_func="_git_${expansion//-/_}"
2609 declare -f $completion_func >/dev/null && $completion_func
2615 __git_has_doubledash && return
2617 local g="$(__gitdir)"
2619 if [ -f "$g/MERGE_HEAD" ]; then
2625 $__git_log_common_options
2626 $__git_log_gitk_options
2632 __git_complete_revlist
2635 if [[ -n ${ZSH_VERSION-} ]]; then
2636 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2638 autoload -U +X compinit && compinit
2644 local cur_="${3-$cur}"
2650 local c IFS=$' \t\n'
2658 array[${#array[@]}+1]="$c"
2661 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
2672 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2681 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2686 local _ret=1 cur cword prev
2687 cur=${words[CURRENT]}
2688 prev=${words[CURRENT-1]}
2690 emulate ksh -c __${service}_main
2691 let _ret && _default && _ret=0
2695 compdef _git git gitk
2701 local cur words cword prev
2702 _get_comp_words_by_ref -n =: cur words cword prev
2706 # Setup completion for certain functions defined above by setting common
2707 # variables and workarounds.
2708 # This is NOT a public function; use at your own risk.
2711 local wrapper="__git_wrap${2}"
2712 eval "$wrapper () { __git_func_wrap $2 ; }"
2713 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2714 || complete -o default -o nospace -F $wrapper $1
2717 # wrapper for backwards compatibility
2720 __git_wrap__git_main
2723 # wrapper for backwards compatibility
2726 __git_wrap__gitk_main
2729 __git_complete git __git_main
2730 __git_complete gitk __gitk_main
2732 # The following are necessary only for Cygwin, and only are needed
2733 # when the user has tab-completed the executable name and consequently
2734 # included the '.exe' suffix.
2736 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2737 __git_complete git.exe __git_main