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 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) : credentials;;
669 credential-*) : 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 # Lists all set config variables starting with the given section prefix,
743 # with the prefix removed.
744 __git_get_config_variables ()
746 local section="$1" i IFS=$'\n'
747 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "^$section\..*" 2>/dev/null); do
753 __git_pretty_aliases ()
755 __git_get_config_variables "pretty"
760 __git_get_config_variables "alias"
763 # __git_aliased_command requires 1 argument
764 __git_aliased_command ()
766 local word cmdline=$(git --git-dir="$(__gitdir)" \
767 config --get "alias.$1")
768 for word in $cmdline; do
774 \!*) : shell command alias ;;
776 *=*) : setting env ;;
778 \(\)) : skip parens of shell function definition ;;
779 {) : skip start of shell helper function ;;
780 :) : skip null command ;;
781 \'*) : skip opening quote after sh -c ;;
789 # __git_find_on_cmdline requires 1 argument
790 __git_find_on_cmdline ()
792 local word subcommand c=1
793 while [ $c -lt $cword ]; do
795 for subcommand in $1; do
796 if [ "$subcommand" = "$word" ]; then
805 __git_has_doubledash ()
808 while [ $c -lt $cword ]; do
809 if [ "--" = "${words[c]}" ]; then
817 # Try to count non option arguments passed on the command line for the
818 # specified git command.
819 # When options are used, it is necessary to use the special -- option to
820 # tell the implementation were non option arguments begin.
821 # XXX this can not be improved, since options can appear everywhere, as
825 # __git_count_arguments requires 1 argument: the git command executed.
826 __git_count_arguments ()
830 # Skip "git" (first argument)
831 for ((i=1; i < ${#words[@]}; i++)); do
836 # Good; we can assume that the following are only non
841 # Skip the specified git command and discard git
854 __git_whitespacelist="nowarn warn error error-all fix"
858 local dir="$(__gitdir)"
859 if [ -d "$dir"/rebase-apply ]; then
860 __gitcomp "--skip --continue --resolved --abort"
865 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
870 --3way --committer-date-is-author-date --ignore-date
871 --ignore-whitespace --ignore-space-change
872 --interactive --keep --no-utf8 --signoff --utf8
873 --whitespace= --scissors
883 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
888 --stat --numstat --summary --check --index
889 --cached --index-info --reverse --reject --unidiff-zero
890 --apply --no-add --exclude=
891 --ignore-whitespace --ignore-space-change
892 --whitespace= --inaccurate-eof --verbose
903 --interactive --refresh --patch --update --dry-run
904 --ignore-errors --intent-to-add
909 # XXX should we check for --update and --all options ?
910 __git_complete_index_file "--others --modified --directory --no-empty-directory"
917 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
921 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
926 --format= --list --verbose
927 --prefix= --remote= --exec=
937 __git_has_doubledash && return
939 local subcommands="start bad good skip reset visualize replay log run"
940 local subcommand="$(__git_find_on_cmdline "$subcommands")"
941 if [ -z "$subcommand" ]; then
942 if [ -f "$(__gitdir)"/BISECT_START ]; then
943 __gitcomp "$subcommands"
945 __gitcomp "replay start"
950 case "$subcommand" in
951 bad|good|reset|skip|start)
952 __gitcomp_nl "$(__git_refs)"
961 local i c=1 only_local_ref="n" has_r="n"
963 while [ $c -lt $cword ]; do
966 -d|-m) only_local_ref="y" ;;
974 __gitcomp_nl "$(__git_refs)" "" "${cur##--set-upstream-to=}"
978 --color --no-color --verbose --abbrev= --no-abbrev
979 --track --no-track --contains --merged --no-merged
980 --set-upstream-to= --edit-description --list
985 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
986 __gitcomp_nl "$(__git_heads)"
988 __gitcomp_nl "$(__git_refs)"
996 local cmd="${words[2]}"
999 __gitcomp "create list-heads verify unbundle"
1002 # looking for a file
1007 __git_complete_revlist
1016 __git_has_doubledash && return
1020 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1024 --quiet --ours --theirs --track --no-track --merge
1025 --conflict= --orphan --patch
1029 # check if --track, --no-track, or --no-guess was specified
1030 # if so, disable DWIM mode
1031 local flags="--track --no-track --no-guess" track=1
1032 if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1035 __gitcomp_nl "$(__git_refs '' $track)"
1042 __gitcomp_nl "$(__git_refs)"
1047 local dir="$(__gitdir)"
1048 if [ -f "$dir"/CHERRY_PICK_HEAD ]; then
1049 __gitcomp "--continue --quit --abort"
1054 __gitcomp "--edit --no-commit --signoff --strategy= --mainline"
1057 __gitcomp_nl "$(__git_refs)"
1066 __gitcomp "--dry-run --quiet"
1071 # XXX should we check for -x option ?
1072 __git_complete_index_file "--others --directory"
1104 __gitcomp_nl "$(__git_refs)" "" "${cur}"
1111 __gitcomp "default scissors strip verbatim whitespace
1112 " "" "${cur##--cleanup=}"
1115 --reuse-message=*|--reedit-message=*|\
1116 --fixup=*|--squash=*)
1117 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1120 --untracked-files=*)
1121 __gitcomp "all no normal" "" "${cur##--untracked-files=}"
1126 --all --author= --signoff --verify --no-verify
1128 --amend --include --only --interactive
1129 --dry-run --reuse-message= --reedit-message=
1130 --reset-author --file= --message= --template=
1131 --cleanup= --untracked-files --untracked-files=
1132 --verbose --quiet --fixup= --squash=
1137 if git rev-parse --verify --quiet HEAD >/dev/null; then
1138 __git_complete_index_file "--committable"
1140 # This is the first commit
1141 __git_complete_index_file "--cached"
1150 --all --tags --contains --abbrev= --candidates=
1151 --exact-match --debug --long --match --always
1155 __gitcomp_nl "$(__git_refs)"
1158 __git_diff_algorithms="myers minimal patience histogram"
1160 __git_diff_common_options="--stat --numstat --shortstat --summary
1161 --patch-with-stat --name-only --name-status --color
1162 --no-color --color-words --no-renames --check
1163 --full-index --binary --abbrev --diff-filter=
1164 --find-copies-harder
1165 --text --ignore-space-at-eol --ignore-space-change
1166 --ignore-all-space --ignore-blank-lines --exit-code
1167 --quiet --ext-diff --no-ext-diff
1168 --no-prefix --src-prefix= --dst-prefix=
1169 --inter-hunk-context=
1170 --patience --histogram --minimal
1172 --dirstat --dirstat= --dirstat-by-file
1173 --dirstat-by-file= --cumulative
1179 __git_has_doubledash && return
1183 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1187 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1188 --base --ours --theirs --no-index
1189 $__git_diff_common_options
1194 __git_complete_revlist_file
1197 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1198 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc codecompare
1203 __git_has_doubledash && return
1207 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1211 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1212 --base --ours --theirs
1213 --no-renames --diff-filter= --find-copies-harder
1214 --relative --ignore-submodules
1219 __git_complete_revlist_file
1222 __git_fetch_recurse_submodules="yes on-demand no"
1224 __git_fetch_options="
1225 --quiet --verbose --append --upload-pack --force --keep --depth=
1226 --tags --no-tags --all --prune --dry-run --recurse-submodules=
1227 --no-recurse-submodules --unshallow --update-shallow --multiple
1228 --submodule-prefix= --update-head-ok --progress
1234 --recurse-submodules=*)
1235 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1239 __gitcomp "$__git_fetch_options"
1243 __git_complete_remote_or_refspec
1246 __git_format_patch_options="
1247 --stdout --attach --no-attach --thread --thread= --no-thread
1248 --numbered --start-number --numbered-files --keep-subject --signoff
1249 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1250 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1251 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1252 --output-directory --reroll-count --to= --quiet --notes
1255 _git_format_patch ()
1261 " "" "${cur##--thread=}"
1265 __gitcomp "$__git_format_patch_options"
1269 __git_complete_revlist
1277 --tags --root --unreachable --cache --no-reflogs --full
1278 --strict --verbose --lost-found
1289 __gitcomp "--prune --aggressive"
1300 __git_match_ctag() {
1301 awk "/^${1//\//\\/}/ { print \$1 }" "$2"
1306 __git_has_doubledash && return
1312 --text --ignore-case --word-regexp --invert-match
1313 --full-name --line-number
1314 --extended-regexp --basic-regexp --fixed-strings
1316 --files-with-matches --name-only
1317 --files-without-match
1320 --and --or --not --all-match
1326 case "$cword,$prev" in
1328 if test -r tags; then
1329 __gitcomp_nl "$(__git_match_ctag "$cur" tags)"
1335 __gitcomp_nl "$(__git_refs)"
1342 __gitcomp "--all --info --man --web"
1346 __git_compute_all_commands
1347 __gitcomp "$__git_all_commands $(__git_aliases)
1348 attributes cli core-tutorial cvs-migration
1349 diffcore gitk glossary hooks ignore modules
1350 namespaces repository-layout tutorial tutorial-2
1360 false true umask group all world everybody
1361 " "" "${cur##--shared=}"
1365 __gitcomp "--quiet --bare --template= --shared --shared="
1375 __gitcomp "--cached --deleted --modified --others --ignored
1376 --stage --directory --no-empty-directory --unmerged
1377 --killed --exclude= --exclude-from=
1378 --exclude-per-directory= --exclude-standard
1379 --error-unmatch --with-tree= --full-name
1380 --abbrev --ignored --exclude-per-directory
1386 # XXX ignore options like --modified and always suggest all cached
1388 __git_complete_index_file "--cached"
1393 __gitcomp_nl "$(__git_remotes)"
1401 # Options that go well for log, shortlog and gitk
1402 __git_log_common_options="
1404 --branches --tags --remotes
1405 --first-parent --merges --no-merges
1407 --max-age= --since= --after=
1408 --min-age= --until= --before=
1409 --min-parents= --max-parents=
1410 --no-min-parents --no-max-parents
1412 # Options that go well for log and gitk (not shortlog)
1413 __git_log_gitk_options="
1414 --dense --sparse --full-history
1415 --simplify-merges --simplify-by-decoration
1416 --left-right --notes --no-notes
1418 # Options that go well for log and shortlog (not gitk)
1419 __git_log_shortlog_options="
1420 --author= --committer= --grep=
1421 --all-match --invert-grep
1424 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1425 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1429 __git_has_doubledash && return
1431 local g="$(git rev-parse --git-dir 2>/dev/null)"
1433 if [ -f "$g/MERGE_HEAD" ]; then
1437 --pretty=*|--format=*)
1438 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1443 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1447 __gitcomp "full short no" "" "${cur##--decorate=}"
1452 $__git_log_common_options
1453 $__git_log_shortlog_options
1454 $__git_log_gitk_options
1455 --root --topo-order --date-order --reverse
1456 --follow --full-diff
1457 --abbrev-commit --abbrev=
1458 --relative-date --date=
1459 --pretty= --format= --oneline
1463 --decorate --decorate=
1465 --parents --children
1467 $__git_diff_common_options
1468 --pickaxe-all --pickaxe-regex
1473 __git_complete_revlist
1476 # Common merge options shared by git-merge(1) and git-pull(1).
1477 __git_merge_options="
1478 --no-commit --no-stat --log --no-log --squash --strategy
1479 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1480 --verify-signatures --no-verify-signatures --gpg-sign
1481 --quiet --verbose --progress --no-progress
1486 __git_complete_strategy && return
1490 __gitcomp "$__git_merge_options
1491 --rerere-autoupdate --no-rerere-autoupdate --abort"
1494 __gitcomp_nl "$(__git_refs)"
1501 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1515 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1519 __gitcomp_nl "$(__git_refs)"
1526 __gitcomp "--dry-run"
1531 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1532 # We need to show both cached and untracked files (including
1533 # empty directories) since this may not be the last argument.
1534 __git_complete_index_file "--cached --others --directory"
1536 __git_complete_index_file "--cached"
1542 __gitcomp "--tags --all --stdin"
1547 local subcommands='add append copy edit list prune remove show'
1548 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1550 case "$subcommand,$cur" in
1557 __gitcomp_nl "$(__git_refs)"
1560 __gitcomp "$subcommands --ref"
1564 add,--reuse-message=*|append,--reuse-message=*|\
1565 add,--reedit-message=*|append,--reedit-message=*)
1566 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1569 __gitcomp '--file= --message= --reedit-message=
1576 __gitcomp '--dry-run --verbose'
1585 __gitcomp_nl "$(__git_refs)"
1594 __git_complete_strategy && return
1597 --recurse-submodules=*)
1598 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1603 --rebase --no-rebase
1604 $__git_merge_options
1605 $__git_fetch_options
1610 __git_complete_remote_or_refspec
1613 __git_push_recurse_submodules="check on-demand"
1615 __git_complete_force_with_lease ()
1623 __gitcomp_nl "$(__git_refs)" "" "${cur_#*:}"
1626 __gitcomp_nl "$(__git_refs)" "" "$cur_"
1635 __gitcomp_nl "$(__git_remotes)"
1638 --recurse-submodules)
1639 __gitcomp "$__git_push_recurse_submodules"
1645 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1648 --recurse-submodules=*)
1649 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1652 --force-with-lease=*)
1653 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1658 --all --mirror --tags --dry-run --force --verbose
1659 --quiet --prune --delete --follow-tags
1660 --receive-pack= --repo= --set-upstream
1661 --force-with-lease --force-with-lease= --recurse-submodules=
1666 __git_complete_remote_or_refspec
1671 local dir="$(__gitdir)"
1672 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1673 __gitcomp "--continue --skip --abort"
1676 __git_complete_strategy && return
1679 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1684 --onto --merge --strategy --interactive
1685 --preserve-merges --stat --no-stat
1686 --committer-date-is-author-date --ignore-date
1687 --ignore-whitespace --whitespace=
1688 --autosquash --fork-point --no-fork-point
1694 __gitcomp_nl "$(__git_refs)"
1699 local subcommands="show delete expire"
1700 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1702 if [ -z "$subcommand" ]; then
1703 __gitcomp "$subcommands"
1705 __gitcomp_nl "$(__git_refs)"
1709 __git_send_email_confirm_options="always never auto cc compose"
1710 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1717 $__git_send_email_confirm_options
1718 " "" "${cur##--confirm=}"
1723 $__git_send_email_suppresscc_options
1724 " "" "${cur##--suppress-cc=}"
1728 --smtp-encryption=*)
1729 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1735 " "" "${cur##--thread=}"
1739 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1740 --compose --confirm= --dry-run --envelope-sender
1742 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1743 --no-suppress-from --no-thread --quiet
1744 --signed-off-by-cc --smtp-pass --smtp-server
1745 --smtp-server-port --smtp-encryption= --smtp-user
1746 --subject --suppress-cc= --suppress-from --thread --to
1747 --validate --no-validate
1748 $__git_format_patch_options"
1752 __git_complete_revlist
1760 __git_config_get_set_variables ()
1762 local prevword word config_file= c=$cword
1763 while [ $c -gt 1 ]; do
1766 --system|--global|--local|--file=*)
1771 config_file="$word $prevword"
1779 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1793 branch.*.remote|branch.*.pushremote)
1794 __gitcomp_nl "$(__git_remotes)"
1798 __gitcomp_nl "$(__git_refs)"
1802 __gitcomp "false true"
1806 __gitcomp_nl "$(__git_remotes)"
1810 local remote="${prev#remote.}"
1811 remote="${remote%.fetch}"
1812 if [ -z "$cur" ]; then
1813 __gitcomp_nl "refs/heads/" "" "" ""
1816 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1820 local remote="${prev#remote.}"
1821 remote="${remote%.push}"
1822 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1823 for-each-ref --format='%(refname):%(refname)' \
1827 pull.twohead|pull.octopus)
1828 __git_compute_merge_strategies
1829 __gitcomp "$__git_merge_strategies"
1832 color.branch|color.diff|color.interactive|\
1833 color.showbranch|color.status|color.ui)
1834 __gitcomp "always never auto"
1838 __gitcomp "false true"
1843 normal black red green yellow blue magenta cyan white
1844 bold dim ul blink reverse
1849 __gitcomp "log short"
1853 __gitcomp "man info web html"
1857 __gitcomp "$__git_log_date_formats"
1860 sendemail.aliasesfiletype)
1861 __gitcomp "mutt mailrc pine elm gnus"
1865 __gitcomp "$__git_send_email_confirm_options"
1868 sendemail.suppresscc)
1869 __gitcomp "$__git_send_email_suppresscc_options"
1872 sendemail.transferencoding)
1873 __gitcomp "7bit 8bit quoted-printable base64"
1876 --get|--get-all|--unset|--unset-all)
1877 __gitcomp_nl "$(__git_config_get_set_variables)"
1887 --system --global --local --file=
1888 --list --replace-all
1889 --get --get-all --get-regexp
1890 --add --unset --unset-all
1891 --remove-section --rename-section
1896 local pfx="${cur%.*}." cur_="${cur##*.}"
1897 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1901 local pfx="${cur%.*}." cur_="${cur#*.}"
1902 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1903 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1907 local pfx="${cur%.*}." cur_="${cur##*.}"
1909 argprompt cmd confirm needsfile noconsole norescan
1910 prompt revprompt revunmerged title
1915 local pfx="${cur%.*}." cur_="${cur##*.}"
1916 __gitcomp "cmd path" "$pfx" "$cur_"
1920 local pfx="${cur%.*}." cur_="${cur##*.}"
1921 __gitcomp "cmd path" "$pfx" "$cur_"
1925 local pfx="${cur%.*}." cur_="${cur##*.}"
1926 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1930 local pfx="${cur%.*}." cur_="${cur#*.}"
1931 __git_compute_all_commands
1932 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1936 local pfx="${cur%.*}." cur_="${cur##*.}"
1938 url proxy fetch push mirror skipDefaultUpdate
1939 receivepack uploadpack tagopt pushurl
1944 local pfx="${cur%.*}." cur_="${cur#*.}"
1945 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1946 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1950 local pfx="${cur%.*}." cur_="${cur##*.}"
1951 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1957 advice.commitBeforeMerge
1959 advice.implicitIdentity
1960 advice.pushNonFastForward
1961 advice.resolveConflict
1965 apply.ignorewhitespace
1967 branch.autosetupmerge
1968 branch.autosetuprebase
1972 color.branch.current
1977 color.decorate.branch
1978 color.decorate.remoteBranch
1979 color.decorate.stash
1989 color.diff.whitespace
1994 color.grep.linenumber
1997 color.grep.separator
1999 color.interactive.error
2000 color.interactive.header
2001 color.interactive.help
2002 color.interactive.prompt
2007 color.status.changed
2009 color.status.nobranch
2010 color.status.unmerged
2011 color.status.untracked
2012 color.status.updated
2021 core.bigFileThreshold
2024 core.deltaBaseCacheLimit
2029 core.fsyncobjectfiles
2033 core.logAllRefUpdates
2034 core.loosecompression
2037 core.packedGitWindowSize
2039 core.preferSymlinkRefs
2042 core.repositoryFormatVersion
2044 core.sharedRepository
2048 core.warnAmbiguousRefs
2051 diff.autorefreshindex
2053 diff.ignoreSubmodules
2060 diff.suppressBlankEmpty
2066 fetch.recurseSubmodules
2076 format.subjectprefix
2087 gc.reflogexpireunreachable
2091 gitcvs.commitmsgannotation
2092 gitcvs.dbTableNamePrefix
2103 gui.copyblamethreshold
2107 gui.matchtrackingbranch
2108 gui.newbranchtemplate
2109 gui.pruneduringfetch
2110 gui.spellingdictionary
2126 http.sslCertPasswordProtected
2131 i18n.logOutputEncoding
2137 imap.preformattedHTML
2147 interactive.singlekey
2163 mergetool.keepBackup
2164 mergetool.keepTemporaries
2169 notes.rewrite.rebase
2173 pack.deltaCacheLimit
2190 receive.denyCurrentBranch
2191 receive.denyDeleteCurrent
2193 receive.denyNonFastForwards
2196 receive.updateserverinfo
2199 repack.usedeltabaseoffset
2203 sendemail.aliasesfile
2204 sendemail.aliasfiletype
2208 sendemail.chainreplyto
2210 sendemail.envelopesender
2214 sendemail.signedoffbycc
2215 sendemail.smtpdomain
2216 sendemail.smtpencryption
2218 sendemail.smtpserver
2219 sendemail.smtpserveroption
2220 sendemail.smtpserverport
2222 sendemail.suppresscc
2223 sendemail.suppressfrom
2228 status.relativePaths
2229 status.showUntrackedFiles
2230 status.submodulesummary
2233 transfer.unpackLimit
2245 local subcommands="add rename remove set-head set-branches set-url show prune update"
2246 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2247 if [ -z "$subcommand" ]; then
2248 __gitcomp "$subcommands"
2252 case "$subcommand" in
2253 rename|remove|set-url|show|prune)
2254 __gitcomp_nl "$(__git_remotes)"
2256 set-head|set-branches)
2257 __git_complete_remote_or_refspec
2260 __gitcomp "$(__git_get_config_variables "remotes")"
2269 __gitcomp_nl "$(__git_refs)"
2274 __git_has_doubledash && return
2278 __gitcomp "--merge --mixed --hard --soft --patch"
2282 __gitcomp_nl "$(__git_refs)"
2287 local dir="$(__gitdir)"
2288 if [ -f "$dir"/REVERT_HEAD ]; then
2289 __gitcomp "--continue --quit --abort"
2294 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2298 __gitcomp_nl "$(__git_refs)"
2305 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2310 __git_complete_index_file "--cached"
2315 __git_has_doubledash && return
2320 $__git_log_common_options
2321 $__git_log_shortlog_options
2322 --numbered --summary
2327 __git_complete_revlist
2332 __git_has_doubledash && return
2335 --pretty=*|--format=*)
2336 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2341 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2345 __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)"
2556 --list --delete --verify --annotate --message --file
2557 --sign --cleanup --local-user --force --column --sort
2558 --contains --points-at
2571 local i c=1 command __git_dir
2573 while [ $c -lt $cword ]; do
2576 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2577 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2578 --bare) __git_dir="." ;;
2579 --help) command="help"; break ;;
2580 -c|--work-tree|--namespace) ((c++)) ;;
2582 *) command="$i"; break ;;
2587 if [ -z "$command" ]; then
2602 --no-replace-objects
2606 *) __git_compute_porcelain_commands
2607 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2612 local completion_func="_git_${command//-/_}"
2613 declare -f $completion_func >/dev/null && $completion_func && return
2615 local expansion=$(__git_aliased_command "$command")
2616 if [ -n "$expansion" ]; then
2618 completion_func="_git_${expansion//-/_}"
2619 declare -f $completion_func >/dev/null && $completion_func
2625 __git_has_doubledash && return
2627 local g="$(__gitdir)"
2629 if [ -f "$g/MERGE_HEAD" ]; then
2635 $__git_log_common_options
2636 $__git_log_gitk_options
2642 __git_complete_revlist
2647 local cur words cword prev
2648 _get_comp_words_by_ref -n =: cur words cword prev
2652 # Setup completion for certain functions defined above by setting common
2653 # variables and workarounds.
2654 # This is NOT a public function; use at your own risk.
2657 test -n "$ZSH_VERSION" && return
2658 local wrapper="__git_wrap${2}"
2659 eval "$wrapper () { __git_func_wrap $2 ; }"
2660 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2661 || complete -o default -o nospace -F $wrapper $1
2664 __git_complete git __git_main
2665 __git_complete gitk __gitk_main
2667 # The following are necessary only for Cygwin, and only are needed
2668 # when the user has tab-completed the executable name and consequently
2669 # included the '.exe' suffix.
2671 test "$(uname -o 2>/dev/null)" = "Cygwin" &&
2672 __git_complete git.exe __git_main