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 if [[ -n ${ZSH_VERSION-} ]]; then
288 unset $(set |sed -ne 's/^\(__gitcomp_builtin_[a-zA-Z0-9_][a-zA-Z0-9_]*\)=.*/\1/p') 2>/dev/null
290 unset $(compgen -v __gitcomp_builtin_)
293 # This function is equivalent to
295 # __gitcomp "$(git xxx --git-completion-helper) ..."
297 # except that the output is cached. Accept 1-3 arguments:
298 # 1: the git command to execute, this is also the cache key
299 # 2: extra options to be added on top (e.g. negative forms)
300 # 3: options to be excluded
303 # spaces must be replaced with underscore for multi-word
304 # commands, e.g. "git remote add" becomes remote_add.
309 local var=__gitcomp_builtin_"${cmd/-/_}"
311 eval "options=\$$var"
313 if [ -z "$options" ]; then
314 # leading and trailing spaces are significant to make
315 # option removal work correctly.
316 options=" $(__git ${cmd/_/ } --git-completion-helper) $incl "
318 options="${options/ $i / }"
320 eval "$var=\"$options\""
326 # Variation of __gitcomp_nl () that appends to the existing list of
327 # completion candidates, COMPREPLY.
328 __gitcomp_nl_append ()
331 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
334 # Generates completion reply from newline-separated possible completion words
335 # by appending a space to all of them.
336 # It accepts 1 to 4 arguments:
337 # 1: List of possible completion words, separated by a single newline.
338 # 2: A prefix to be added to each possible completion word (optional).
339 # 3: Generate possible completion matches for this word (optional).
340 # 4: A suffix to be appended to each possible completion word instead of
341 # the default space (optional). If specified but empty, nothing is
346 __gitcomp_nl_append "$@"
349 # Generates completion reply with compgen from newline-separated possible
350 # completion filenames.
351 # It accepts 1 to 3 arguments:
352 # 1: List of possible completion filenames, separated by a single newline.
353 # 2: A directory prefix to be added to each possible completion filename
355 # 3: Generate possible completion matches for this word (optional).
360 # XXX does not work when the directory prefix contains a tilde,
361 # since tilde expansion is not applied.
362 # This means that COMPREPLY will be empty and Bash default
363 # completion will be used.
364 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
366 # use a hack to enable file mode in bash < 4
367 compopt -o filenames +o nospace 2>/dev/null ||
368 compgen -f /non-existing-dir/ > /dev/null
371 # Execute 'git ls-files', unless the --committable option is specified, in
372 # which case it runs 'git diff-index' to find out the files that can be
373 # committed. It return paths relative to the directory specified in the first
374 # argument, and using the options specified in the second argument.
375 __git_ls_files_helper ()
377 if [ "$2" == "--committable" ]; then
378 __git -C "$1" diff-index --name-only --relative HEAD
380 # NOTE: $2 is not quoted in order to support multiple options
381 __git -C "$1" ls-files --exclude-standard $2
386 # __git_index_files accepts 1 or 2 arguments:
387 # 1: Options to pass to ls-files (required).
388 # 2: A directory path (optional).
389 # If provided, only files within the specified directory are listed.
390 # Sub directories are never recursed. Path must have a trailing
394 local root="${2-.}" file
396 __git_ls_files_helper "$root" "$1" |
397 cut -f1 -d/ | sort | uniq
400 # Lists branches from the local repository.
401 # 1: A prefix to be added to each listed branch (optional).
402 # 2: List only branches matching this word (optional; list all branches if
404 # 3: A suffix to be appended to each listed branch (optional).
407 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
409 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
410 "refs/heads/$cur_*" "refs/heads/$cur_*/**"
413 # Lists tags from the local repository.
414 # Accepts the same positional parameters as __git_heads() above.
417 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
419 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
420 "refs/tags/$cur_*" "refs/tags/$cur_*/**"
423 # Lists refs from the local (by default) or from a remote repository.
424 # It accepts 0, 1 or 2 arguments:
425 # 1: The remote to list refs from (optional; ignored, if set but empty).
426 # Can be the name of a configured remote, a path, or a URL.
427 # 2: In addition to local refs, list unique branches from refs/remotes/ for
428 # 'git checkout's tracking DWIMery (optional; ignored, if set but empty).
429 # 3: A prefix to be added to each listed ref (optional).
430 # 4: List only refs matching this word (optional; list all refs if unset or
432 # 5: A suffix to be appended to each listed ref (optional; ignored, if set
435 # Use __git_complete_refs() instead.
438 local i hash dir track="${2-}"
439 local list_refs_from=path remote="${1-}"
441 local pfx="${3-}" cur_="${4-$cur}" sfx="${5-}"
443 local fer_pfx="${pfx//\%/%%}" # "escape" for-each-ref format specifiers
446 dir="$__git_repo_path"
448 if [ -z "$remote" ]; then
449 if [ -z "$dir" ]; then
453 if __git_is_configured_remote "$remote"; then
454 # configured remote takes precedence over a
455 # local directory with the same name
456 list_refs_from=remote
457 elif [ -d "$remote/.git" ]; then
459 elif [ -d "$remote" ]; then
466 if [ "$list_refs_from" = path ]; then
467 if [[ "$cur_" == ^* ]]; then
476 refs=("$match*" "$match*/**")
480 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD REBASE_HEAD; do
483 if [ -e "$dir/$i" ]; then
489 format="refname:strip=2"
490 refs=("refs/tags/$match*" "refs/tags/$match*/**"
491 "refs/heads/$match*" "refs/heads/$match*/**"
492 "refs/remotes/$match*" "refs/remotes/$match*/**")
495 __git_dir="$dir" __git for-each-ref --format="$fer_pfx%($format)$sfx" \
497 if [ -n "$track" ]; then
498 # employ the heuristic used by git checkout
499 # Try to find a remote branch that matches the completion word
500 # but only output if the branch name is unique
501 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
502 --sort="refname:strip=3" \
503 "refs/remotes/*/$match*" "refs/remotes/*/$match*/**" | \
510 __git ls-remote "$remote" "$match*" | \
511 while read -r hash i; do
514 *) echo "$pfx$i$sfx" ;;
519 if [ "$list_refs_from" = remote ]; then
521 $match*) echo "${pfx}HEAD$sfx" ;;
523 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
524 "refs/remotes/$remote/$match*" \
525 "refs/remotes/$remote/$match*/**"
529 $match*) query_symref="HEAD" ;;
531 __git ls-remote "$remote" $query_symref \
532 "refs/tags/$match*" "refs/heads/$match*" \
533 "refs/remotes/$match*" |
534 while read -r hash i; do
537 refs/*) echo "$pfx${i#refs/*/}$sfx" ;;
538 *) echo "$pfx$i$sfx" ;; # symbolic refs
546 # Completes refs, short and long, local and remote, symbolic and pseudo.
548 # Usage: __git_complete_refs [<option>]...
549 # --remote=<remote>: The remote to list refs from, can be the name of a
550 # configured remote, a path, or a URL.
551 # --track: List unique remote branches for 'git checkout's tracking DWIMery.
552 # --pfx=<prefix>: A prefix to be added to each ref.
553 # --cur=<word>: The current ref to be completed. Defaults to the current
554 # word to be completed.
555 # --sfx=<suffix>: A suffix to be appended to each ref instead of the default
557 __git_complete_refs ()
559 local remote track pfx cur_="$cur" sfx=" "
561 while test $# != 0; do
563 --remote=*) remote="${1##--remote=}" ;;
564 --track) track="yes" ;;
565 --pfx=*) pfx="${1##--pfx=}" ;;
566 --cur=*) cur_="${1##--cur=}" ;;
567 --sfx=*) sfx="${1##--sfx=}" ;;
573 __gitcomp_direct "$(__git_refs "$remote" "$track" "$pfx" "$cur_" "$sfx")"
576 # __git_refs2 requires 1 argument (to pass to __git_refs)
577 # Deprecated: use __git_complete_fetch_refspecs() instead.
581 for i in $(__git_refs "$1"); do
586 # Completes refspecs for fetching from a remote repository.
587 # 1: The remote repository.
588 # 2: A prefix to be added to each listed refspec (optional).
589 # 3: The ref to be completed as a refspec instead of the current word to be
590 # completed (optional)
591 # 4: A suffix to be appended to each listed refspec instead of the default
593 __git_complete_fetch_refspecs ()
595 local i remote="$1" pfx="${2-}" cur_="${3-$cur}" sfx="${4- }"
598 for i in $(__git_refs "$remote" "" "" "$cur_") ; do
604 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
605 __git_refs_remotes ()
608 __git ls-remote "$1" 'refs/heads/*' | \
609 while read -r hash i; do
610 echo "$i:refs/remotes/$1/${i#refs/heads/}"
617 test -d "$__git_repo_path/remotes" && ls -1 "$__git_repo_path/remotes"
621 # Returns true if $1 matches the name of a configured remote, false otherwise.
622 __git_is_configured_remote ()
625 for remote in $(__git_remotes); do
626 if [ "$remote" = "$1" ]; then
633 __git_list_merge_strategies ()
635 LANG=C LC_ALL=C git merge -s help 2>&1 |
636 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
645 __git_merge_strategies=
646 # 'git merge -s help' (and thus detection of the merge strategy
647 # list) fails, unfortunately, if run outside of any git working
648 # tree. __git_merge_strategies is set to the empty string in
649 # that case, and the detection will be repeated the next time it
651 __git_compute_merge_strategies ()
653 test -n "$__git_merge_strategies" ||
654 __git_merge_strategies=$(__git_list_merge_strategies)
657 __git_complete_revlist_file ()
659 local pfx ls ref cur_="$cur"
679 case "$COMP_WORDBREAKS" in
681 *) pfx="$ref:$pfx" ;;
684 __gitcomp_nl "$(__git ls-tree "$ls" \
685 | sed '/^100... blob /{
701 pfx="${cur_%...*}..."
703 __git_complete_refs --pfx="$pfx" --cur="$cur_"
708 __git_complete_refs --pfx="$pfx" --cur="$cur_"
717 # __git_complete_index_file requires 1 argument:
718 # 1: the options to pass to ls-file
720 # The exception is --committable, which finds the files appropriate commit.
721 __git_complete_index_file ()
723 local pfx="" cur_="$cur"
733 __gitcomp_file "$(__git_index_files "$1" ${pfx:+"$pfx"})" "$pfx" "$cur_"
736 __git_complete_file ()
738 __git_complete_revlist_file
741 __git_complete_revlist ()
743 __git_complete_revlist_file
746 __git_complete_remote_or_refspec ()
748 local cur_="$cur" cmd="${words[1]}"
749 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
750 if [ "$cmd" = "remote" ]; then
753 while [ $c -lt $cword ]; do
756 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
757 -d|--delete) [ "$cmd" = "push" ] && lhs=0 ;;
760 push) no_complete_refspec=1 ;;
768 *) remote="$i"; break ;;
772 if [ -z "$remote" ]; then
773 __gitcomp_nl "$(__git_remotes)"
776 if [ $no_complete_refspec = 1 ]; then
779 [ "$remote" = "." ] && remote=
782 case "$COMP_WORDBREAKS" in
784 *) pfx="${cur_%%:*}:" ;;
796 if [ $lhs = 1 ]; then
797 __git_complete_fetch_refspecs "$remote" "$pfx" "$cur_"
799 __git_complete_refs --pfx="$pfx" --cur="$cur_"
803 if [ $lhs = 1 ]; then
804 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
806 __git_complete_refs --pfx="$pfx" --cur="$cur_"
810 if [ $lhs = 1 ]; then
811 __git_complete_refs --pfx="$pfx" --cur="$cur_"
813 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
819 __git_complete_strategy ()
821 __git_compute_merge_strategies
824 __gitcomp "$__git_merge_strategies"
829 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
837 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
839 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
841 git help -a|egrep '^ [a-zA-Z0-9]'
845 __git_list_all_commands ()
848 for i in $(__git_commands)
851 *--*) : helper pattern;;
858 __git_compute_all_commands ()
860 test -n "$__git_all_commands" ||
861 __git_all_commands=$(__git_list_all_commands)
864 __git_list_porcelain_commands ()
867 __git_compute_all_commands
868 for i in $__git_all_commands
871 *--*) : helper pattern;;
872 applymbox) : ask gittus;;
873 applypatch) : ask gittus;;
874 archimport) : import;;
875 cat-file) : plumbing;;
876 check-attr) : plumbing;;
877 check-ignore) : plumbing;;
878 check-mailmap) : plumbing;;
879 check-ref-format) : plumbing;;
880 checkout-index) : plumbing;;
881 column) : internal helper;;
882 commit-graph) : plumbing;;
883 commit-tree) : plumbing;;
884 count-objects) : infrequent;;
885 credential) : credentials;;
886 credential-*) : credentials helper;;
887 cvsexportcommit) : export;;
888 cvsimport) : import;;
889 cvsserver) : daemon;;
891 diff-files) : plumbing;;
892 diff-index) : plumbing;;
893 diff-tree) : plumbing;;
894 fast-import) : import;;
895 fast-export) : export;;
896 fsck-objects) : plumbing;;
897 fetch-pack) : plumbing;;
898 fmt-merge-msg) : plumbing;;
899 for-each-ref) : plumbing;;
900 hash-object) : plumbing;;
901 http-*) : transport;;
902 index-pack) : plumbing;;
903 init-db) : deprecated;;
904 local-fetch) : plumbing;;
905 ls-files) : plumbing;;
906 ls-remote) : plumbing;;
907 ls-tree) : plumbing;;
908 mailinfo) : plumbing;;
909 mailsplit) : plumbing;;
910 merge-*) : plumbing;;
913 pack-objects) : plumbing;;
914 pack-redundant) : plumbing;;
915 pack-refs) : plumbing;;
916 parse-remote) : plumbing;;
917 patch-id) : plumbing;;
919 prune-packed) : plumbing;;
920 quiltimport) : import;;
921 read-tree) : plumbing;;
922 receive-pack) : plumbing;;
923 remote-*) : transport;;
925 rev-list) : plumbing;;
926 rev-parse) : plumbing;;
927 runstatus) : plumbing;;
928 sh-setup) : internal;;
930 show-ref) : plumbing;;
931 send-pack) : plumbing;;
932 show-index) : plumbing;;
934 stripspace) : plumbing;;
935 symbolic-ref) : plumbing;;
936 unpack-file) : plumbing;;
937 unpack-objects) : plumbing;;
938 update-index) : plumbing;;
939 update-ref) : plumbing;;
940 update-server-info) : daemon;;
941 upload-archive) : plumbing;;
942 upload-pack) : plumbing;;
943 write-tree) : plumbing;;
945 verify-pack) : infrequent;;
946 verify-tag) : plumbing;;
952 __git_porcelain_commands=
953 __git_compute_porcelain_commands ()
955 test -n "$__git_porcelain_commands" ||
956 __git_porcelain_commands=$(__git_list_porcelain_commands)
959 # Lists all set config variables starting with the given section prefix,
960 # with the prefix removed.
961 __git_get_config_variables ()
963 local section="$1" i IFS=$'\n'
964 for i in $(__git config --name-only --get-regexp "^$section\..*"); do
965 echo "${i#$section.}"
969 __git_pretty_aliases ()
971 __git_get_config_variables "pretty"
976 __git_get_config_variables "alias"
979 # __git_aliased_command requires 1 argument
980 __git_aliased_command ()
982 local word cmdline=$(__git config --get "alias.$1")
983 for word in $cmdline; do
989 \!*) : shell command alias ;;
991 *=*) : setting env ;;
993 \(\)) : skip parens of shell function definition ;;
994 {) : skip start of shell helper function ;;
995 :) : skip null command ;;
996 \'*) : skip opening quote after sh -c ;;
1004 # __git_find_on_cmdline requires 1 argument
1005 __git_find_on_cmdline ()
1007 local word subcommand c=1
1008 while [ $c -lt $cword ]; do
1010 for subcommand in $1; do
1011 if [ "$subcommand" = "$word" ]; then
1020 # Echo the value of an option set on the command line or config
1022 # $1: short option name
1023 # $2: long option name including =
1024 # $3: list of possible values
1025 # $4: config string (optional)
1028 # result="$(__git_get_option_value "-d" "--do-something=" \
1029 # "yes no" "core.doSomething")"
1031 # result is then either empty (no option set) or "yes" or "no"
1033 # __git_get_option_value requires 3 arguments
1034 __git_get_option_value ()
1036 local c short_opt long_opt val
1037 local result= values config_key word
1045 while [ $c -ge 0 ]; do
1047 for val in $values; do
1048 if [ "$short_opt$val" = "$word" ] ||
1049 [ "$long_opt$val" = "$word" ]; then
1057 if [ -n "$config_key" ] && [ -z "$result" ]; then
1058 result="$(__git config "$config_key")"
1064 __git_has_doubledash ()
1067 while [ $c -lt $cword ]; do
1068 if [ "--" = "${words[c]}" ]; then
1076 # Try to count non option arguments passed on the command line for the
1077 # specified git command.
1078 # When options are used, it is necessary to use the special -- option to
1079 # tell the implementation were non option arguments begin.
1080 # XXX this can not be improved, since options can appear everywhere, as
1084 # __git_count_arguments requires 1 argument: the git command executed.
1085 __git_count_arguments ()
1089 # Skip "git" (first argument)
1090 for ((i=1; i < ${#words[@]}; i++)); do
1095 # Good; we can assume that the following are only non
1100 # Skip the specified git command and discard git
1113 __git_whitespacelist="nowarn warn error error-all fix"
1114 __git_am_inprogress_options="--skip --continue --resolved --abort --quit --show-current-patch"
1118 __git_find_repo_path
1119 if [ -d "$__git_repo_path"/rebase-apply ]; then
1120 __gitcomp "$__git_am_inprogress_options"
1125 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1129 __gitcomp_builtin am "--no-utf8" \
1130 "$__git_am_inprogress_options"
1139 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1143 __gitcomp_builtin apply
1152 __gitcomp_builtin add
1156 local complete_opt="--others --modified --directory --no-empty-directory"
1157 if test -n "$(__git_find_on_cmdline "-u --update")"
1159 complete_opt="--modified"
1161 __git_complete_index_file "$complete_opt"
1168 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
1172 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
1177 --format= --list --verbose
1178 --prefix= --remote= --exec= --output
1188 __git_has_doubledash && return
1190 local subcommands="start bad good skip reset visualize replay log run"
1191 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1192 if [ -z "$subcommand" ]; then
1193 __git_find_repo_path
1194 if [ -f "$__git_repo_path"/BISECT_START ]; then
1195 __gitcomp "$subcommands"
1197 __gitcomp "replay start"
1202 case "$subcommand" in
1203 bad|good|reset|skip|start)
1213 local i c=1 only_local_ref="n" has_r="n"
1215 while [ $c -lt $cword ]; do
1218 -d|--delete|-m|--move) only_local_ref="y" ;;
1219 -r|--remotes) has_r="y" ;;
1225 --set-upstream-to=*)
1226 __git_complete_refs --cur="${cur##--set-upstream-to=}"
1229 __gitcomp_builtin branch "--no-color --no-abbrev
1230 --no-track --no-column
1234 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
1235 __gitcomp_direct "$(__git_heads "" "$cur" " ")"
1245 local cmd="${words[2]}"
1248 __gitcomp "create list-heads verify unbundle"
1251 # looking for a file
1256 __git_complete_revlist
1265 __git_has_doubledash && return
1269 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1272 __gitcomp_builtin checkout "--no-track --no-recurse-submodules"
1275 # check if --track, --no-track, or --no-guess was specified
1276 # if so, disable DWIM mode
1277 local flags="--track --no-track --no-guess" track_opt="--track"
1278 if [ "$GIT_COMPLETION_CHECKOUT_NO_GUESS" = "1" ] ||
1279 [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1282 __git_complete_refs $track_opt
1291 __gitcomp_builtin cherry
1298 __git_cherry_pick_inprogress_options="--continue --quit --abort"
1302 __git_find_repo_path
1303 if [ -f "$__git_repo_path"/CHERRY_PICK_HEAD ]; then
1304 __gitcomp "$__git_cherry_pick_inprogress_options"
1309 __gitcomp_builtin cherry-pick "" \
1310 "$__git_cherry_pick_inprogress_options"
1322 __gitcomp_builtin clean
1327 # XXX should we check for -x option ?
1328 __git_complete_index_file "--others --directory"
1335 __gitcomp_builtin clone "--no-single-branch"
1341 __git_untracked_file_modes="all no normal"
1354 __gitcomp "default scissors strip verbatim whitespace
1355 " "" "${cur##--cleanup=}"
1358 --reuse-message=*|--reedit-message=*|\
1359 --fixup=*|--squash=*)
1360 __git_complete_refs --cur="${cur#*=}"
1363 --untracked-files=*)
1364 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
1368 __gitcomp_builtin commit "--no-edit --verify"
1372 if __git rev-parse --verify --quiet HEAD >/dev/null; then
1373 __git_complete_index_file "--committable"
1375 # This is the first commit
1376 __git_complete_index_file "--cached"
1384 __gitcomp_builtin describe
1390 __git_diff_algorithms="myers minimal patience histogram"
1392 __git_diff_submodule_formats="diff log short"
1394 __git_diff_common_options="--stat --numstat --shortstat --summary
1395 --patch-with-stat --name-only --name-status --color
1396 --no-color --color-words --no-renames --check
1397 --full-index --binary --abbrev --diff-filter=
1398 --find-copies-harder --ignore-cr-at-eol
1399 --text --ignore-space-at-eol --ignore-space-change
1400 --ignore-all-space --ignore-blank-lines --exit-code
1401 --quiet --ext-diff --no-ext-diff
1402 --no-prefix --src-prefix= --dst-prefix=
1403 --inter-hunk-context=
1404 --patience --histogram --minimal
1405 --raw --word-diff --word-diff-regex=
1406 --dirstat --dirstat= --dirstat-by-file
1407 --dirstat-by-file= --cumulative
1409 --submodule --submodule= --ignore-submodules
1414 __git_has_doubledash && return
1418 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1422 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1426 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1427 --base --ours --theirs --no-index
1428 $__git_diff_common_options
1433 __git_complete_revlist_file
1436 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1437 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc codecompare
1442 __git_has_doubledash && return
1446 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1450 __gitcomp_builtin difftool "$__git_diff_common_options
1451 --base --cached --ours --theirs
1452 --pickaxe-all --pickaxe-regex
1458 __git_complete_revlist_file
1461 __git_fetch_recurse_submodules="yes on-demand no"
1466 --recurse-submodules=*)
1467 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1471 __gitcomp_builtin fetch "--no-tags"
1475 __git_complete_remote_or_refspec
1478 __git_format_patch_options="
1479 --stdout --attach --no-attach --thread --thread= --no-thread
1480 --numbered --start-number --numbered-files --keep-subject --signoff
1481 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1482 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1483 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1484 --output-directory --reroll-count --to= --quiet --notes
1487 _git_format_patch ()
1493 " "" "${cur##--thread=}"
1497 __gitcomp "$__git_format_patch_options"
1501 __git_complete_revlist
1508 __gitcomp_builtin fsck "--no-reflogs"
1519 # Lists matching symbol names from a tag (as in ctags) file.
1520 # 1: List symbol names matching this word.
1521 # 2: The tag file to list symbol names from.
1522 # 3: A prefix to be added to each listed symbol name (optional).
1523 # 4: A suffix to be appended to each listed symbol name (optional).
1524 __git_match_ctag () {
1525 awk -v pfx="${3-}" -v sfx="${4-}" "
1526 /^${1//\//\\/}/ { print pfx \$1 sfx }
1530 # Complete symbol names from a tag file.
1531 # Usage: __git_complete_symbol [<option>]...
1532 # --tags=<file>: The tag file to list symbol names from instead of the
1534 # --pfx=<prefix>: A prefix to be added to each symbol name.
1535 # --cur=<word>: The current symbol name to be completed. Defaults to
1536 # the current word to be completed.
1537 # --sfx=<suffix>: A suffix to be appended to each symbol name instead
1538 # of the default space.
1539 __git_complete_symbol () {
1540 local tags=tags pfx="" cur_="${cur-}" sfx=" "
1542 while test $# != 0; do
1544 --tags=*) tags="${1##--tags=}" ;;
1545 --pfx=*) pfx="${1##--pfx=}" ;;
1546 --cur=*) cur_="${1##--cur=}" ;;
1547 --sfx=*) sfx="${1##--sfx=}" ;;
1553 if test -r "$tags"; then
1554 __gitcomp_direct "$(__git_match_ctag "$cur_" "$tags" "$pfx" "$sfx")"
1560 __git_has_doubledash && return
1564 __gitcomp_builtin grep
1569 case "$cword,$prev" in
1571 __git_complete_symbol && return
1582 __gitcomp_builtin help
1586 __git_compute_all_commands
1587 __gitcomp "$__git_all_commands $(__git_aliases)
1588 attributes cli core-tutorial cvs-migration
1589 diffcore everyday gitk glossary hooks ignore modules
1590 namespaces repository-layout revisions tutorial tutorial-2
1600 false true umask group all world everybody
1601 " "" "${cur##--shared=}"
1605 __gitcomp_builtin init
1615 __gitcomp_builtin ls-files "--no-empty-directory"
1620 # XXX ignore options like --modified and always suggest all cached
1622 __git_complete_index_file "--cached"
1629 __gitcomp_builtin ls-remote
1633 __gitcomp_nl "$(__git_remotes)"
1640 __gitcomp_builtin ls-tree
1648 # Options that go well for log, shortlog and gitk
1649 __git_log_common_options="
1651 --branches --tags --remotes
1652 --first-parent --merges --no-merges
1654 --max-age= --since= --after=
1655 --min-age= --until= --before=
1656 --min-parents= --max-parents=
1657 --no-min-parents --no-max-parents
1659 # Options that go well for log and gitk (not shortlog)
1660 __git_log_gitk_options="
1661 --dense --sparse --full-history
1662 --simplify-merges --simplify-by-decoration
1663 --left-right --notes --no-notes
1665 # Options that go well for log and shortlog (not gitk)
1666 __git_log_shortlog_options="
1667 --author= --committer= --grep=
1668 --all-match --invert-grep
1671 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1672 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1676 __git_has_doubledash && return
1677 __git_find_repo_path
1680 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
1683 case "$prev,$cur" in
1685 return # fall back to Bash filename completion
1688 __git_complete_symbol --cur="${cur#:}" --sfx=":"
1692 __git_complete_symbol
1697 --pretty=*|--format=*)
1698 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1703 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1707 __gitcomp "full short no" "" "${cur##--decorate=}"
1711 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1715 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1720 $__git_log_common_options
1721 $__git_log_shortlog_options
1722 $__git_log_gitk_options
1723 --root --topo-order --date-order --reverse
1724 --follow --full-diff
1725 --abbrev-commit --abbrev=
1726 --relative-date --date=
1727 --pretty= --format= --oneline
1732 --decorate --decorate=
1734 --parents --children
1736 $__git_diff_common_options
1737 --pickaxe-all --pickaxe-regex
1742 return # fall back to Bash filename completion
1745 __git_complete_symbol --cur="${cur#-L:}" --sfx=":"
1749 __git_complete_symbol --pfx="-G" --cur="${cur#-G}"
1753 __git_complete_symbol --pfx="-S" --cur="${cur#-S}"
1757 __git_complete_revlist
1762 __git_complete_strategy && return
1766 __gitcomp_builtin merge "--no-rerere-autoupdate
1767 --no-commit --no-edit --no-ff
1768 --no-log --no-progress
1769 --no-squash --no-stat
1770 --no-verify-signatures
1781 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1785 __gitcomp "--tool= --prompt --no-prompt"
1795 __gitcomp_builtin merge-base
1806 __gitcomp_builtin mv
1811 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1812 # We need to show both cached and untracked files (including
1813 # empty directories) since this may not be the last argument.
1814 __git_complete_index_file "--cached --others --directory"
1816 __git_complete_index_file "--cached"
1822 local subcommands='add append copy edit get-ref list merge prune remove show'
1823 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1825 case "$subcommand,$cur" in
1827 __gitcomp_builtin notes
1835 __gitcomp "$subcommands --ref"
1839 *,--reuse-message=*|*,--reedit-message=*)
1840 __git_complete_refs --cur="${cur#*=}"
1843 __gitcomp_builtin notes_$subcommand
1846 # this command does not take a ref, do not complete it
1862 __git_complete_strategy && return
1865 --recurse-submodules=*)
1866 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1870 __gitcomp_builtin pull "--no-autostash --no-commit --no-edit
1871 --no-ff --no-log --no-progress --no-rebase
1872 --no-squash --no-stat --no-tags
1873 --no-verify-signatures"
1878 __git_complete_remote_or_refspec
1881 __git_push_recurse_submodules="check on-demand only"
1883 __git_complete_force_with_lease ()
1891 __git_complete_refs --cur="${cur_#*:}"
1894 __git_complete_refs --cur="$cur_"
1903 __gitcomp_nl "$(__git_remotes)"
1906 --recurse-submodules)
1907 __gitcomp "$__git_push_recurse_submodules"
1913 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1916 --recurse-submodules=*)
1917 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1920 --force-with-lease=*)
1921 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1925 __gitcomp_builtin push
1929 __git_complete_remote_or_refspec
1934 __git_find_repo_path
1935 if [ -f "$__git_repo_path"/rebase-merge/interactive ]; then
1936 __gitcomp "--continue --skip --abort --quit --edit-todo --show-current-patch"
1938 elif [ -d "$__git_repo_path"/rebase-apply ] || \
1939 [ -d "$__git_repo_path"/rebase-merge ]; then
1940 __gitcomp "--continue --skip --abort --quit --show-current-patch"
1943 __git_complete_strategy && return
1946 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1951 --onto --merge --strategy --interactive
1952 --rebase-merges --preserve-merges --stat --no-stat
1953 --committer-date-is-author-date --ignore-date
1954 --ignore-whitespace --whitespace=
1955 --autosquash --no-autosquash
1956 --fork-point --no-fork-point
1957 --autostash --no-autostash
1958 --verify --no-verify
1959 --keep-empty --root --force-rebase --no-ff
1971 local subcommands="show delete expire"
1972 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1974 if [ -z "$subcommand" ]; then
1975 __gitcomp "$subcommands"
1981 __git_send_email_confirm_options="always never auto cc compose"
1982 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1987 --to|--cc|--bcc|--from)
1988 __gitcomp "$(__git send-email --dump-aliases)"
1996 $__git_send_email_confirm_options
1997 " "" "${cur##--confirm=}"
2002 $__git_send_email_suppresscc_options
2003 " "" "${cur##--suppress-cc=}"
2007 --smtp-encryption=*)
2008 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
2014 " "" "${cur##--thread=}"
2017 --to=*|--cc=*|--bcc=*|--from=*)
2018 __gitcomp "$(__git send-email --dump-aliases)" "" "${cur#--*=}"
2022 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
2023 --compose --confirm= --dry-run --envelope-sender
2025 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
2026 --no-suppress-from --no-thread --quiet --reply-to
2027 --signed-off-by-cc --smtp-pass --smtp-server
2028 --smtp-server-port --smtp-encryption= --smtp-user
2029 --subject --suppress-cc= --suppress-from --thread --to
2030 --validate --no-validate
2031 $__git_format_patch_options"
2035 __git_complete_revlist
2046 local untracked_state
2049 --ignore-submodules=*)
2050 __gitcomp "none untracked dirty all" "" "${cur##--ignore-submodules=}"
2053 --untracked-files=*)
2054 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
2059 always never auto column row plain dense nodense
2060 " "" "${cur##--column=}"
2064 __gitcomp_builtin status "--no-column"
2069 untracked_state="$(__git_get_option_value "-u" "--untracked-files=" \
2070 "$__git_untracked_file_modes" "status.showUntrackedFiles")"
2072 case "$untracked_state" in
2074 # --ignored option does not matter
2078 complete_opt="--cached --directory --no-empty-directory --others"
2080 if [ -n "$(__git_find_on_cmdline "--ignored")" ]; then
2081 complete_opt="$complete_opt --ignored --exclude=*"
2086 __git_complete_index_file "$complete_opt"
2089 __git_config_get_set_variables ()
2091 local prevword word config_file= c=$cword
2092 while [ $c -gt 1 ]; do
2095 --system|--global|--local|--file=*)
2100 config_file="$word $prevword"
2108 __git config $config_file --name-only --list
2114 branch.*.remote|branch.*.pushremote)
2115 __gitcomp_nl "$(__git_remotes)"
2123 __gitcomp "false true merges preserve interactive"
2127 __gitcomp_nl "$(__git_remotes)"
2131 local remote="${prev#remote.}"
2132 remote="${remote%.fetch}"
2133 if [ -z "$cur" ]; then
2134 __gitcomp_nl "refs/heads/" "" "" ""
2137 __gitcomp_nl "$(__git_refs_remotes "$remote")"
2141 local remote="${prev#remote.}"
2142 remote="${remote%.push}"
2143 __gitcomp_nl "$(__git for-each-ref \
2144 --format='%(refname):%(refname)' refs/heads)"
2147 pull.twohead|pull.octopus)
2148 __git_compute_merge_strategies
2149 __gitcomp "$__git_merge_strategies"
2152 color.branch|color.diff|color.interactive|\
2153 color.showbranch|color.status|color.ui)
2154 __gitcomp "always never auto"
2158 __gitcomp "false true"
2163 normal black red green yellow blue magenta cyan white
2164 bold dim ul blink reverse
2169 __gitcomp "log short"
2173 __gitcomp "man info web html"
2177 __gitcomp "$__git_log_date_formats"
2180 sendemail.aliasfiletype)
2181 __gitcomp "mutt mailrc pine elm gnus"
2185 __gitcomp "$__git_send_email_confirm_options"
2188 sendemail.suppresscc)
2189 __gitcomp "$__git_send_email_suppresscc_options"
2192 sendemail.transferencoding)
2193 __gitcomp "7bit 8bit quoted-printable base64"
2196 --get|--get-all|--unset|--unset-all)
2197 __gitcomp_nl "$(__git_config_get_set_variables)"
2206 __gitcomp_builtin config
2210 local pfx="${cur%.*}." cur_="${cur##*.}"
2211 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
2215 local pfx="${cur%.*}." cur_="${cur#*.}"
2216 __gitcomp_direct "$(__git_heads "$pfx" "$cur_" ".")"
2217 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
2221 local pfx="${cur%.*}." cur_="${cur##*.}"
2223 argprompt cmd confirm needsfile noconsole norescan
2224 prompt revprompt revunmerged title
2229 local pfx="${cur%.*}." cur_="${cur##*.}"
2230 __gitcomp "cmd path" "$pfx" "$cur_"
2234 local pfx="${cur%.*}." cur_="${cur##*.}"
2235 __gitcomp "cmd path" "$pfx" "$cur_"
2239 local pfx="${cur%.*}." cur_="${cur##*.}"
2240 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
2244 local pfx="${cur%.*}." cur_="${cur#*.}"
2245 __git_compute_all_commands
2246 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
2250 local pfx="${cur%.*}." cur_="${cur##*.}"
2252 url proxy fetch push mirror skipDefaultUpdate
2253 receivepack uploadpack tagopt pushurl
2258 local pfx="${cur%.*}." cur_="${cur#*.}"
2259 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
2260 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
2264 local pfx="${cur%.*}." cur_="${cur##*.}"
2265 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
2272 advice.commitBeforeMerge
2274 advice.implicitIdentity
2275 advice.pushAlreadyExists
2276 advice.pushFetchFirst
2277 advice.pushNeedsForce
2278 advice.pushNonFFCurrent
2279 advice.pushNonFFMatching
2280 advice.pushUpdateRejected
2281 advice.resolveConflict
2284 advice.statusUoption
2289 apply.ignorewhitespace
2291 branch.autosetupmerge
2292 branch.autosetuprebase
2296 color.branch.current
2301 color.decorate.branch
2302 color.decorate.remoteBranch
2303 color.decorate.stash
2313 color.diff.whitespace
2318 color.grep.linenumber
2321 color.grep.separator
2323 color.interactive.error
2324 color.interactive.header
2325 color.interactive.help
2326 color.interactive.prompt
2331 color.status.changed
2333 color.status.localBranch
2334 color.status.nobranch
2335 color.status.remoteBranch
2336 color.status.unmerged
2337 color.status.untracked
2338 color.status.updated
2350 core.bigFileThreshold
2356 core.deltaBaseCacheLimit
2361 core.fsyncobjectfiles
2367 core.logAllRefUpdates
2368 core.loosecompression
2371 core.packedGitWindowSize
2372 core.packedRefsTimeout
2374 core.precomposeUnicode
2375 core.preferSymlinkRefs
2380 core.repositoryFormatVersion
2382 core.sharedRepository
2389 core.warnAmbiguousRefs
2393 credential.useHttpPath
2395 credentialCache.ignoreSIGHUP
2396 diff.autorefreshindex
2398 diff.ignoreSubmodules
2405 diff.suppressBlankEmpty
2411 fetch.recurseSubmodules
2422 format.subjectprefix
2436 gc.reflogexpireunreachable
2439 gc.worktreePruneExpire
2441 gitcvs.commitmsgannotation
2442 gitcvs.dbTableNamePrefix
2453 gui.copyblamethreshold
2457 gui.matchtrackingbranch
2458 gui.newbranchtemplate
2459 gui.pruneduringfetch
2460 gui.spellingdictionary
2477 http.sslCertPasswordProtected
2482 i18n.logOutputEncoding
2488 imap.preformattedHTML
2498 interactive.singlekey
2514 mergetool.keepBackup
2515 mergetool.keepTemporaries
2520 notes.rewrite.rebase
2524 pack.deltaCacheLimit
2541 receive.denyCurrentBranch
2542 receive.denyDeleteCurrent
2544 receive.denyNonFastForwards
2547 receive.updateserverinfo
2550 repack.usedeltabaseoffset
2554 sendemail.aliasesfile
2555 sendemail.aliasfiletype
2559 sendemail.chainreplyto
2561 sendemail.envelopesender
2565 sendemail.signedoffbycc
2566 sendemail.smtpdomain
2567 sendemail.smtpencryption
2569 sendemail.smtpserver
2570 sendemail.smtpserveroption
2571 sendemail.smtpserverport
2573 sendemail.suppresscc
2574 sendemail.suppressfrom
2579 sendemail.smtpbatchsize
2580 sendemail.smtprelogindelay
2582 status.relativePaths
2583 status.showUntrackedFiles
2584 status.submodulesummary
2587 transfer.unpackLimit
2600 add rename remove set-head set-branches
2601 get-url set-url show prune update
2603 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2604 if [ -z "$subcommand" ]; then
2607 __gitcomp_builtin remote
2610 __gitcomp "$subcommands"
2616 case "$subcommand,$cur" in
2618 __gitcomp_builtin remote_add "--no-tags"
2623 __gitcomp_builtin remote_set-head
2626 __gitcomp_builtin remote_set-branches
2628 set-head,*|set-branches,*)
2629 __git_complete_remote_or_refspec
2632 __gitcomp_builtin remote_update
2635 __gitcomp "$(__git_get_config_variables "remotes")"
2638 __gitcomp_builtin remote_set-url
2641 __gitcomp_builtin remote_get-url
2644 __gitcomp_builtin remote_prune
2647 __gitcomp_nl "$(__git_remotes)"
2656 __gitcomp_builtin replace
2665 local subcommands="clear forget diff remaining status gc"
2666 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2667 if test -z "$subcommand"
2669 __gitcomp "$subcommands"
2676 __git_has_doubledash && return
2680 __gitcomp_builtin reset
2687 __git_revert_inprogress_options="--continue --quit --abort"
2691 __git_find_repo_path
2692 if [ -f "$__git_repo_path"/REVERT_HEAD ]; then
2693 __gitcomp "$__git_revert_inprogress_options"
2698 __gitcomp_builtin revert "--no-edit" \
2699 "$__git_revert_inprogress_options"
2710 __gitcomp_builtin rm
2715 __git_complete_index_file "--cached"
2720 __git_has_doubledash && return
2725 $__git_log_common_options
2726 $__git_log_shortlog_options
2727 --numbered --summary --email
2732 __git_complete_revlist
2737 __git_has_doubledash && return
2740 --pretty=*|--format=*)
2741 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2746 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2750 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
2754 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2756 $__git_diff_common_options
2761 __git_complete_revlist_file
2768 __gitcomp_builtin show-branch "--no-color"
2772 __git_complete_revlist
2777 local save_opts='--all --keep-index --no-keep-index --quiet --patch --include-untracked'
2778 local subcommands='push list show apply clear drop pop create branch'
2779 local subcommand="$(__git_find_on_cmdline "$subcommands save")"
2780 if [ -n "$(__git_find_on_cmdline "-p")" ]; then
2783 if [ -z "$subcommand" ]; then
2786 __gitcomp "$save_opts"
2789 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2794 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2795 __gitcomp "$subcommands"
2800 case "$subcommand,$cur" in
2802 __gitcomp "$save_opts --message"
2805 __gitcomp "$save_opts"
2808 __gitcomp "--index --quiet"
2813 show,--*|branch,--*)
2816 if [ $cword -eq 3 ]; then
2819 __gitcomp_nl "$(__git stash list \
2820 | sed -n -e 's/:.*//p')"
2823 show,*|apply,*|drop,*|pop,*)
2824 __gitcomp_nl "$(__git stash list \
2825 | sed -n -e 's/:.*//p')"
2835 __git_has_doubledash && return
2837 local subcommands="add status init deinit update summary foreach sync"
2838 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2839 if [ -z "$subcommand" ]; then
2845 __gitcomp "$subcommands"
2851 case "$subcommand,$cur" in
2853 __gitcomp "--branch --force --name --reference --depth"
2856 __gitcomp "--cached --recursive"
2859 __gitcomp "--force --all"
2863 --init --remote --no-fetch
2864 --recommend-shallow --no-recommend-shallow
2865 --force --rebase --merge --reference --depth --recursive --jobs
2869 __gitcomp "--cached --files --summary-limit"
2871 foreach,--*|sync,--*)
2872 __gitcomp "--recursive"
2882 init fetch clone rebase dcommit log find-rev
2883 set-tree commit-diff info create-ignore propget
2884 proplist show-ignore show-externals branch tag blame
2885 migrate mkdirs reset gc
2887 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2888 if [ -z "$subcommand" ]; then
2889 __gitcomp "$subcommands"
2891 local remote_opts="--username= --config-dir= --no-auth-cache"
2893 --follow-parent --authors-file= --repack=
2894 --no-metadata --use-svm-props --use-svnsync-props
2895 --log-window-size= --no-checkout --quiet
2896 --repack-flags --use-log-author --localtime
2898 --ignore-paths= --include-paths= $remote_opts
2901 --template= --shared= --trunk= --tags=
2902 --branches= --stdlayout --minimize-url
2903 --no-metadata --use-svm-props --use-svnsync-props
2904 --rewrite-root= --prefix= $remote_opts
2907 --edit --rmdir --find-copies-harder --copy-similarity=
2910 case "$subcommand,$cur" in
2912 __gitcomp "--revision= --fetch-all $fc_opts"
2915 __gitcomp "--revision= $fc_opts $init_opts"
2918 __gitcomp "$init_opts"
2922 --merge --strategy= --verbose --dry-run
2923 --fetch-all --no-rebase --commit-url
2924 --revision --interactive $cmt_opts $fc_opts
2928 __gitcomp "--stdin $cmt_opts $fc_opts"
2930 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2931 show-externals,--*|mkdirs,--*)
2932 __gitcomp "--revision="
2936 --limit= --revision= --verbose --incremental
2937 --oneline --show-commit --non-recursive
2938 --authors-file= --color
2943 --merge --verbose --strategy= --local
2944 --fetch-all --dry-run $fc_opts
2948 __gitcomp "--message= --file= --revision= $cmt_opts"
2954 __gitcomp "--dry-run --message --tag"
2957 __gitcomp "--dry-run --message"
2960 __gitcomp "--git-format"
2964 --config-dir= --ignore-paths= --minimize
2965 --no-auth-cache --username=
2969 __gitcomp "--revision= --parent"
2980 while [ $c -lt $cword ]; do
2983 -d|--delete|-v|--verify)
2984 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2999 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
3009 __gitcomp_builtin tag
3021 local subcommands="add list lock move prune remove unlock"
3022 local subcommand="$(__git_find_on_cmdline "$subcommands")"
3023 if [ -z "$subcommand" ]; then
3024 __gitcomp "$subcommands"
3026 case "$subcommand,$cur" in
3028 __gitcomp_builtin worktree_add
3031 __gitcomp_builtin worktree_list
3034 __gitcomp_builtin worktree_lock
3037 __gitcomp_builtin worktree_prune
3048 __git_complete_common () {
3053 __gitcomp_builtin "$command"
3058 __git_cmds_with_parseopt_helper=
3059 __git_support_parseopt_helper () {
3060 test -n "$__git_cmds_with_parseopt_helper" ||
3061 __git_cmds_with_parseopt_helper="$(__git --list-parseopt-builtins)"
3063 case " $__git_cmds_with_parseopt_helper " in
3073 __git_complete_command () {
3075 local completion_func="_git_${command//-/_}"
3076 if ! declare -f $completion_func >/dev/null 2>/dev/null &&
3077 declare -f _completion_loader >/dev/null 2>/dev/null
3079 _completion_loader "git-$command"
3081 if declare -f $completion_func >/dev/null 2>/dev/null
3085 elif __git_support_parseopt_helper "$command"
3087 __git_complete_common "$command"
3096 local i c=1 command __git_dir __git_repo_path
3097 local __git_C_args C_args_count=0
3099 while [ $c -lt $cword ]; do
3102 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
3103 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
3104 --bare) __git_dir="." ;;
3105 --help) command="help"; break ;;
3106 -c|--work-tree|--namespace) ((c++)) ;;
3107 -C) __git_C_args[C_args_count++]=-C
3109 __git_C_args[C_args_count++]="${words[c]}"
3112 *) command="$i"; break ;;
3117 if [ -z "$command" ]; then
3119 --git-dir|-C|--work-tree)
3120 # these need a path argument, let's fall back to
3121 # Bash filename completion
3125 # we don't support completing these options' arguments
3143 --no-replace-objects
3147 *) __git_compute_porcelain_commands
3148 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
3153 __git_complete_command "$command" && return
3155 local expansion=$(__git_aliased_command "$command")
3156 if [ -n "$expansion" ]; then
3158 __git_complete_command "$expansion"
3164 __git_has_doubledash && return
3166 local __git_repo_path
3167 __git_find_repo_path
3170 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
3176 $__git_log_common_options
3177 $__git_log_gitk_options
3183 __git_complete_revlist
3186 if [[ -n ${ZSH_VERSION-} ]]; then
3187 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
3189 autoload -U +X compinit && compinit
3195 local cur_="${3-$cur}"
3201 local c IFS=$' \t\n'
3209 array[${#array[@]}+1]="$c"
3212 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
3223 compadd -Q -- ${=1} && _ret=0
3232 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
3241 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
3246 local _ret=1 cur cword prev
3247 cur=${words[CURRENT]}
3248 prev=${words[CURRENT-1]}
3250 emulate ksh -c __${service}_main
3251 let _ret && _default && _ret=0
3255 compdef _git git gitk
3261 local cur words cword prev
3262 _get_comp_words_by_ref -n =: cur words cword prev
3266 # Setup completion for certain functions defined above by setting common
3267 # variables and workarounds.
3268 # This is NOT a public function; use at your own risk.
3271 local wrapper="__git_wrap${2}"
3272 eval "$wrapper () { __git_func_wrap $2 ; }"
3273 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
3274 || complete -o default -o nospace -F $wrapper $1
3277 # wrapper for backwards compatibility
3280 __git_wrap__git_main
3283 # wrapper for backwards compatibility
3286 __git_wrap__gitk_main
3289 __git_complete git __git_main
3290 __git_complete gitk __gitk_main
3292 # The following are necessary only for Cygwin, and only are needed
3293 # when the user has tab-completed the executable name and consequently
3294 # included the '.exe' suffix.
3296 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
3297 __git_complete git.exe __git_main