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= --staged
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
1757 __git_has_doubledash && return
1759 local subcommands="add reset diff rm apply edit"
1760 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1761 if [ -z "$subcommand" ]; then
1762 __gitcomp "$subcommands"
1766 case "$subcommand" in
1784 __git_config_get_set_variables ()
1786 local prevword word config_file= c=$cword
1787 while [ $c -gt 1 ]; do
1790 --system|--global|--local|--file=*)
1795 config_file="$word $prevword"
1803 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1817 branch.*.remote|branch.*.pushremote)
1818 __gitcomp_nl "$(__git_remotes)"
1822 __gitcomp_nl "$(__git_refs)"
1826 __gitcomp "false true"
1830 __gitcomp_nl "$(__git_remotes)"
1834 local remote="${prev#remote.}"
1835 remote="${remote%.fetch}"
1836 if [ -z "$cur" ]; then
1837 __gitcomp_nl "refs/heads/" "" "" ""
1840 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1844 local remote="${prev#remote.}"
1845 remote="${remote%.push}"
1846 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1847 for-each-ref --format='%(refname):%(refname)' \
1851 pull.twohead|pull.octopus)
1852 __git_compute_merge_strategies
1853 __gitcomp "$__git_merge_strategies"
1856 color.branch|color.diff|color.interactive|\
1857 color.showbranch|color.status|color.ui)
1858 __gitcomp "always never auto"
1862 __gitcomp "false true"
1867 normal black red green yellow blue magenta cyan white
1868 bold dim ul blink reverse
1873 __gitcomp "log short"
1877 __gitcomp "man info web html"
1881 __gitcomp "$__git_log_date_formats"
1884 sendemail.aliasesfiletype)
1885 __gitcomp "mutt mailrc pine elm gnus"
1889 __gitcomp "$__git_send_email_confirm_options"
1892 sendemail.suppresscc)
1893 __gitcomp "$__git_send_email_suppresscc_options"
1896 sendemail.transferencoding)
1897 __gitcomp "7bit 8bit quoted-printable base64"
1900 --get|--get-all|--unset|--unset-all)
1901 __gitcomp_nl "$(__git_config_get_set_variables)"
1911 --system --global --local --file=
1912 --list --replace-all
1913 --get --get-all --get-regexp
1914 --add --unset --unset-all
1915 --remove-section --rename-section
1920 local pfx="${cur%.*}." cur_="${cur##*.}"
1921 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1925 local pfx="${cur%.*}." cur_="${cur#*.}"
1926 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1927 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1931 local pfx="${cur%.*}." cur_="${cur##*.}"
1933 argprompt cmd confirm needsfile noconsole norescan
1934 prompt revprompt revunmerged title
1939 local pfx="${cur%.*}." cur_="${cur##*.}"
1940 __gitcomp "cmd path" "$pfx" "$cur_"
1944 local pfx="${cur%.*}." cur_="${cur##*.}"
1945 __gitcomp "cmd path" "$pfx" "$cur_"
1949 local pfx="${cur%.*}." cur_="${cur##*.}"
1950 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1954 local pfx="${cur%.*}." cur_="${cur#*.}"
1955 __git_compute_all_commands
1956 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1960 local pfx="${cur%.*}." cur_="${cur##*.}"
1962 url proxy fetch push mirror skipDefaultUpdate
1963 receivepack uploadpack tagopt pushurl
1968 local pfx="${cur%.*}." cur_="${cur#*.}"
1969 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1970 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1974 local pfx="${cur%.*}." cur_="${cur##*.}"
1975 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1981 advice.commitBeforeMerge
1983 advice.implicitIdentity
1984 advice.pushNonFastForward
1985 advice.resolveConflict
1989 apply.ignorewhitespace
1991 branch.autosetupmerge
1992 branch.autosetuprebase
1996 color.branch.current
2001 color.decorate.branch
2002 color.decorate.remoteBranch
2003 color.decorate.stash
2013 color.diff.whitespace
2018 color.grep.linenumber
2021 color.grep.separator
2023 color.interactive.error
2024 color.interactive.header
2025 color.interactive.help
2026 color.interactive.prompt
2031 color.status.changed
2033 color.status.nobranch
2034 color.status.unmerged
2035 color.status.untracked
2036 color.status.updated
2045 core.bigFileThreshold
2048 core.deltaBaseCacheLimit
2053 core.fsyncobjectfiles
2057 core.logAllRefUpdates
2058 core.loosecompression
2061 core.packedGitWindowSize
2063 core.preferSymlinkRefs
2066 core.repositoryFormatVersion
2068 core.sharedRepository
2072 core.warnAmbiguousRefs
2075 diff.autorefreshindex
2077 diff.ignoreSubmodules
2084 diff.suppressBlankEmpty
2090 fetch.recurseSubmodules
2100 format.subjectprefix
2111 gc.reflogexpireunreachable
2115 gitcvs.commitmsgannotation
2116 gitcvs.dbTableNamePrefix
2127 gui.copyblamethreshold
2131 gui.matchtrackingbranch
2132 gui.newbranchtemplate
2133 gui.pruneduringfetch
2134 gui.spellingdictionary
2150 http.sslCertPasswordProtected
2155 i18n.logOutputEncoding
2161 imap.preformattedHTML
2171 interactive.singlekey
2187 mergetool.keepBackup
2188 mergetool.keepTemporaries
2193 notes.rewrite.rebase
2197 pack.deltaCacheLimit
2214 receive.denyCurrentBranch
2215 receive.denyDeleteCurrent
2217 receive.denyNonFastForwards
2220 receive.updateserverinfo
2223 repack.usedeltabaseoffset
2227 sendemail.aliasesfile
2228 sendemail.aliasfiletype
2232 sendemail.chainreplyto
2234 sendemail.envelopesender
2238 sendemail.signedoffbycc
2239 sendemail.smtpdomain
2240 sendemail.smtpencryption
2242 sendemail.smtpserver
2243 sendemail.smtpserveroption
2244 sendemail.smtpserverport
2246 sendemail.suppresscc
2247 sendemail.suppressfrom
2252 status.relativePaths
2253 status.showUntrackedFiles
2254 status.submodulesummary
2257 transfer.unpackLimit
2269 local subcommands="add rename remove set-head set-branches set-url show prune update"
2270 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2271 if [ -z "$subcommand" ]; then
2272 __gitcomp "$subcommands"
2276 case "$subcommand" in
2277 rename|remove|set-url|show|prune)
2278 __gitcomp_nl "$(__git_remotes)"
2280 set-head|set-branches)
2281 __git_complete_remote_or_refspec
2284 __gitcomp "$(__git_get_config_variables "remotes")"
2293 __gitcomp_nl "$(__git_refs)"
2298 __git_has_doubledash && return
2302 __gitcomp "--merge --mixed --hard --soft --patch --keep --merge
2303 --stage --no-stage --work --no-work"
2307 __gitcomp_nl "$(__git_refs)"
2312 local dir="$(__gitdir)"
2313 if [ -f "$dir"/REVERT_HEAD ]; then
2314 __gitcomp "--continue --quit --abort"
2319 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2323 __gitcomp_nl "$(__git_refs)"
2330 __gitcomp "--cached --staged --dry-run --ignore-unmatch --quiet"
2335 __git_complete_index_file "--cached"
2340 __git_has_doubledash && return
2345 $__git_log_common_options
2346 $__git_log_shortlog_options
2347 --numbered --summary
2352 __git_complete_revlist
2357 __git_has_doubledash && return
2360 --pretty=*|--format=*)
2361 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2366 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2370 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2372 $__git_diff_common_options
2377 __git_complete_revlist_file
2385 --all --remotes --topo-order --current --more=
2386 --list --independent --merge-base --no-name
2388 --sha1-name --sparse --topics --reflog
2393 __git_complete_revlist
2398 local save_opts='--keep-index --no-keep-index --stage --no-stage --quiet --patch'
2399 local subcommands='save list show apply clear drop pop create branch'
2400 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2401 if [ -z "$subcommand" ]; then
2404 __gitcomp "$save_opts"
2407 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2408 __gitcomp "$subcommands"
2413 case "$subcommand,$cur" in
2415 __gitcomp "$save_opts"
2418 __gitcomp "--index --stage --quiet"
2420 show,--*|drop,--*|branch,--*)
2422 show,*|apply,*|drop,*|pop,*|branch,*)
2423 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2424 | sed -n -e 's/:.*//p')"
2434 __git_has_doubledash && return
2436 local subcommands="add status init deinit update summary foreach sync"
2437 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2440 __gitcomp "--quiet --cached"
2443 __gitcomp "$subcommands"
2453 init fetch clone rebase dcommit log find-rev
2454 set-tree commit-diff info create-ignore propget
2455 proplist show-ignore show-externals branch tag blame
2456 migrate mkdirs reset gc
2458 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2459 if [ -z "$subcommand" ]; then
2460 __gitcomp "$subcommands"
2462 local remote_opts="--username= --config-dir= --no-auth-cache"
2464 --follow-parent --authors-file= --repack=
2465 --no-metadata --use-svm-props --use-svnsync-props
2466 --log-window-size= --no-checkout --quiet
2467 --repack-flags --use-log-author --localtime
2468 --ignore-paths= --include-paths= $remote_opts
2471 --template= --shared= --trunk= --tags=
2472 --branches= --stdlayout --minimize-url
2473 --no-metadata --use-svm-props --use-svnsync-props
2474 --rewrite-root= --prefix= --use-log-author
2475 --add-author-from $remote_opts
2478 --edit --rmdir --find-copies-harder --copy-similarity=
2481 case "$subcommand,$cur" in
2483 __gitcomp "--revision= --fetch-all $fc_opts"
2486 __gitcomp "--revision= $fc_opts $init_opts"
2489 __gitcomp "$init_opts"
2493 --merge --strategy= --verbose --dry-run
2494 --fetch-all --no-rebase --commit-url
2495 --revision --interactive $cmt_opts $fc_opts
2499 __gitcomp "--stdin $cmt_opts $fc_opts"
2501 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2502 show-externals,--*|mkdirs,--*)
2503 __gitcomp "--revision="
2507 --limit= --revision= --verbose --incremental
2508 --oneline --show-commit --non-recursive
2509 --authors-file= --color
2514 --merge --verbose --strategy= --local
2515 --fetch-all --dry-run $fc_opts
2519 __gitcomp "--message= --file= --revision= $cmt_opts"
2525 __gitcomp "--dry-run --message --tag"
2528 __gitcomp "--dry-run --message"
2531 __gitcomp "--git-format"
2535 --config-dir= --ignore-paths= --minimize
2536 --no-auth-cache --username=
2540 __gitcomp "--revision= --parent"
2551 while [ $c -lt $cword ]; do
2555 __gitcomp_nl "$(__git_tags)"
2570 __gitcomp_nl "$(__git_tags)"
2574 __gitcomp_nl "$(__git_refs)"
2581 --list --delete --verify --annotate --message --file
2582 --sign --cleanup --local-user --force --column --sort
2583 --contains --points-at
2596 local i c=1 command __git_dir
2598 while [ $c -lt $cword ]; do
2601 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2602 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2603 --bare) __git_dir="." ;;
2604 --help) command="help"; break ;;
2605 -c|--work-tree|--namespace) ((c++)) ;;
2607 *) command="$i"; break ;;
2612 if [ -z "$command" ]; then
2627 --no-replace-objects
2631 *) __git_compute_porcelain_commands
2632 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2637 local completion_func="_git_${command//-/_}"
2638 declare -f $completion_func >/dev/null && $completion_func && return
2640 local expansion=$(__git_aliased_command "$command")
2641 if [ -n "$expansion" ]; then
2643 completion_func="_git_${expansion//-/_}"
2644 declare -f $completion_func >/dev/null && $completion_func
2650 __git_has_doubledash && return
2652 local g="$(__gitdir)"
2654 if [ -f "$g/MERGE_HEAD" ]; then
2660 $__git_log_common_options
2661 $__git_log_gitk_options
2667 __git_complete_revlist
2672 local cur words cword prev
2673 _get_comp_words_by_ref -n =: cur words cword prev
2677 # Setup completion for certain functions defined above by setting common
2678 # variables and workarounds.
2679 # This is NOT a public function; use at your own risk.
2682 test -n "$ZSH_VERSION" && return
2683 local wrapper="__git_wrap${2}"
2684 eval "$wrapper () { __git_func_wrap $2 ; }"
2685 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2686 || complete -o default -o nospace -F $wrapper $1
2689 __git_complete git __git_main
2690 __git_complete gitk __gitk_main
2692 # The following are necessary only for Cygwin, and only are needed
2693 # when the user has tab-completed the executable name and consequently
2694 # included the '.exe' suffix.
2696 test "$(uname -o 2>/dev/null)" = "Cygwin" &&
2697 __git_complete git.exe __git_main