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 # *) git email aliases for git-send-email
14 # *) tree paths within 'ref:path/to/file' expressions
15 # *) file paths within current working directory and index
16 # *) common --long-options
18 # To use these routines:
20 # 1) Copy this file to somewhere (e.g. ~/.git-completion.bash).
21 # 2) Add the following line to your .bashrc/.zshrc:
22 # source ~/.git-completion.bash
23 # 3) Consider changing your PS1 to also show the current branch,
24 # see git-prompt.sh for details.
26 # If you use complex aliases of form '!f() { ... }; f', you can use the null
27 # command ':' as the first command in the function body to declare the desired
28 # completion style. For example '!f() { : git commit ; ... }; f' will
29 # tell the completion to use commit completion. This also works with aliases
30 # of form "!sh -c '...'". For example, "!sh -c ': git commit ; ... '".
32 # Compatible with bash 3.2.57.
34 # You can set the following environment variables to influence the behavior of
35 # the completion routines:
37 # GIT_COMPLETION_CHECKOUT_NO_GUESS
39 # When set to "1", do not include "DWIM" suggestions in git-checkout
40 # completion (e.g., completing "foo" when "origin/foo" exists).
42 case "$COMP_WORDBREAKS" in
44 *) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
47 # Discovers the path to the git repository taking any '--git-dir=<path>' and
48 # '-C <path>' options into account and stores it in the $__git_repo_path
50 __git_find_repo_path ()
52 if [ -n "$__git_repo_path" ]; then
53 # we already know where it is
57 if [ -n "${__git_C_args-}" ]; then
58 __git_repo_path="$(git "${__git_C_args[@]}" \
59 ${__git_dir:+--git-dir="$__git_dir"} \
60 rev-parse --absolute-git-dir 2>/dev/null)"
61 elif [ -n "${__git_dir-}" ]; then
62 test -d "$__git_dir" &&
63 __git_repo_path="$__git_dir"
64 elif [ -n "${GIT_DIR-}" ]; then
65 test -d "${GIT_DIR-}" &&
66 __git_repo_path="$GIT_DIR"
67 elif [ -d .git ]; then
70 __git_repo_path="$(git rev-parse --git-dir 2>/dev/null)"
74 # Deprecated: use __git_find_repo_path() and $__git_repo_path instead
75 # __gitdir accepts 0 or 1 arguments (i.e., location)
76 # returns location of .git repo
79 if [ -z "${1-}" ]; then
80 __git_find_repo_path || return 1
81 echo "$__git_repo_path"
82 elif [ -d "$1/.git" ]; then
89 # Runs git with all the options given as argument, respecting any
90 # '--git-dir=<path>' and '-C <path>' options present on the command line
93 git ${__git_C_args:+"${__git_C_args[@]}"} \
94 ${__git_dir:+--git-dir="$__git_dir"} "$@" 2>/dev/null
97 # The following function is based on code from:
99 # bash_completion - programmable completion functions for bash 3.2+
101 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
102 # © 2009-2010, Bash Completion Maintainers
103 # <bash-completion-devel@lists.alioth.debian.org>
105 # This program is free software; you can redistribute it and/or modify
106 # it under the terms of the GNU General Public License as published by
107 # the Free Software Foundation; either version 2, or (at your option)
110 # This program is distributed in the hope that it will be useful,
111 # but WITHOUT ANY WARRANTY; without even the implied warranty of
112 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
113 # GNU General Public License for more details.
115 # You should have received a copy of the GNU General Public License
116 # along with this program; if not, see <http://www.gnu.org/licenses/>.
118 # The latest version of this software can be obtained here:
120 # http://bash-completion.alioth.debian.org/
124 # This function can be used to access a tokenized list of words
125 # on the command line:
127 # __git_reassemble_comp_words_by_ref '=:'
128 # if test "${words_[cword_-1]}" = -w
133 # The argument should be a collection of characters from the list of
134 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
137 # This is roughly equivalent to going back in time and setting
138 # COMP_WORDBREAKS to exclude those characters. The intent is to
139 # make option types like --date=<type> and <rev>:<path> easy to
140 # recognize by treating each shell word as a single token.
142 # It is best not to set COMP_WORDBREAKS directly because the value is
143 # shared with other completion scripts. By the time the completion
144 # function gets called, COMP_WORDS has already been populated so local
145 # changes to COMP_WORDBREAKS have no effect.
147 # Output: words_, cword_, cur_.
149 __git_reassemble_comp_words_by_ref()
151 local exclude i j first
152 # Which word separators to exclude?
153 exclude="${1//[^$COMP_WORDBREAKS]}"
155 if [ -z "$exclude" ]; then
156 words_=("${COMP_WORDS[@]}")
159 # List of word completion separators has shrunk;
160 # re-assemble words to complete.
161 for ((i=0, j=0; i < ${#COMP_WORDS[@]}; i++, j++)); do
162 # Append each nonempty word consisting of just
163 # word separator characters to the current word.
167 [ -n "${COMP_WORDS[$i]}" ] &&
168 # word consists of excluded word separators
169 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
171 # Attach to the previous token,
172 # unless the previous token is the command name.
173 if [ $j -ge 2 ] && [ -n "$first" ]; then
177 words_[$j]=${words_[j]}${COMP_WORDS[i]}
178 if [ $i = $COMP_CWORD ]; then
181 if (($i < ${#COMP_WORDS[@]} - 1)); then
188 words_[$j]=${words_[j]}${COMP_WORDS[i]}
189 if [ $i = $COMP_CWORD ]; then
195 if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
196 _get_comp_words_by_ref ()
198 local exclude cur_ words_ cword_
199 if [ "$1" = "-n" ]; then
203 __git_reassemble_comp_words_by_ref "$exclude"
204 cur_=${words_[cword_]}
205 while [ $# -gt 0 ]; do
211 prev=${words_[$cword_-1]}
214 words=("${words_[@]}")
225 # Fills the COMPREPLY array with prefiltered words without any additional
227 # Callers must take care of providing only words that match the current word
228 # to be completed and adding any prefix and/or suffix (trailing space!), if
230 # 1: List of newline-separated matching completion words, complete with
241 local x i=${#COMPREPLY[@]}
243 if [[ "$x" == "$3"* ]]; then
244 COMPREPLY[i++]="$2$x$4"
255 # Generates completion reply, appending a space to possible completion words,
257 # It accepts 1 to 4 arguments:
258 # 1: List of possible completion words.
259 # 2: A prefix to be added to each possible completion word (optional).
260 # 3: Generate possible completion matches for this word (optional).
261 # 4: A suffix to be appended to each possible completion word (optional).
264 local cur_="${3-$cur}"
270 local c i=0 IFS=$' \t\n'
273 if [[ $c == "$cur_"* ]]; then
278 COMPREPLY[i++]="${2-}$c"
285 # Clear the variables caching builtins' options when (re-)sourcing
286 # the completion script.
287 unset $(set |sed -ne 's/^\(__gitcomp_builtin_[a-zA-Z0-9_][a-zA-Z0-9_]*\)=.*/\1/p') 2>/dev/null
289 # This function is equivalent to
291 # __gitcomp "$(git xxx --git-completion-helper) ..."
293 # except that the output is cached. Accept 1-3 arguments:
294 # 1: the git command to execute, this is also the cache key
295 # 2: extra options to be added on top (e.g. negative forms)
296 # 3: options to be excluded
299 # spaces must be replaced with underscore for multi-word
300 # commands, e.g. "git remote add" becomes remote_add.
305 local var=__gitcomp_builtin_"${cmd/-/_}"
307 eval "options=\$$var"
309 if [ -z "$options" ]; then
310 # leading and trailing spaces are significant to make
311 # option removal work correctly.
312 options=" $(__git ${cmd/_/ } --git-completion-helper) $incl "
314 options="${options/ $i / }"
316 eval "$var=\"$options\""
322 # Variation of __gitcomp_nl () that appends to the existing list of
323 # completion candidates, COMPREPLY.
324 __gitcomp_nl_append ()
327 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
330 # Generates completion reply from newline-separated possible completion words
331 # by appending a space to all of them.
332 # It accepts 1 to 4 arguments:
333 # 1: List of possible completion words, separated by a single newline.
334 # 2: A prefix to be added to each possible completion word (optional).
335 # 3: Generate possible completion matches for this word (optional).
336 # 4: A suffix to be appended to each possible completion word instead of
337 # the default space (optional). If specified but empty, nothing is
342 __gitcomp_nl_append "$@"
345 # Generates completion reply with compgen from newline-separated possible
346 # completion filenames.
347 # It accepts 1 to 3 arguments:
348 # 1: List of possible completion filenames, separated by a single newline.
349 # 2: A directory prefix to be added to each possible completion filename
351 # 3: Generate possible completion matches for this word (optional).
356 # XXX does not work when the directory prefix contains a tilde,
357 # since tilde expansion is not applied.
358 # This means that COMPREPLY will be empty and Bash default
359 # completion will be used.
360 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
362 # use a hack to enable file mode in bash < 4
363 compopt -o filenames +o nospace 2>/dev/null ||
364 compgen -f /non-existing-dir/ > /dev/null
367 # Execute 'git ls-files', unless the --committable option is specified, in
368 # which case it runs 'git diff-index' to find out the files that can be
369 # committed. It return paths relative to the directory specified in the first
370 # argument, and using the options specified in the second argument.
371 __git_ls_files_helper ()
373 if [ "$2" == "--committable" ]; then
374 __git -C "$1" diff-index --name-only --relative HEAD
376 # NOTE: $2 is not quoted in order to support multiple options
377 __git -C "$1" ls-files --exclude-standard $2
382 # __git_index_files accepts 1 or 2 arguments:
383 # 1: Options to pass to ls-files (required).
384 # 2: A directory path (optional).
385 # If provided, only files within the specified directory are listed.
386 # Sub directories are never recursed. Path must have a trailing
390 local root="${2-.}" file
392 __git_ls_files_helper "$root" "$1" |
393 cut -f1 -d/ | sort | uniq
396 # Lists branches from the local repository.
397 # 1: A prefix to be added to each listed branch (optional).
398 # 2: List only branches matching this word (optional; list all branches if
400 # 3: A suffix to be appended to each listed branch (optional).
403 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
405 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
406 "refs/heads/$cur_*" "refs/heads/$cur_*/**"
409 # Lists tags from the local repository.
410 # Accepts the same positional parameters as __git_heads() above.
413 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
415 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
416 "refs/tags/$cur_*" "refs/tags/$cur_*/**"
419 # Lists refs from the local (by default) or from a remote repository.
420 # It accepts 0, 1 or 2 arguments:
421 # 1: The remote to list refs from (optional; ignored, if set but empty).
422 # Can be the name of a configured remote, a path, or a URL.
423 # 2: In addition to local refs, list unique branches from refs/remotes/ for
424 # 'git checkout's tracking DWIMery (optional; ignored, if set but empty).
425 # 3: A prefix to be added to each listed ref (optional).
426 # 4: List only refs matching this word (optional; list all refs if unset or
428 # 5: A suffix to be appended to each listed ref (optional; ignored, if set
431 # Use __git_complete_refs() instead.
434 local i hash dir track="${2-}"
435 local list_refs_from=path remote="${1-}"
437 local pfx="${3-}" cur_="${4-$cur}" sfx="${5-}"
439 local fer_pfx="${pfx//\%/%%}" # "escape" for-each-ref format specifiers
442 dir="$__git_repo_path"
444 if [ -z "$remote" ]; then
445 if [ -z "$dir" ]; then
449 if __git_is_configured_remote "$remote"; then
450 # configured remote takes precedence over a
451 # local directory with the same name
452 list_refs_from=remote
453 elif [ -d "$remote/.git" ]; then
455 elif [ -d "$remote" ]; then
462 if [ "$list_refs_from" = path ]; then
463 if [[ "$cur_" == ^* ]]; then
472 refs=("$match*" "$match*/**")
476 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD REBASE_HEAD; do
479 if [ -e "$dir/$i" ]; then
485 format="refname:strip=2"
486 refs=("refs/tags/$match*" "refs/tags/$match*/**"
487 "refs/heads/$match*" "refs/heads/$match*/**"
488 "refs/remotes/$match*" "refs/remotes/$match*/**")
491 __git_dir="$dir" __git for-each-ref --format="$fer_pfx%($format)$sfx" \
493 if [ -n "$track" ]; then
494 # employ the heuristic used by git checkout
495 # Try to find a remote branch that matches the completion word
496 # but only output if the branch name is unique
497 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
498 --sort="refname:strip=3" \
499 "refs/remotes/*/$match*" "refs/remotes/*/$match*/**" | \
506 __git ls-remote "$remote" "$match*" | \
507 while read -r hash i; do
510 *) echo "$pfx$i$sfx" ;;
515 if [ "$list_refs_from" = remote ]; then
517 $match*) echo "${pfx}HEAD$sfx" ;;
519 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
520 "refs/remotes/$remote/$match*" \
521 "refs/remotes/$remote/$match*/**"
525 $match*) query_symref="HEAD" ;;
527 __git ls-remote "$remote" $query_symref \
528 "refs/tags/$match*" "refs/heads/$match*" \
529 "refs/remotes/$match*" |
530 while read -r hash i; do
533 refs/*) echo "$pfx${i#refs/*/}$sfx" ;;
534 *) echo "$pfx$i$sfx" ;; # symbolic refs
542 # Completes refs, short and long, local and remote, symbolic and pseudo.
544 # Usage: __git_complete_refs [<option>]...
545 # --remote=<remote>: The remote to list refs from, can be the name of a
546 # configured remote, a path, or a URL.
547 # --track: List unique remote branches for 'git checkout's tracking DWIMery.
548 # --pfx=<prefix>: A prefix to be added to each ref.
549 # --cur=<word>: The current ref to be completed. Defaults to the current
550 # word to be completed.
551 # --sfx=<suffix>: A suffix to be appended to each ref instead of the default
553 __git_complete_refs ()
555 local remote track pfx cur_="$cur" sfx=" "
557 while test $# != 0; do
559 --remote=*) remote="${1##--remote=}" ;;
560 --track) track="yes" ;;
561 --pfx=*) pfx="${1##--pfx=}" ;;
562 --cur=*) cur_="${1##--cur=}" ;;
563 --sfx=*) sfx="${1##--sfx=}" ;;
569 __gitcomp_direct "$(__git_refs "$remote" "$track" "$pfx" "$cur_" "$sfx")"
572 # __git_refs2 requires 1 argument (to pass to __git_refs)
573 # Deprecated: use __git_complete_fetch_refspecs() instead.
577 for i in $(__git_refs "$1"); do
582 # Completes refspecs for fetching from a remote repository.
583 # 1: The remote repository.
584 # 2: A prefix to be added to each listed refspec (optional).
585 # 3: The ref to be completed as a refspec instead of the current word to be
586 # completed (optional)
587 # 4: A suffix to be appended to each listed refspec instead of the default
589 __git_complete_fetch_refspecs ()
591 local i remote="$1" pfx="${2-}" cur_="${3-$cur}" sfx="${4- }"
594 for i in $(__git_refs "$remote" "" "" "$cur_") ; do
600 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
601 __git_refs_remotes ()
604 __git ls-remote "$1" 'refs/heads/*' | \
605 while read -r hash i; do
606 echo "$i:refs/remotes/$1/${i#refs/heads/}"
613 test -d "$__git_repo_path/remotes" && ls -1 "$__git_repo_path/remotes"
617 # Returns true if $1 matches the name of a configured remote, false otherwise.
618 __git_is_configured_remote ()
621 for remote in $(__git_remotes); do
622 if [ "$remote" = "$1" ]; then
629 __git_list_merge_strategies ()
631 LANG=C LC_ALL=C git merge -s help 2>&1 |
632 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
641 __git_merge_strategies=
642 # 'git merge -s help' (and thus detection of the merge strategy
643 # list) fails, unfortunately, if run outside of any git working
644 # tree. __git_merge_strategies is set to the empty string in
645 # that case, and the detection will be repeated the next time it
647 __git_compute_merge_strategies ()
649 test -n "$__git_merge_strategies" ||
650 __git_merge_strategies=$(__git_list_merge_strategies)
653 __git_complete_revlist_file ()
655 local pfx ls ref cur_="$cur"
675 case "$COMP_WORDBREAKS" in
677 *) pfx="$ref:$pfx" ;;
680 __gitcomp_nl "$(__git ls-tree "$ls" \
681 | sed '/^100... blob /{
697 pfx="${cur_%...*}..."
699 __git_complete_refs --pfx="$pfx" --cur="$cur_"
704 __git_complete_refs --pfx="$pfx" --cur="$cur_"
713 # __git_complete_index_file requires 1 argument:
714 # 1: the options to pass to ls-file
716 # The exception is --committable, which finds the files appropriate commit.
717 __git_complete_index_file ()
719 local pfx="" cur_="$cur"
729 __gitcomp_file "$(__git_index_files "$1" ${pfx:+"$pfx"})" "$pfx" "$cur_"
732 __git_complete_file ()
734 __git_complete_revlist_file
737 __git_complete_revlist ()
739 __git_complete_revlist_file
742 __git_complete_remote_or_refspec ()
744 local cur_="$cur" cmd="${words[1]}"
745 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
746 if [ "$cmd" = "remote" ]; then
749 while [ $c -lt $cword ]; do
752 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
753 -d|--delete) [ "$cmd" = "push" ] && lhs=0 ;;
756 push) no_complete_refspec=1 ;;
764 *) remote="$i"; break ;;
768 if [ -z "$remote" ]; then
769 __gitcomp_nl "$(__git_remotes)"
772 if [ $no_complete_refspec = 1 ]; then
775 [ "$remote" = "." ] && remote=
778 case "$COMP_WORDBREAKS" in
780 *) pfx="${cur_%%:*}:" ;;
792 if [ $lhs = 1 ]; then
793 __git_complete_fetch_refspecs "$remote" "$pfx" "$cur_"
795 __git_complete_refs --pfx="$pfx" --cur="$cur_"
799 if [ $lhs = 1 ]; then
800 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
802 __git_complete_refs --pfx="$pfx" --cur="$cur_"
806 if [ $lhs = 1 ]; then
807 __git_complete_refs --pfx="$pfx" --cur="$cur_"
809 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
815 __git_complete_strategy ()
817 __git_compute_merge_strategies
820 __gitcomp "$__git_merge_strategies"
825 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
833 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
835 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
837 git help -a|egrep '^ [a-zA-Z0-9]'
841 __git_list_all_commands ()
844 for i in $(__git_commands)
847 *--*) : helper pattern;;
854 __git_compute_all_commands ()
856 test -n "$__git_all_commands" ||
857 __git_all_commands=$(__git_list_all_commands)
860 __git_list_porcelain_commands ()
863 __git_compute_all_commands
864 for i in $__git_all_commands
867 *--*) : helper pattern;;
868 applymbox) : ask gittus;;
869 applypatch) : ask gittus;;
870 archimport) : import;;
871 cat-file) : plumbing;;
872 check-attr) : plumbing;;
873 check-ignore) : plumbing;;
874 check-mailmap) : plumbing;;
875 check-ref-format) : plumbing;;
876 checkout-index) : plumbing;;
877 column) : internal helper;;
878 commit-graph) : plumbing;;
879 commit-tree) : plumbing;;
880 count-objects) : infrequent;;
881 credential) : credentials;;
882 credential-*) : credentials helper;;
883 cvsexportcommit) : export;;
884 cvsimport) : import;;
885 cvsserver) : daemon;;
887 diff-files) : plumbing;;
888 diff-index) : plumbing;;
889 diff-tree) : plumbing;;
890 fast-import) : import;;
891 fast-export) : export;;
892 fsck-objects) : plumbing;;
893 fetch-pack) : plumbing;;
894 fmt-merge-msg) : plumbing;;
895 for-each-ref) : plumbing;;
896 hash-object) : plumbing;;
897 http-*) : transport;;
898 index-pack) : plumbing;;
899 init-db) : deprecated;;
900 local-fetch) : plumbing;;
901 ls-files) : plumbing;;
902 ls-remote) : plumbing;;
903 ls-tree) : plumbing;;
904 mailinfo) : plumbing;;
905 mailsplit) : plumbing;;
906 merge-*) : plumbing;;
909 pack-objects) : plumbing;;
910 pack-redundant) : plumbing;;
911 pack-refs) : plumbing;;
912 parse-remote) : plumbing;;
913 patch-id) : plumbing;;
915 prune-packed) : plumbing;;
916 quiltimport) : import;;
917 read-tree) : plumbing;;
918 receive-pack) : plumbing;;
919 remote-*) : transport;;
921 rev-list) : plumbing;;
922 rev-parse) : plumbing;;
923 runstatus) : plumbing;;
924 sh-setup) : internal;;
926 show-ref) : plumbing;;
927 send-pack) : plumbing;;
928 show-index) : plumbing;;
930 stripspace) : plumbing;;
931 symbolic-ref) : plumbing;;
932 unpack-file) : plumbing;;
933 unpack-objects) : plumbing;;
934 update-index) : plumbing;;
935 update-ref) : plumbing;;
936 update-server-info) : daemon;;
937 upload-archive) : plumbing;;
938 upload-pack) : plumbing;;
939 write-tree) : plumbing;;
941 verify-pack) : infrequent;;
942 verify-tag) : plumbing;;
948 __git_porcelain_commands=
949 __git_compute_porcelain_commands ()
951 test -n "$__git_porcelain_commands" ||
952 __git_porcelain_commands=$(__git_list_porcelain_commands)
955 # Lists all set config variables starting with the given section prefix,
956 # with the prefix removed.
957 __git_get_config_variables ()
959 local section="$1" i IFS=$'\n'
960 for i in $(__git config --name-only --get-regexp "^$section\..*"); do
961 echo "${i#$section.}"
965 __git_pretty_aliases ()
967 __git_get_config_variables "pretty"
972 __git_get_config_variables "alias"
975 # __git_aliased_command requires 1 argument
976 __git_aliased_command ()
978 local word cmdline=$(__git config --get "alias.$1")
979 for word in $cmdline; do
985 \!*) : shell command alias ;;
987 *=*) : setting env ;;
989 \(\)) : skip parens of shell function definition ;;
990 {) : skip start of shell helper function ;;
991 :) : skip null command ;;
992 \'*) : skip opening quote after sh -c ;;
1000 # __git_find_on_cmdline requires 1 argument
1001 __git_find_on_cmdline ()
1003 local word subcommand c=1
1004 while [ $c -lt $cword ]; do
1006 for subcommand in $1; do
1007 if [ "$subcommand" = "$word" ]; then
1016 # Echo the value of an option set on the command line or config
1018 # $1: short option name
1019 # $2: long option name including =
1020 # $3: list of possible values
1021 # $4: config string (optional)
1024 # result="$(__git_get_option_value "-d" "--do-something=" \
1025 # "yes no" "core.doSomething")"
1027 # result is then either empty (no option set) or "yes" or "no"
1029 # __git_get_option_value requires 3 arguments
1030 __git_get_option_value ()
1032 local c short_opt long_opt val
1033 local result= values config_key word
1041 while [ $c -ge 0 ]; do
1043 for val in $values; do
1044 if [ "$short_opt$val" = "$word" ] ||
1045 [ "$long_opt$val" = "$word" ]; then
1053 if [ -n "$config_key" ] && [ -z "$result" ]; then
1054 result="$(__git config "$config_key")"
1060 __git_has_doubledash ()
1063 while [ $c -lt $cword ]; do
1064 if [ "--" = "${words[c]}" ]; then
1072 # Try to count non option arguments passed on the command line for the
1073 # specified git command.
1074 # When options are used, it is necessary to use the special -- option to
1075 # tell the implementation were non option arguments begin.
1076 # XXX this can not be improved, since options can appear everywhere, as
1080 # __git_count_arguments requires 1 argument: the git command executed.
1081 __git_count_arguments ()
1085 # Skip "git" (first argument)
1086 for ((i=1; i < ${#words[@]}; i++)); do
1091 # Good; we can assume that the following are only non
1096 # Skip the specified git command and discard git
1109 __git_whitespacelist="nowarn warn error error-all fix"
1110 __git_am_inprogress_options="--skip --continue --resolved --abort --quit --show-current-patch"
1114 __git_find_repo_path
1115 if [ -d "$__git_repo_path"/rebase-apply ]; then
1116 __gitcomp "$__git_am_inprogress_options"
1121 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1125 __gitcomp_builtin am "--no-utf8" \
1126 "$__git_am_inprogress_options"
1135 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1139 __gitcomp_builtin apply
1148 __gitcomp_builtin add
1152 local complete_opt="--others --modified --directory --no-empty-directory"
1153 if test -n "$(__git_find_on_cmdline "-u --update")"
1155 complete_opt="--modified"
1157 __git_complete_index_file "$complete_opt"
1164 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
1168 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
1173 --format= --list --verbose
1174 --prefix= --remote= --exec= --output
1184 __git_has_doubledash && return
1186 local subcommands="start bad good skip reset visualize replay log run"
1187 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1188 if [ -z "$subcommand" ]; then
1189 __git_find_repo_path
1190 if [ -f "$__git_repo_path"/BISECT_START ]; then
1191 __gitcomp "$subcommands"
1193 __gitcomp "replay start"
1198 case "$subcommand" in
1199 bad|good|reset|skip|start)
1209 local i c=1 only_local_ref="n" has_r="n"
1211 while [ $c -lt $cword ]; do
1214 -d|--delete|-m|--move) only_local_ref="y" ;;
1215 -r|--remotes) has_r="y" ;;
1221 --set-upstream-to=*)
1222 __git_complete_refs --cur="${cur##--set-upstream-to=}"
1225 __gitcomp_builtin branch "--no-color --no-abbrev
1226 --no-track --no-column
1230 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
1231 __gitcomp_direct "$(__git_heads "" "$cur" " ")"
1241 local cmd="${words[2]}"
1244 __gitcomp "create list-heads verify unbundle"
1247 # looking for a file
1252 __git_complete_revlist
1261 __git_has_doubledash && return
1265 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1268 __gitcomp_builtin checkout "--no-track --no-recurse-submodules"
1271 # check if --track, --no-track, or --no-guess was specified
1272 # if so, disable DWIM mode
1273 local flags="--track --no-track --no-guess" track_opt="--track"
1274 if [ "$GIT_COMPLETION_CHECKOUT_NO_GUESS" = "1" ] ||
1275 [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1278 __git_complete_refs $track_opt
1287 __gitcomp_builtin cherry
1294 __git_cherry_pick_inprogress_options="--continue --quit --abort"
1298 __git_find_repo_path
1299 if [ -f "$__git_repo_path"/CHERRY_PICK_HEAD ]; then
1300 __gitcomp "$__git_cherry_pick_inprogress_options"
1305 __gitcomp_builtin cherry-pick "" \
1306 "$__git_cherry_pick_inprogress_options"
1318 __gitcomp_builtin clean
1323 # XXX should we check for -x option ?
1324 __git_complete_index_file "--others --directory"
1331 __gitcomp_builtin clone "--no-single-branch"
1337 __git_untracked_file_modes="all no normal"
1350 __gitcomp "default scissors strip verbatim whitespace
1351 " "" "${cur##--cleanup=}"
1354 --reuse-message=*|--reedit-message=*|\
1355 --fixup=*|--squash=*)
1356 __git_complete_refs --cur="${cur#*=}"
1359 --untracked-files=*)
1360 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
1364 __gitcomp_builtin commit "--no-edit --verify"
1368 if __git rev-parse --verify --quiet HEAD >/dev/null; then
1369 __git_complete_index_file "--committable"
1371 # This is the first commit
1372 __git_complete_index_file "--cached"
1380 __gitcomp_builtin describe
1386 __git_diff_algorithms="myers minimal patience histogram"
1388 __git_diff_submodule_formats="diff log short"
1390 __git_diff_common_options="--stat --numstat --shortstat --summary
1391 --patch-with-stat --name-only --name-status --color
1392 --no-color --color-words --no-renames --check
1393 --full-index --binary --abbrev --diff-filter=
1394 --find-copies-harder --ignore-cr-at-eol
1395 --text --ignore-space-at-eol --ignore-space-change
1396 --ignore-all-space --ignore-blank-lines --exit-code
1397 --quiet --ext-diff --no-ext-diff
1398 --no-prefix --src-prefix= --dst-prefix=
1399 --inter-hunk-context=
1400 --patience --histogram --minimal
1401 --raw --word-diff --word-diff-regex=
1402 --dirstat --dirstat= --dirstat-by-file
1403 --dirstat-by-file= --cumulative
1405 --submodule --submodule= --ignore-submodules
1410 __git_has_doubledash && return
1414 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1418 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1422 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1423 --base --ours --theirs --no-index
1424 $__git_diff_common_options
1429 __git_complete_revlist_file
1432 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1433 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc codecompare
1438 __git_has_doubledash && return
1442 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1446 __gitcomp_builtin difftool "$__git_diff_common_options
1447 --base --cached --ours --theirs
1448 --pickaxe-all --pickaxe-regex
1454 __git_complete_revlist_file
1457 __git_fetch_recurse_submodules="yes on-demand no"
1462 --recurse-submodules=*)
1463 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1467 __gitcomp_builtin fetch "--no-tags"
1471 __git_complete_remote_or_refspec
1474 __git_format_patch_options="
1475 --stdout --attach --no-attach --thread --thread= --no-thread
1476 --numbered --start-number --numbered-files --keep-subject --signoff
1477 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1478 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1479 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1480 --output-directory --reroll-count --to= --quiet --notes
1483 _git_format_patch ()
1489 " "" "${cur##--thread=}"
1493 __gitcomp "$__git_format_patch_options"
1497 __git_complete_revlist
1504 __gitcomp_builtin fsck "--no-reflogs"
1515 # Lists matching symbol names from a tag (as in ctags) file.
1516 # 1: List symbol names matching this word.
1517 # 2: The tag file to list symbol names from.
1518 # 3: A prefix to be added to each listed symbol name (optional).
1519 # 4: A suffix to be appended to each listed symbol name (optional).
1520 __git_match_ctag () {
1521 awk -v pfx="${3-}" -v sfx="${4-}" "
1522 /^${1//\//\\/}/ { print pfx \$1 sfx }
1526 # Complete symbol names from a tag file.
1527 # Usage: __git_complete_symbol [<option>]...
1528 # --tags=<file>: The tag file to list symbol names from instead of the
1530 # --pfx=<prefix>: A prefix to be added to each symbol name.
1531 # --cur=<word>: The current symbol name to be completed. Defaults to
1532 # the current word to be completed.
1533 # --sfx=<suffix>: A suffix to be appended to each symbol name instead
1534 # of the default space.
1535 __git_complete_symbol () {
1536 local tags=tags pfx="" cur_="${cur-}" sfx=" "
1538 while test $# != 0; do
1540 --tags=*) tags="${1##--tags=}" ;;
1541 --pfx=*) pfx="${1##--pfx=}" ;;
1542 --cur=*) cur_="${1##--cur=}" ;;
1543 --sfx=*) sfx="${1##--sfx=}" ;;
1549 if test -r "$tags"; then
1550 __gitcomp_direct "$(__git_match_ctag "$cur_" "$tags" "$pfx" "$sfx")"
1556 __git_has_doubledash && return
1560 __gitcomp_builtin grep
1565 case "$cword,$prev" in
1567 __git_complete_symbol && return
1578 __gitcomp_builtin help
1582 __git_compute_all_commands
1583 __gitcomp "$__git_all_commands $(__git_aliases)
1584 attributes cli core-tutorial cvs-migration
1585 diffcore everyday gitk glossary hooks ignore modules
1586 namespaces repository-layout revisions tutorial tutorial-2
1596 false true umask group all world everybody
1597 " "" "${cur##--shared=}"
1601 __gitcomp_builtin init
1611 __gitcomp_builtin ls-files "--no-empty-directory"
1616 # XXX ignore options like --modified and always suggest all cached
1618 __git_complete_index_file "--cached"
1625 __gitcomp_builtin ls-remote
1629 __gitcomp_nl "$(__git_remotes)"
1636 __gitcomp_builtin ls-tree
1644 # Options that go well for log, shortlog and gitk
1645 __git_log_common_options="
1647 --branches --tags --remotes
1648 --first-parent --merges --no-merges
1650 --max-age= --since= --after=
1651 --min-age= --until= --before=
1652 --min-parents= --max-parents=
1653 --no-min-parents --no-max-parents
1655 # Options that go well for log and gitk (not shortlog)
1656 __git_log_gitk_options="
1657 --dense --sparse --full-history
1658 --simplify-merges --simplify-by-decoration
1659 --left-right --notes --no-notes
1661 # Options that go well for log and shortlog (not gitk)
1662 __git_log_shortlog_options="
1663 --author= --committer= --grep=
1664 --all-match --invert-grep
1667 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1668 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1672 __git_has_doubledash && return
1673 __git_find_repo_path
1676 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
1679 case "$prev,$cur" in
1681 return # fall back to Bash filename completion
1684 __git_complete_symbol --cur="${cur#:}" --sfx=":"
1688 __git_complete_symbol
1693 --pretty=*|--format=*)
1694 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1699 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1703 __gitcomp "full short no" "" "${cur##--decorate=}"
1707 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1711 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1716 $__git_log_common_options
1717 $__git_log_shortlog_options
1718 $__git_log_gitk_options
1719 --root --topo-order --date-order --reverse
1720 --follow --full-diff
1721 --abbrev-commit --abbrev=
1722 --relative-date --date=
1723 --pretty= --format= --oneline
1728 --decorate --decorate=
1730 --parents --children
1732 $__git_diff_common_options
1733 --pickaxe-all --pickaxe-regex
1738 return # fall back to Bash filename completion
1741 __git_complete_symbol --cur="${cur#-L:}" --sfx=":"
1745 __git_complete_symbol --pfx="-G" --cur="${cur#-G}"
1749 __git_complete_symbol --pfx="-S" --cur="${cur#-S}"
1753 __git_complete_revlist
1758 __git_complete_strategy && return
1762 __gitcomp_builtin merge "--no-rerere-autoupdate
1763 --no-commit --no-edit --no-ff
1764 --no-log --no-progress
1765 --no-squash --no-stat
1766 --no-verify-signatures
1777 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1781 __gitcomp "--tool= --prompt --no-prompt"
1791 __gitcomp_builtin merge-base
1802 __gitcomp_builtin mv
1807 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1808 # We need to show both cached and untracked files (including
1809 # empty directories) since this may not be the last argument.
1810 __git_complete_index_file "--cached --others --directory"
1812 __git_complete_index_file "--cached"
1818 local subcommands='add append copy edit get-ref list merge prune remove show'
1819 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1821 case "$subcommand,$cur" in
1823 __gitcomp_builtin notes
1831 __gitcomp "$subcommands --ref"
1835 *,--reuse-message=*|*,--reedit-message=*)
1836 __git_complete_refs --cur="${cur#*=}"
1839 __gitcomp_builtin notes_$subcommand
1842 # this command does not take a ref, do not complete it
1858 __git_complete_strategy && return
1861 --recurse-submodules=*)
1862 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1866 __gitcomp_builtin pull "--no-autostash --no-commit --no-edit
1867 --no-ff --no-log --no-progress --no-rebase
1868 --no-squash --no-stat --no-tags
1869 --no-verify-signatures"
1874 __git_complete_remote_or_refspec
1877 __git_push_recurse_submodules="check on-demand only"
1879 __git_complete_force_with_lease ()
1887 __git_complete_refs --cur="${cur_#*:}"
1890 __git_complete_refs --cur="$cur_"
1899 __gitcomp_nl "$(__git_remotes)"
1902 --recurse-submodules)
1903 __gitcomp "$__git_push_recurse_submodules"
1909 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1912 --recurse-submodules=*)
1913 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1916 --force-with-lease=*)
1917 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1921 __gitcomp_builtin push
1925 __git_complete_remote_or_refspec
1930 __git_find_repo_path
1931 if [ -f "$__git_repo_path"/rebase-merge/interactive ]; then
1932 __gitcomp "--continue --skip --abort --quit --edit-todo --show-current-patch"
1934 elif [ -d "$__git_repo_path"/rebase-apply ] || \
1935 [ -d "$__git_repo_path"/rebase-merge ]; then
1936 __gitcomp "--continue --skip --abort --quit --show-current-patch"
1939 __git_complete_strategy && return
1942 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1947 --onto --merge --strategy --interactive
1948 --preserve-merges --stat --no-stat
1949 --committer-date-is-author-date --ignore-date
1950 --ignore-whitespace --whitespace=
1951 --autosquash --no-autosquash
1952 --fork-point --no-fork-point
1953 --autostash --no-autostash
1954 --verify --no-verify
1955 --keep-empty --root --force-rebase --no-ff
1967 local subcommands="show delete expire"
1968 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1970 if [ -z "$subcommand" ]; then
1971 __gitcomp "$subcommands"
1977 __git_send_email_confirm_options="always never auto cc compose"
1978 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1983 --to|--cc|--bcc|--from)
1984 __gitcomp "$(__git send-email --dump-aliases)"
1992 $__git_send_email_confirm_options
1993 " "" "${cur##--confirm=}"
1998 $__git_send_email_suppresscc_options
1999 " "" "${cur##--suppress-cc=}"
2003 --smtp-encryption=*)
2004 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
2010 " "" "${cur##--thread=}"
2013 --to=*|--cc=*|--bcc=*|--from=*)
2014 __gitcomp "$(__git send-email --dump-aliases)" "" "${cur#--*=}"
2018 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
2019 --compose --confirm= --dry-run --envelope-sender
2021 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
2022 --no-suppress-from --no-thread --quiet --reply-to
2023 --signed-off-by-cc --smtp-pass --smtp-server
2024 --smtp-server-port --smtp-encryption= --smtp-user
2025 --subject --suppress-cc= --suppress-from --thread --to
2026 --validate --no-validate
2027 $__git_format_patch_options"
2031 __git_complete_revlist
2042 local untracked_state
2045 --ignore-submodules=*)
2046 __gitcomp "none untracked dirty all" "" "${cur##--ignore-submodules=}"
2049 --untracked-files=*)
2050 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
2055 always never auto column row plain dense nodense
2056 " "" "${cur##--column=}"
2060 __gitcomp_builtin status "--no-column"
2065 untracked_state="$(__git_get_option_value "-u" "--untracked-files=" \
2066 "$__git_untracked_file_modes" "status.showUntrackedFiles")"
2068 case "$untracked_state" in
2070 # --ignored option does not matter
2074 complete_opt="--cached --directory --no-empty-directory --others"
2076 if [ -n "$(__git_find_on_cmdline "--ignored")" ]; then
2077 complete_opt="$complete_opt --ignored --exclude=*"
2082 __git_complete_index_file "$complete_opt"
2085 __git_config_get_set_variables ()
2087 local prevword word config_file= c=$cword
2088 while [ $c -gt 1 ]; do
2091 --system|--global|--local|--file=*)
2096 config_file="$word $prevword"
2104 __git config $config_file --name-only --list
2110 branch.*.remote|branch.*.pushremote)
2111 __gitcomp_nl "$(__git_remotes)"
2119 __gitcomp "false true preserve interactive"
2123 __gitcomp_nl "$(__git_remotes)"
2127 local remote="${prev#remote.}"
2128 remote="${remote%.fetch}"
2129 if [ -z "$cur" ]; then
2130 __gitcomp_nl "refs/heads/" "" "" ""
2133 __gitcomp_nl "$(__git_refs_remotes "$remote")"
2137 local remote="${prev#remote.}"
2138 remote="${remote%.push}"
2139 __gitcomp_nl "$(__git for-each-ref \
2140 --format='%(refname):%(refname)' refs/heads)"
2143 pull.twohead|pull.octopus)
2144 __git_compute_merge_strategies
2145 __gitcomp "$__git_merge_strategies"
2148 color.branch|color.diff|color.interactive|\
2149 color.showbranch|color.status|color.ui)
2150 __gitcomp "always never auto"
2154 __gitcomp "false true"
2159 normal black red green yellow blue magenta cyan white
2160 bold dim ul blink reverse
2165 __gitcomp "log short"
2169 __gitcomp "man info web html"
2173 __gitcomp "$__git_log_date_formats"
2176 sendemail.aliasesfiletype)
2177 __gitcomp "mutt mailrc pine elm gnus"
2181 __gitcomp "$__git_send_email_confirm_options"
2184 sendemail.suppresscc)
2185 __gitcomp "$__git_send_email_suppresscc_options"
2188 sendemail.transferencoding)
2189 __gitcomp "7bit 8bit quoted-printable base64"
2192 --get|--get-all|--unset|--unset-all)
2193 __gitcomp_nl "$(__git_config_get_set_variables)"
2202 __gitcomp_builtin config
2206 local pfx="${cur%.*}." cur_="${cur##*.}"
2207 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
2211 local pfx="${cur%.*}." cur_="${cur#*.}"
2212 __gitcomp_direct "$(__git_heads "$pfx" "$cur_" ".")"
2213 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
2217 local pfx="${cur%.*}." cur_="${cur##*.}"
2219 argprompt cmd confirm needsfile noconsole norescan
2220 prompt revprompt revunmerged title
2225 local pfx="${cur%.*}." cur_="${cur##*.}"
2226 __gitcomp "cmd path" "$pfx" "$cur_"
2230 local pfx="${cur%.*}." cur_="${cur##*.}"
2231 __gitcomp "cmd path" "$pfx" "$cur_"
2235 local pfx="${cur%.*}." cur_="${cur##*.}"
2236 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
2240 local pfx="${cur%.*}." cur_="${cur#*.}"
2241 __git_compute_all_commands
2242 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
2246 local pfx="${cur%.*}." cur_="${cur##*.}"
2248 url proxy fetch push mirror skipDefaultUpdate
2249 receivepack uploadpack tagopt pushurl
2254 local pfx="${cur%.*}." cur_="${cur#*.}"
2255 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
2256 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
2260 local pfx="${cur%.*}." cur_="${cur##*.}"
2261 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
2268 advice.commitBeforeMerge
2270 advice.implicitIdentity
2271 advice.pushAlreadyExists
2272 advice.pushFetchFirst
2273 advice.pushNeedsForce
2274 advice.pushNonFFCurrent
2275 advice.pushNonFFMatching
2276 advice.pushUpdateRejected
2277 advice.resolveConflict
2280 advice.statusUoption
2285 apply.ignorewhitespace
2287 branch.autosetupmerge
2288 branch.autosetuprebase
2292 color.branch.current
2297 color.decorate.branch
2298 color.decorate.remoteBranch
2299 color.decorate.stash
2309 color.diff.whitespace
2314 color.grep.linenumber
2317 color.grep.separator
2319 color.interactive.error
2320 color.interactive.header
2321 color.interactive.help
2322 color.interactive.prompt
2327 color.status.changed
2329 color.status.localBranch
2330 color.status.nobranch
2331 color.status.remoteBranch
2332 color.status.unmerged
2333 color.status.untracked
2334 color.status.updated
2346 core.bigFileThreshold
2352 core.deltaBaseCacheLimit
2357 core.fsyncobjectfiles
2363 core.logAllRefUpdates
2364 core.loosecompression
2367 core.packedGitWindowSize
2368 core.packedRefsTimeout
2370 core.precomposeUnicode
2371 core.preferSymlinkRefs
2376 core.repositoryFormatVersion
2378 core.sharedRepository
2385 core.warnAmbiguousRefs
2389 credential.useHttpPath
2391 credentialCache.ignoreSIGHUP
2392 diff.autorefreshindex
2394 diff.ignoreSubmodules
2401 diff.suppressBlankEmpty
2407 fetch.recurseSubmodules
2418 format.subjectprefix
2432 gc.reflogexpireunreachable
2435 gc.worktreePruneExpire
2437 gitcvs.commitmsgannotation
2438 gitcvs.dbTableNamePrefix
2449 gui.copyblamethreshold
2453 gui.matchtrackingbranch
2454 gui.newbranchtemplate
2455 gui.pruneduringfetch
2456 gui.spellingdictionary
2473 http.sslCertPasswordProtected
2478 i18n.logOutputEncoding
2484 imap.preformattedHTML
2494 interactive.singlekey
2510 mergetool.keepBackup
2511 mergetool.keepTemporaries
2516 notes.rewrite.rebase
2520 pack.deltaCacheLimit
2537 receive.denyCurrentBranch
2538 receive.denyDeleteCurrent
2540 receive.denyNonFastForwards
2543 receive.updateserverinfo
2546 repack.usedeltabaseoffset
2550 sendemail.aliasesfile
2551 sendemail.aliasfiletype
2555 sendemail.chainreplyto
2557 sendemail.envelopesender
2561 sendemail.signedoffbycc
2562 sendemail.smtpdomain
2563 sendemail.smtpencryption
2565 sendemail.smtpserver
2566 sendemail.smtpserveroption
2567 sendemail.smtpserverport
2569 sendemail.suppresscc
2570 sendemail.suppressfrom
2575 sendemail.smtpbatchsize
2576 sendemail.smtprelogindelay
2578 status.relativePaths
2579 status.showUntrackedFiles
2580 status.submodulesummary
2583 transfer.unpackLimit
2596 add rename remove set-head set-branches
2597 get-url set-url show prune update
2599 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2600 if [ -z "$subcommand" ]; then
2603 __gitcomp_builtin remote
2606 __gitcomp "$subcommands"
2612 case "$subcommand,$cur" in
2614 __gitcomp_builtin remote_add "--no-tags"
2619 __gitcomp_builtin remote_set-head
2622 __gitcomp_builtin remote_set-branches
2624 set-head,*|set-branches,*)
2625 __git_complete_remote_or_refspec
2628 __gitcomp_builtin remote_update
2631 __gitcomp "$(__git_get_config_variables "remotes")"
2634 __gitcomp_builtin remote_set-url
2637 __gitcomp_builtin remote_get-url
2640 __gitcomp_builtin remote_prune
2643 __gitcomp_nl "$(__git_remotes)"
2652 __gitcomp_builtin replace
2661 local subcommands="clear forget diff remaining status gc"
2662 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2663 if test -z "$subcommand"
2665 __gitcomp "$subcommands"
2672 __git_has_doubledash && return
2676 __gitcomp_builtin reset
2683 __git_revert_inprogress_options="--continue --quit --abort"
2687 __git_find_repo_path
2688 if [ -f "$__git_repo_path"/REVERT_HEAD ]; then
2689 __gitcomp "$__git_revert_inprogress_options"
2694 __gitcomp_builtin revert "--no-edit" \
2695 "$__git_revert_inprogress_options"
2706 __gitcomp_builtin rm
2711 __git_complete_index_file "--cached"
2716 __git_has_doubledash && return
2721 $__git_log_common_options
2722 $__git_log_shortlog_options
2723 --numbered --summary --email
2728 __git_complete_revlist
2733 __git_has_doubledash && return
2736 --pretty=*|--format=*)
2737 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2742 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2746 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
2750 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2752 $__git_diff_common_options
2757 __git_complete_revlist_file
2764 __gitcomp_builtin show-branch "--no-color"
2768 __git_complete_revlist
2773 local save_opts='--all --keep-index --no-keep-index --quiet --patch --include-untracked'
2774 local subcommands='push save list show apply clear drop pop create branch'
2775 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2776 if [ -z "$subcommand" ]; then
2779 __gitcomp "$save_opts"
2782 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2783 __gitcomp "$subcommands"
2788 case "$subcommand,$cur" in
2790 __gitcomp "$save_opts --message"
2793 __gitcomp "$save_opts"
2796 __gitcomp "--index --quiet"
2801 show,--*|branch,--*)
2804 if [ $cword -eq 3 ]; then
2807 __gitcomp_nl "$(__git stash list \
2808 | sed -n -e 's/:.*//p')"
2811 show,*|apply,*|drop,*|pop,*)
2812 __gitcomp_nl "$(__git stash list \
2813 | sed -n -e 's/:.*//p')"
2823 __git_has_doubledash && return
2825 local subcommands="add status init deinit update summary foreach sync"
2826 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2827 if [ -z "$subcommand" ]; then
2833 __gitcomp "$subcommands"
2839 case "$subcommand,$cur" in
2841 __gitcomp "--branch --force --name --reference --depth"
2844 __gitcomp "--cached --recursive"
2847 __gitcomp "--force --all"
2851 --init --remote --no-fetch
2852 --recommend-shallow --no-recommend-shallow
2853 --force --rebase --merge --reference --depth --recursive --jobs
2857 __gitcomp "--cached --files --summary-limit"
2859 foreach,--*|sync,--*)
2860 __gitcomp "--recursive"
2870 init fetch clone rebase dcommit log find-rev
2871 set-tree commit-diff info create-ignore propget
2872 proplist show-ignore show-externals branch tag blame
2873 migrate mkdirs reset gc
2875 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2876 if [ -z "$subcommand" ]; then
2877 __gitcomp "$subcommands"
2879 local remote_opts="--username= --config-dir= --no-auth-cache"
2881 --follow-parent --authors-file= --repack=
2882 --no-metadata --use-svm-props --use-svnsync-props
2883 --log-window-size= --no-checkout --quiet
2884 --repack-flags --use-log-author --localtime
2886 --ignore-paths= --include-paths= $remote_opts
2889 --template= --shared= --trunk= --tags=
2890 --branches= --stdlayout --minimize-url
2891 --no-metadata --use-svm-props --use-svnsync-props
2892 --rewrite-root= --prefix= $remote_opts
2895 --edit --rmdir --find-copies-harder --copy-similarity=
2898 case "$subcommand,$cur" in
2900 __gitcomp "--revision= --fetch-all $fc_opts"
2903 __gitcomp "--revision= $fc_opts $init_opts"
2906 __gitcomp "$init_opts"
2910 --merge --strategy= --verbose --dry-run
2911 --fetch-all --no-rebase --commit-url
2912 --revision --interactive $cmt_opts $fc_opts
2916 __gitcomp "--stdin $cmt_opts $fc_opts"
2918 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2919 show-externals,--*|mkdirs,--*)
2920 __gitcomp "--revision="
2924 --limit= --revision= --verbose --incremental
2925 --oneline --show-commit --non-recursive
2926 --authors-file= --color
2931 --merge --verbose --strategy= --local
2932 --fetch-all --dry-run $fc_opts
2936 __gitcomp "--message= --file= --revision= $cmt_opts"
2942 __gitcomp "--dry-run --message --tag"
2945 __gitcomp "--dry-run --message"
2948 __gitcomp "--git-format"
2952 --config-dir= --ignore-paths= --minimize
2953 --no-auth-cache --username=
2957 __gitcomp "--revision= --parent"
2968 while [ $c -lt $cword ]; do
2971 -d|--delete|-v|--verify)
2972 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2987 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2997 __gitcomp_builtin tag
3009 local subcommands="add list lock move prune remove unlock"
3010 local subcommand="$(__git_find_on_cmdline "$subcommands")"
3011 if [ -z "$subcommand" ]; then
3012 __gitcomp "$subcommands"
3014 case "$subcommand,$cur" in
3016 __gitcomp_builtin worktree_add
3019 __gitcomp_builtin worktree_list
3022 __gitcomp_builtin worktree_lock
3025 __gitcomp_builtin worktree_prune
3036 __git_complete_common () {
3041 __gitcomp_builtin "$command"
3046 __git_cmds_with_parseopt_helper=
3047 __git_support_parseopt_helper () {
3048 test -n "$__git_cmds_with_parseopt_helper" ||
3049 __git_cmds_with_parseopt_helper="$(__git --list-parseopt-builtins)"
3051 case " $__git_cmds_with_parseopt_helper " in
3061 __git_complete_command () {
3063 local completion_func="_git_${command//-/_}"
3064 if declare -f $completion_func >/dev/null 2>/dev/null; then
3067 elif __git_support_parseopt_helper "$command"; then
3068 __git_complete_common "$command"
3077 local i c=1 command __git_dir __git_repo_path
3078 local __git_C_args C_args_count=0
3080 while [ $c -lt $cword ]; do
3083 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
3084 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
3085 --bare) __git_dir="." ;;
3086 --help) command="help"; break ;;
3087 -c|--work-tree|--namespace) ((c++)) ;;
3088 -C) __git_C_args[C_args_count++]=-C
3090 __git_C_args[C_args_count++]="${words[c]}"
3093 *) command="$i"; break ;;
3098 if [ -z "$command" ]; then
3100 --git-dir|-C|--work-tree)
3101 # these need a path argument, let's fall back to
3102 # Bash filename completion
3106 # we don't support completing these options' arguments
3124 --no-replace-objects
3128 *) __git_compute_porcelain_commands
3129 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
3134 __git_complete_command "$command" && return
3136 local expansion=$(__git_aliased_command "$command")
3137 if [ -n "$expansion" ]; then
3139 __git_complete_command "$expansion"
3145 __git_has_doubledash && return
3147 local __git_repo_path
3148 __git_find_repo_path
3151 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
3157 $__git_log_common_options
3158 $__git_log_gitk_options
3164 __git_complete_revlist
3167 if [[ -n ${ZSH_VERSION-} ]]; then
3168 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
3170 autoload -U +X compinit && compinit
3176 local cur_="${3-$cur}"
3182 local c IFS=$' \t\n'
3190 array[${#array[@]}+1]="$c"
3193 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
3204 compadd -Q -- ${=1} && _ret=0
3213 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
3222 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
3227 local _ret=1 cur cword prev
3228 cur=${words[CURRENT]}
3229 prev=${words[CURRENT-1]}
3231 emulate ksh -c __${service}_main
3232 let _ret && _default && _ret=0
3236 compdef _git git gitk
3242 local cur words cword prev
3243 _get_comp_words_by_ref -n =: cur words cword prev
3247 # Setup completion for certain functions defined above by setting common
3248 # variables and workarounds.
3249 # This is NOT a public function; use at your own risk.
3252 local wrapper="__git_wrap${2}"
3253 eval "$wrapper () { __git_func_wrap $2 ; }"
3254 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
3255 || complete -o default -o nospace -F $wrapper $1
3258 # wrapper for backwards compatibility
3261 __git_wrap__git_main
3264 # wrapper for backwards compatibility
3267 __git_wrap__gitk_main
3270 __git_complete git __git_main
3271 __git_complete gitk __gitk_main
3273 # The following are necessary only for Cygwin, and only are needed
3274 # when the user has tab-completed the executable name and consequently
3275 # included the '.exe' suffix.
3277 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
3278 __git_complete git.exe __git_main