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 # and git-switch completion (e.g., completing "foo" when "origin/foo"
43 case "$COMP_WORDBREAKS" in
45 *) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
48 # Discovers the path to the git repository taking any '--git-dir=<path>' and
49 # '-C <path>' options into account and stores it in the $__git_repo_path
51 __git_find_repo_path ()
53 if [ -n "$__git_repo_path" ]; then
54 # we already know where it is
58 if [ -n "${__git_C_args-}" ]; then
59 __git_repo_path="$(git "${__git_C_args[@]}" \
60 ${__git_dir:+--git-dir="$__git_dir"} \
61 rev-parse --absolute-git-dir 2>/dev/null)"
62 elif [ -n "${__git_dir-}" ]; then
63 test -d "$__git_dir" &&
64 __git_repo_path="$__git_dir"
65 elif [ -n "${GIT_DIR-}" ]; then
66 test -d "${GIT_DIR-}" &&
67 __git_repo_path="$GIT_DIR"
68 elif [ -d .git ]; then
71 __git_repo_path="$(git rev-parse --git-dir 2>/dev/null)"
75 # Deprecated: use __git_find_repo_path() and $__git_repo_path instead
76 # __gitdir accepts 0 or 1 arguments (i.e., location)
77 # returns location of .git repo
80 if [ -z "${1-}" ]; then
81 __git_find_repo_path || return 1
82 echo "$__git_repo_path"
83 elif [ -d "$1/.git" ]; then
90 # Runs git with all the options given as argument, respecting any
91 # '--git-dir=<path>' and '-C <path>' options present on the command line
94 git ${__git_C_args:+"${__git_C_args[@]}"} \
95 ${__git_dir:+--git-dir="$__git_dir"} "$@" 2>/dev/null
98 # Removes backslash escaping, single quotes and double quotes from a word,
99 # stores the result in the variable $dequoted_word.
100 # 1: The word to dequote.
103 local rest="$1" len ch
107 while test -n "$rest"; do
108 len=${#dequoted_word}
109 dequoted_word="$dequoted_word${rest%%[\\\'\"]*}"
110 rest="${rest:$((${#dequoted_word}-$len))}"
112 case "${rest:0:1}" in
119 dequoted_word="$dequoted_word$ch"
126 len=${#dequoted_word}
127 dequoted_word="$dequoted_word${rest%%\'*}"
128 rest="${rest:$((${#dequoted_word}-$len+1))}"
132 while test -n "$rest" ; do
133 len=${#dequoted_word}
134 dequoted_word="$dequoted_word${rest%%[\\\"]*}"
135 rest="${rest:$((${#dequoted_word}-$len))}"
136 case "${rest:0:1}" in
141 dequoted_word="$dequoted_word$ch"
146 dequoted_word="$dequoted_word\\$ch"
162 # The following function is based on code from:
164 # bash_completion - programmable completion functions for bash 3.2+
166 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
167 # © 2009-2010, Bash Completion Maintainers
168 # <bash-completion-devel@lists.alioth.debian.org>
170 # This program is free software; you can redistribute it and/or modify
171 # it under the terms of the GNU General Public License as published by
172 # the Free Software Foundation; either version 2, or (at your option)
175 # This program is distributed in the hope that it will be useful,
176 # but WITHOUT ANY WARRANTY; without even the implied warranty of
177 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
178 # GNU General Public License for more details.
180 # You should have received a copy of the GNU General Public License
181 # along with this program; if not, see <http://www.gnu.org/licenses/>.
183 # The latest version of this software can be obtained here:
185 # http://bash-completion.alioth.debian.org/
189 # This function can be used to access a tokenized list of words
190 # on the command line:
192 # __git_reassemble_comp_words_by_ref '=:'
193 # if test "${words_[cword_-1]}" = -w
198 # The argument should be a collection of characters from the list of
199 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
202 # This is roughly equivalent to going back in time and setting
203 # COMP_WORDBREAKS to exclude those characters. The intent is to
204 # make option types like --date=<type> and <rev>:<path> easy to
205 # recognize by treating each shell word as a single token.
207 # It is best not to set COMP_WORDBREAKS directly because the value is
208 # shared with other completion scripts. By the time the completion
209 # function gets called, COMP_WORDS has already been populated so local
210 # changes to COMP_WORDBREAKS have no effect.
212 # Output: words_, cword_, cur_.
214 __git_reassemble_comp_words_by_ref()
216 local exclude i j first
217 # Which word separators to exclude?
218 exclude="${1//[^$COMP_WORDBREAKS]}"
220 if [ -z "$exclude" ]; then
221 words_=("${COMP_WORDS[@]}")
224 # List of word completion separators has shrunk;
225 # re-assemble words to complete.
226 for ((i=0, j=0; i < ${#COMP_WORDS[@]}; i++, j++)); do
227 # Append each nonempty word consisting of just
228 # word separator characters to the current word.
232 [ -n "${COMP_WORDS[$i]}" ] &&
233 # word consists of excluded word separators
234 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
236 # Attach to the previous token,
237 # unless the previous token is the command name.
238 if [ $j -ge 2 ] && [ -n "$first" ]; then
242 words_[$j]=${words_[j]}${COMP_WORDS[i]}
243 if [ $i = $COMP_CWORD ]; then
246 if (($i < ${#COMP_WORDS[@]} - 1)); then
253 words_[$j]=${words_[j]}${COMP_WORDS[i]}
254 if [ $i = $COMP_CWORD ]; then
260 if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
261 _get_comp_words_by_ref ()
263 local exclude cur_ words_ cword_
264 if [ "$1" = "-n" ]; then
268 __git_reassemble_comp_words_by_ref "$exclude"
269 cur_=${words_[cword_]}
270 while [ $# -gt 0 ]; do
276 prev=${words_[$cword_-1]}
279 words=("${words_[@]}")
290 # Fills the COMPREPLY array with prefiltered words without any additional
292 # Callers must take care of providing only words that match the current word
293 # to be completed and adding any prefix and/or suffix (trailing space!), if
295 # 1: List of newline-separated matching completion words, complete with
306 local x i=${#COMPREPLY[@]}
308 if [[ "$x" == "$3"* ]]; then
309 COMPREPLY[i++]="$2$x$4"
320 # Generates completion reply, appending a space to possible completion words,
322 # It accepts 1 to 4 arguments:
323 # 1: List of possible completion words.
324 # 2: A prefix to be added to each possible completion word (optional).
325 # 3: Generate possible completion matches for this word (optional).
326 # 4: A suffix to be appended to each possible completion word (optional).
329 local cur_="${3-$cur}"
335 local c i=0 IFS=$' \t\n'
337 if [[ $c == "--" ]]; then
341 if [[ $c == "$cur_"* ]]; then
346 COMPREPLY[i++]="${2-}$c"
351 local c i=0 IFS=$' \t\n'
353 if [[ $c == "--" ]]; then
355 if [[ $c == "$cur_"* ]]; then
356 COMPREPLY[i++]="${2-}$c "
361 if [[ $c == "$cur_"* ]]; then
366 COMPREPLY[i++]="${2-}$c"
373 # Clear the variables caching builtins' options when (re-)sourcing
374 # the completion script.
375 if [[ -n ${ZSH_VERSION-} ]]; then
376 unset $(set |sed -ne 's/^\(__gitcomp_builtin_[a-zA-Z0-9_][a-zA-Z0-9_]*\)=.*/\1/p') 2>/dev/null
378 unset $(compgen -v __gitcomp_builtin_)
381 # This function is equivalent to
383 # __gitcomp "$(git xxx --git-completion-helper) ..."
385 # except that the output is cached. Accept 1-3 arguments:
386 # 1: the git command to execute, this is also the cache key
387 # 2: extra options to be added on top (e.g. negative forms)
388 # 3: options to be excluded
391 # spaces must be replaced with underscore for multi-word
392 # commands, e.g. "git remote add" becomes remote_add.
397 local var=__gitcomp_builtin_"${cmd/-/_}"
399 eval "options=\$$var"
401 if [ -z "$options" ]; then
402 # leading and trailing spaces are significant to make
403 # option removal work correctly.
404 options=" $incl $(__git ${cmd/_/ } --git-completion-helper) "
406 options="${options/ $i / }"
408 eval "$var=\"$options\""
414 # Variation of __gitcomp_nl () that appends to the existing list of
415 # completion candidates, COMPREPLY.
416 __gitcomp_nl_append ()
419 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
422 # Generates completion reply from newline-separated possible completion words
423 # by appending a space to all of them.
424 # It accepts 1 to 4 arguments:
425 # 1: List of possible completion words, separated by a single newline.
426 # 2: A prefix to be added to each possible completion word (optional).
427 # 3: Generate possible completion matches for this word (optional).
428 # 4: A suffix to be appended to each possible completion word instead of
429 # the default space (optional). If specified but empty, nothing is
434 __gitcomp_nl_append "$@"
437 # Fills the COMPREPLY array with prefiltered paths without any additional
439 # Callers must take care of providing only paths that match the current path
440 # to be completed and adding any prefix path components, if necessary.
441 # 1: List of newline-separated matching paths, complete with all prefix
443 __gitcomp_file_direct ()
449 # use a hack to enable file mode in bash < 4
450 compopt -o filenames +o nospace 2>/dev/null ||
451 compgen -f /non-existing-dir/ >/dev/null ||
455 # Generates completion reply with compgen from newline-separated possible
456 # completion filenames.
457 # It accepts 1 to 3 arguments:
458 # 1: List of possible completion filenames, separated by a single newline.
459 # 2: A directory prefix to be added to each possible completion filename
461 # 3: Generate possible completion matches for this word (optional).
466 # XXX does not work when the directory prefix contains a tilde,
467 # since tilde expansion is not applied.
468 # This means that COMPREPLY will be empty and Bash default
469 # completion will be used.
470 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
472 # use a hack to enable file mode in bash < 4
473 compopt -o filenames +o nospace 2>/dev/null ||
474 compgen -f /non-existing-dir/ >/dev/null ||
478 # Execute 'git ls-files', unless the --committable option is specified, in
479 # which case it runs 'git diff-index' to find out the files that can be
480 # committed. It return paths relative to the directory specified in the first
481 # argument, and using the options specified in the second argument.
482 __git_ls_files_helper ()
484 if [ "$2" == "--committable" ]; then
485 __git -C "$1" -c core.quotePath=false diff-index \
486 --name-only --relative HEAD -- "${3//\\/\\\\}*"
488 # NOTE: $2 is not quoted in order to support multiple options
489 __git -C "$1" -c core.quotePath=false ls-files \
490 --exclude-standard $2 -- "${3//\\/\\\\}*"
495 # __git_index_files accepts 1 or 2 arguments:
496 # 1: Options to pass to ls-files (required).
497 # 2: A directory path (optional).
498 # If provided, only files within the specified directory are listed.
499 # Sub directories are never recursed. Path must have a trailing
501 # 3: List only paths matching this path component (optional).
504 local root="$2" match="$3"
506 __git_ls_files_helper "$root" "$1" "$match" |
507 awk -F / -v pfx="${2//\\/\\\\}" '{
512 if (substr(p, 1, 1) != "\"") {
513 # No special characters, easy!
518 # The path is quoted.
523 # Even when a directory name itself does not contain
524 # any special characters, it will still be quoted if
525 # any of its (stripped) trailing path components do.
526 # Because of this we may have seen the same direcory
527 # both quoted and unquoted.
529 # We have seen the same directory unquoted,
536 function dequote(p, bs_idx, out, esc, esc_idx, dec) {
537 # Skip opening double quote.
540 # Interpret backslash escape sequences.
541 while ((bs_idx = index(p, "\\")) != 0) {
542 out = out substr(p, 1, bs_idx - 1)
543 esc = substr(p, bs_idx + 1, 1)
544 p = substr(p, bs_idx + 2)
546 if ((esc_idx = index("abtvfr\"\\", esc)) != 0) {
547 # C-style one-character escape sequence.
548 out = out substr("\a\b\t\v\f\r\"\\",
550 } else if (esc == "n") {
551 # Uh-oh, a newline character.
552 # We cant reliably put a pathname
553 # containing a newline into COMPREPLY,
554 # and the newline would create a mess.
558 # Must be a \nnn octal value, then.
560 substr(p, 1, 1) * 8 + \
562 out = out sprintf("%c", dec)
566 # Drop closing double quote, if there is one.
567 # (There isnt any if this is a directory, as it was
568 # already stripped with the trailing path components.)
569 if (substr(p, length(p), 1) == "\"")
570 out = out substr(p, 1, length(p) - 1)
578 # __git_complete_index_file requires 1 argument:
579 # 1: the options to pass to ls-file
581 # The exception is --committable, which finds the files appropriate commit.
582 __git_complete_index_file ()
584 local dequoted_word pfx="" cur_
588 case "$dequoted_word" in
590 pfx="${dequoted_word%/*}/"
591 cur_="${dequoted_word##*/}"
594 cur_="$dequoted_word"
597 __gitcomp_file_direct "$(__git_index_files "$1" "$pfx" "$cur_")"
600 # Lists branches from the local repository.
601 # 1: A prefix to be added to each listed branch (optional).
602 # 2: List only branches matching this word (optional; list all branches if
604 # 3: A suffix to be appended to each listed branch (optional).
607 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
609 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
610 "refs/heads/$cur_*" "refs/heads/$cur_*/**"
613 # Lists tags from the local repository.
614 # Accepts the same positional parameters as __git_heads() above.
617 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
619 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
620 "refs/tags/$cur_*" "refs/tags/$cur_*/**"
623 # Lists refs from the local (by default) or from a remote repository.
624 # It accepts 0, 1 or 2 arguments:
625 # 1: The remote to list refs from (optional; ignored, if set but empty).
626 # Can be the name of a configured remote, a path, or a URL.
627 # 2: In addition to local refs, list unique branches from refs/remotes/ for
628 # 'git checkout's tracking DWIMery (optional; ignored, if set but empty).
629 # 3: A prefix to be added to each listed ref (optional).
630 # 4: List only refs matching this word (optional; list all refs if unset or
632 # 5: A suffix to be appended to each listed ref (optional; ignored, if set
635 # Use __git_complete_refs() instead.
638 local i hash dir track="${2-}"
639 local list_refs_from=path remote="${1-}"
641 local pfx="${3-}" cur_="${4-$cur}" sfx="${5-}"
643 local fer_pfx="${pfx//\%/%%}" # "escape" for-each-ref format specifiers
646 dir="$__git_repo_path"
648 if [ -z "$remote" ]; then
649 if [ -z "$dir" ]; then
653 if __git_is_configured_remote "$remote"; then
654 # configured remote takes precedence over a
655 # local directory with the same name
656 list_refs_from=remote
657 elif [ -d "$remote/.git" ]; then
659 elif [ -d "$remote" ]; then
666 if [ "$list_refs_from" = path ]; then
667 if [[ "$cur_" == ^* ]]; then
676 refs=("$match*" "$match*/**")
680 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD REBASE_HEAD; do
683 if [ -e "$dir/$i" ]; then
689 format="refname:strip=2"
690 refs=("refs/tags/$match*" "refs/tags/$match*/**"
691 "refs/heads/$match*" "refs/heads/$match*/**"
692 "refs/remotes/$match*" "refs/remotes/$match*/**")
695 __git_dir="$dir" __git for-each-ref --format="$fer_pfx%($format)$sfx" \
697 if [ -n "$track" ]; then
698 # employ the heuristic used by git checkout
699 # Try to find a remote branch that matches the completion word
700 # but only output if the branch name is unique
701 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
702 --sort="refname:strip=3" \
703 "refs/remotes/*/$match*" "refs/remotes/*/$match*/**" | \
710 __git ls-remote "$remote" "$match*" | \
711 while read -r hash i; do
714 *) echo "$pfx$i$sfx" ;;
719 if [ "$list_refs_from" = remote ]; then
721 $match*) echo "${pfx}HEAD$sfx" ;;
723 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
724 "refs/remotes/$remote/$match*" \
725 "refs/remotes/$remote/$match*/**"
729 $match*) query_symref="HEAD" ;;
731 __git ls-remote "$remote" $query_symref \
732 "refs/tags/$match*" "refs/heads/$match*" \
733 "refs/remotes/$match*" |
734 while read -r hash i; do
737 refs/*) echo "$pfx${i#refs/*/}$sfx" ;;
738 *) echo "$pfx$i$sfx" ;; # symbolic refs
746 # Completes refs, short and long, local and remote, symbolic and pseudo.
748 # Usage: __git_complete_refs [<option>]...
749 # --remote=<remote>: The remote to list refs from, can be the name of a
750 # configured remote, a path, or a URL.
751 # --track: List unique remote branches for 'git checkout's tracking DWIMery.
752 # --pfx=<prefix>: A prefix to be added to each ref.
753 # --cur=<word>: The current ref to be completed. Defaults to the current
754 # word to be completed.
755 # --sfx=<suffix>: A suffix to be appended to each ref instead of the default
757 __git_complete_refs ()
759 local remote track pfx cur_="$cur" sfx=" "
761 while test $# != 0; do
763 --remote=*) remote="${1##--remote=}" ;;
764 --track) track="yes" ;;
765 --pfx=*) pfx="${1##--pfx=}" ;;
766 --cur=*) cur_="${1##--cur=}" ;;
767 --sfx=*) sfx="${1##--sfx=}" ;;
773 __gitcomp_direct "$(__git_refs "$remote" "$track" "$pfx" "$cur_" "$sfx")"
776 # __git_refs2 requires 1 argument (to pass to __git_refs)
777 # Deprecated: use __git_complete_fetch_refspecs() instead.
781 for i in $(__git_refs "$1"); do
786 # Completes refspecs for fetching from a remote repository.
787 # 1: The remote repository.
788 # 2: A prefix to be added to each listed refspec (optional).
789 # 3: The ref to be completed as a refspec instead of the current word to be
790 # completed (optional)
791 # 4: A suffix to be appended to each listed refspec instead of the default
793 __git_complete_fetch_refspecs ()
795 local i remote="$1" pfx="${2-}" cur_="${3-$cur}" sfx="${4- }"
798 for i in $(__git_refs "$remote" "" "" "$cur_") ; do
804 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
805 __git_refs_remotes ()
808 __git ls-remote "$1" 'refs/heads/*' | \
809 while read -r hash i; do
810 echo "$i:refs/remotes/$1/${i#refs/heads/}"
817 test -d "$__git_repo_path/remotes" && ls -1 "$__git_repo_path/remotes"
821 # Returns true if $1 matches the name of a configured remote, false otherwise.
822 __git_is_configured_remote ()
825 for remote in $(__git_remotes); do
826 if [ "$remote" = "$1" ]; then
833 __git_list_merge_strategies ()
835 LANG=C LC_ALL=C git merge -s help 2>&1 |
836 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
845 __git_merge_strategies=
846 # 'git merge -s help' (and thus detection of the merge strategy
847 # list) fails, unfortunately, if run outside of any git working
848 # tree. __git_merge_strategies is set to the empty string in
849 # that case, and the detection will be repeated the next time it
851 __git_compute_merge_strategies ()
853 test -n "$__git_merge_strategies" ||
854 __git_merge_strategies=$(__git_list_merge_strategies)
857 __git_merge_strategy_options="ours theirs subtree subtree= patience
858 histogram diff-algorithm= ignore-space-change ignore-all-space
859 ignore-space-at-eol renormalize no-renormalize no-renames
860 find-renames find-renames= rename-threshold="
862 __git_complete_revlist_file ()
864 local dequoted_word pfx ls ref cur_="$cur"
873 __git_dequote "$cur_"
875 case "$dequoted_word" in
877 pfx="${dequoted_word%/*}"
878 cur_="${dequoted_word##*/}"
883 cur_="$dequoted_word"
888 case "$COMP_WORDBREAKS" in
890 *) pfx="$ref:$pfx" ;;
893 __gitcomp_file "$(__git ls-tree "$ls" \
899 pfx="${cur_%...*}..."
901 __git_complete_refs --pfx="$pfx" --cur="$cur_"
906 __git_complete_refs --pfx="$pfx" --cur="$cur_"
914 __git_complete_file ()
916 __git_complete_revlist_file
919 __git_complete_revlist ()
921 __git_complete_revlist_file
924 __git_complete_remote_or_refspec ()
926 local cur_="$cur" cmd="${words[1]}"
927 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
928 if [ "$cmd" = "remote" ]; then
931 while [ $c -lt $cword ]; do
934 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
935 -d|--delete) [ "$cmd" = "push" ] && lhs=0 ;;
938 push) no_complete_refspec=1 ;;
945 --multiple) no_complete_refspec=1; break ;;
947 *) remote="$i"; break ;;
951 if [ -z "$remote" ]; then
952 __gitcomp_nl "$(__git_remotes)"
955 if [ $no_complete_refspec = 1 ]; then
958 [ "$remote" = "." ] && remote=
961 case "$COMP_WORDBREAKS" in
963 *) pfx="${cur_%%:*}:" ;;
975 if [ $lhs = 1 ]; then
976 __git_complete_fetch_refspecs "$remote" "$pfx" "$cur_"
978 __git_complete_refs --pfx="$pfx" --cur="$cur_"
982 if [ $lhs = 1 ]; then
983 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
985 __git_complete_refs --pfx="$pfx" --cur="$cur_"
989 if [ $lhs = 1 ]; then
990 __git_complete_refs --pfx="$pfx" --cur="$cur_"
992 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
998 __git_complete_strategy ()
1000 __git_compute_merge_strategies
1003 __gitcomp "$__git_merge_strategies"
1007 __gitcomp "$__git_merge_strategy_options"
1013 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
1016 --strategy-option=*)
1017 __gitcomp "$__git_merge_strategy_options" "" "${cur##--strategy-option=}"
1025 __git_compute_all_commands ()
1027 test -n "$__git_all_commands" ||
1028 __git_all_commands=$(git --list-cmds=main,others,alias,nohelpers)
1031 # Lists all set config variables starting with the given section prefix,
1032 # with the prefix removed.
1033 __git_get_config_variables ()
1035 local section="$1" i IFS=$'\n'
1036 for i in $(__git config --name-only --get-regexp "^$section\..*"); do
1037 echo "${i#$section.}"
1041 __git_pretty_aliases ()
1043 __git_get_config_variables "pretty"
1046 # __git_aliased_command requires 1 argument
1047 __git_aliased_command ()
1049 local word cmdline=$(__git config --get "alias.$1")
1050 for word in $cmdline; do
1056 \!*) : shell command alias ;;
1058 *=*) : setting env ;;
1059 git) : git itself ;;
1060 \(\)) : skip parens of shell function definition ;;
1061 {) : skip start of shell helper function ;;
1062 :) : skip null command ;;
1063 \'*) : skip opening quote after sh -c ;;
1071 # __git_find_on_cmdline requires 1 argument
1072 __git_find_on_cmdline ()
1074 local word subcommand c=1
1075 while [ $c -lt $cword ]; do
1077 for subcommand in $1; do
1078 if [ "$subcommand" = "$word" ]; then
1087 # Echo the value of an option set on the command line or config
1089 # $1: short option name
1090 # $2: long option name including =
1091 # $3: list of possible values
1092 # $4: config string (optional)
1095 # result="$(__git_get_option_value "-d" "--do-something=" \
1096 # "yes no" "core.doSomething")"
1098 # result is then either empty (no option set) or "yes" or "no"
1100 # __git_get_option_value requires 3 arguments
1101 __git_get_option_value ()
1103 local c short_opt long_opt val
1104 local result= values config_key word
1112 while [ $c -ge 0 ]; do
1114 for val in $values; do
1115 if [ "$short_opt$val" = "$word" ] ||
1116 [ "$long_opt$val" = "$word" ]; then
1124 if [ -n "$config_key" ] && [ -z "$result" ]; then
1125 result="$(__git config "$config_key")"
1131 __git_has_doubledash ()
1134 while [ $c -lt $cword ]; do
1135 if [ "--" = "${words[c]}" ]; then
1143 # Try to count non option arguments passed on the command line for the
1144 # specified git command.
1145 # When options are used, it is necessary to use the special -- option to
1146 # tell the implementation were non option arguments begin.
1147 # XXX this can not be improved, since options can appear everywhere, as
1151 # __git_count_arguments requires 1 argument: the git command executed.
1152 __git_count_arguments ()
1156 # Skip "git" (first argument)
1157 for ((i=1; i < ${#words[@]}; i++)); do
1162 # Good; we can assume that the following are only non
1167 # Skip the specified git command and discard git
1180 __git_whitespacelist="nowarn warn error error-all fix"
1181 __git_patchformat="mbox stgit stgit-series hg mboxrd"
1182 __git_am_inprogress_options="--skip --continue --resolved --abort --quit --show-current-patch"
1186 __git_find_repo_path
1187 if [ -d "$__git_repo_path"/rebase-apply ]; then
1188 __gitcomp "$__git_am_inprogress_options"
1193 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1197 __gitcomp "$__git_patchformat" "" "${cur##--patch-format=}"
1201 __gitcomp_builtin am "" \
1202 "$__git_am_inprogress_options"
1211 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1215 __gitcomp_builtin apply
1224 __gitcomp "+x -x" "" "${cur##--chmod=}"
1228 __gitcomp_builtin add
1232 local complete_opt="--others --modified --directory --no-empty-directory"
1233 if test -n "$(__git_find_on_cmdline "-u --update")"
1235 complete_opt="--modified"
1237 __git_complete_index_file "$complete_opt"
1244 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
1248 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
1253 --format= --list --verbose
1254 --prefix= --remote= --exec= --output
1264 __git_has_doubledash && return
1266 local subcommands="start bad good skip reset visualize replay log run"
1267 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1268 if [ -z "$subcommand" ]; then
1269 __git_find_repo_path
1270 if [ -f "$__git_repo_path"/BISECT_START ]; then
1271 __gitcomp "$subcommands"
1273 __gitcomp "replay start"
1278 case "$subcommand" in
1279 bad|good|reset|skip|start)
1287 __git_ref_fieldlist="refname objecttype objectsize objectname upstream push HEAD symref"
1291 local i c=1 only_local_ref="n" has_r="n"
1293 while [ $c -lt $cword ]; do
1296 -d|--delete|-m|--move) only_local_ref="y" ;;
1297 -r|--remotes) has_r="y" ;;
1303 --set-upstream-to=*)
1304 __git_complete_refs --cur="${cur##--set-upstream-to=}"
1307 __gitcomp_builtin branch
1310 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
1311 __gitcomp_direct "$(__git_heads "" "$cur" " ")"
1321 local cmd="${words[2]}"
1324 __gitcomp "create list-heads verify unbundle"
1327 # looking for a file
1332 __git_complete_revlist
1341 __git_has_doubledash && return
1345 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1348 __gitcomp_builtin checkout
1351 # check if --track, --no-track, or --no-guess was specified
1352 # if so, disable DWIM mode
1353 local flags="--track --no-track --no-guess" track_opt="--track"
1354 if [ "$GIT_COMPLETION_CHECKOUT_NO_GUESS" = "1" ] ||
1355 [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1358 __git_complete_refs $track_opt
1363 __git_cherry_pick_inprogress_options="--continue --quit --abort"
1367 __git_find_repo_path
1368 if [ -f "$__git_repo_path"/CHERRY_PICK_HEAD ]; then
1369 __gitcomp "$__git_cherry_pick_inprogress_options"
1373 __git_complete_strategy && return
1377 __gitcomp_builtin cherry-pick "" \
1378 "$__git_cherry_pick_inprogress_options"
1390 __gitcomp_builtin clean
1395 # XXX should we check for -x option ?
1396 __git_complete_index_file "--others --directory"
1403 __gitcomp_builtin clone
1409 __git_untracked_file_modes="all no normal"
1422 __gitcomp "default scissors strip verbatim whitespace
1423 " "" "${cur##--cleanup=}"
1426 --reuse-message=*|--reedit-message=*|\
1427 --fixup=*|--squash=*)
1428 __git_complete_refs --cur="${cur#*=}"
1431 --untracked-files=*)
1432 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
1436 __gitcomp_builtin commit
1440 if __git rev-parse --verify --quiet HEAD >/dev/null; then
1441 __git_complete_index_file "--committable"
1443 # This is the first commit
1444 __git_complete_index_file "--cached"
1452 __gitcomp_builtin describe
1458 __git_diff_algorithms="myers minimal patience histogram"
1460 __git_diff_submodule_formats="diff log short"
1462 __git_diff_common_options="--stat --numstat --shortstat --summary
1463 --patch-with-stat --name-only --name-status --color
1464 --no-color --color-words --no-renames --check
1465 --full-index --binary --abbrev --diff-filter=
1466 --find-copies-harder --ignore-cr-at-eol
1467 --text --ignore-space-at-eol --ignore-space-change
1468 --ignore-all-space --ignore-blank-lines --exit-code
1469 --quiet --ext-diff --no-ext-diff
1470 --no-prefix --src-prefix= --dst-prefix=
1471 --inter-hunk-context=
1472 --patience --histogram --minimal
1473 --raw --word-diff --word-diff-regex=
1474 --dirstat --dirstat= --dirstat-by-file
1475 --dirstat-by-file= --cumulative
1477 --submodule --submodule= --ignore-submodules
1482 __git_has_doubledash && return
1486 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1490 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1494 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1495 --base --ours --theirs --no-index
1496 $__git_diff_common_options
1501 __git_complete_revlist_file
1504 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1505 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc codecompare
1510 __git_has_doubledash && return
1514 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1518 __gitcomp_builtin difftool "$__git_diff_common_options
1519 --base --cached --ours --theirs
1520 --pickaxe-all --pickaxe-regex
1526 __git_complete_revlist_file
1529 __git_fetch_recurse_submodules="yes on-demand no"
1534 --recurse-submodules=*)
1535 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1539 __gitcomp "blob:none blob:limit= sparse:oid= sparse:path=" "" "${cur##--filter=}"
1543 __gitcomp_builtin fetch
1547 __git_complete_remote_or_refspec
1550 __git_format_patch_extra_options="
1551 --full-index --not --all --no-prefix --src-prefix=
1552 --dst-prefix= --notes
1555 _git_format_patch ()
1561 " "" "${cur##--thread=}"
1565 __gitcomp_builtin format-patch "$__git_format_patch_extra_options"
1569 __git_complete_revlist
1576 __gitcomp_builtin fsck
1587 # Lists matching symbol names from a tag (as in ctags) file.
1588 # 1: List symbol names matching this word.
1589 # 2: The tag file to list symbol names from.
1590 # 3: A prefix to be added to each listed symbol name (optional).
1591 # 4: A suffix to be appended to each listed symbol name (optional).
1592 __git_match_ctag () {
1593 awk -v pfx="${3-}" -v sfx="${4-}" "
1594 /^${1//\//\\/}/ { print pfx \$1 sfx }
1598 # Complete symbol names from a tag file.
1599 # Usage: __git_complete_symbol [<option>]...
1600 # --tags=<file>: The tag file to list symbol names from instead of the
1602 # --pfx=<prefix>: A prefix to be added to each symbol name.
1603 # --cur=<word>: The current symbol name to be completed. Defaults to
1604 # the current word to be completed.
1605 # --sfx=<suffix>: A suffix to be appended to each symbol name instead
1606 # of the default space.
1607 __git_complete_symbol () {
1608 local tags=tags pfx="" cur_="${cur-}" sfx=" "
1610 while test $# != 0; do
1612 --tags=*) tags="${1##--tags=}" ;;
1613 --pfx=*) pfx="${1##--pfx=}" ;;
1614 --cur=*) cur_="${1##--cur=}" ;;
1615 --sfx=*) sfx="${1##--sfx=}" ;;
1621 if test -r "$tags"; then
1622 __gitcomp_direct "$(__git_match_ctag "$cur_" "$tags" "$pfx" "$sfx")"
1628 __git_has_doubledash && return
1632 __gitcomp_builtin grep
1637 case "$cword,$prev" in
1639 __git_complete_symbol && return
1650 __gitcomp_builtin help
1654 if test -n "$GIT_TESTING_ALL_COMMAND_LIST"
1656 __gitcomp "$GIT_TESTING_ALL_COMMAND_LIST $(git --list-cmds=alias,list-guide) gitk"
1658 __gitcomp "$(git --list-cmds=main,nohelpers,alias,list-guide) gitk"
1667 false true umask group all world everybody
1668 " "" "${cur##--shared=}"
1672 __gitcomp_builtin init
1682 __gitcomp_builtin ls-files
1687 # XXX ignore options like --modified and always suggest all cached
1689 __git_complete_index_file "--cached"
1696 __gitcomp_builtin ls-remote
1700 __gitcomp_nl "$(__git_remotes)"
1707 __gitcomp_builtin ls-tree
1715 # Options that go well for log, shortlog and gitk
1716 __git_log_common_options="
1718 --branches --tags --remotes
1719 --first-parent --merges --no-merges
1721 --max-age= --since= --after=
1722 --min-age= --until= --before=
1723 --min-parents= --max-parents=
1724 --no-min-parents --no-max-parents
1726 # Options that go well for log and gitk (not shortlog)
1727 __git_log_gitk_options="
1728 --dense --sparse --full-history
1729 --simplify-merges --simplify-by-decoration
1730 --left-right --notes --no-notes
1732 # Options that go well for log and shortlog (not gitk)
1733 __git_log_shortlog_options="
1734 --author= --committer= --grep=
1735 --all-match --invert-grep
1738 __git_log_pretty_formats="oneline short medium full fuller email raw format: mboxrd"
1739 __git_log_date_formats="relative iso8601 iso8601-strict rfc2822 short local default raw unix format:"
1743 __git_has_doubledash && return
1744 __git_find_repo_path
1747 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
1750 case "$prev,$cur" in
1752 return # fall back to Bash filename completion
1755 __git_complete_symbol --cur="${cur#:}" --sfx=":"
1759 __git_complete_symbol
1764 --pretty=*|--format=*)
1765 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1770 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1774 __gitcomp "full short no" "" "${cur##--decorate=}"
1778 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1782 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1787 $__git_log_common_options
1788 $__git_log_shortlog_options
1789 $__git_log_gitk_options
1790 --root --topo-order --date-order --reverse
1791 --follow --full-diff
1792 --abbrev-commit --abbrev=
1793 --relative-date --date=
1794 --pretty= --format= --oneline
1799 --decorate --decorate=
1801 --parents --children
1803 $__git_diff_common_options
1804 --pickaxe-all --pickaxe-regex
1809 return # fall back to Bash filename completion
1812 __git_complete_symbol --cur="${cur#-L:}" --sfx=":"
1816 __git_complete_symbol --pfx="-G" --cur="${cur#-G}"
1820 __git_complete_symbol --pfx="-S" --cur="${cur#-S}"
1824 __git_complete_revlist
1829 __git_complete_strategy && return
1833 __gitcomp_builtin merge
1843 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1847 __gitcomp "--tool= --prompt --no-prompt --gui --no-gui"
1857 __gitcomp_builtin merge-base
1868 __gitcomp_builtin mv
1873 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1874 # We need to show both cached and untracked files (including
1875 # empty directories) since this may not be the last argument.
1876 __git_complete_index_file "--cached --others --directory"
1878 __git_complete_index_file "--cached"
1884 local subcommands='add append copy edit get-ref list merge prune remove show'
1885 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1887 case "$subcommand,$cur" in
1889 __gitcomp_builtin notes
1897 __gitcomp "$subcommands --ref"
1901 *,--reuse-message=*|*,--reedit-message=*)
1902 __git_complete_refs --cur="${cur#*=}"
1905 __gitcomp_builtin notes_$subcommand
1908 # this command does not take a ref, do not complete it
1924 __git_complete_strategy && return
1927 --recurse-submodules=*)
1928 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1932 __gitcomp_builtin pull
1937 __git_complete_remote_or_refspec
1940 __git_push_recurse_submodules="check on-demand only"
1942 __git_complete_force_with_lease ()
1950 __git_complete_refs --cur="${cur_#*:}"
1953 __git_complete_refs --cur="$cur_"
1962 __gitcomp_nl "$(__git_remotes)"
1965 --recurse-submodules)
1966 __gitcomp "$__git_push_recurse_submodules"
1972 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1975 --recurse-submodules=*)
1976 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1979 --force-with-lease=*)
1980 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1984 __gitcomp_builtin push
1988 __git_complete_remote_or_refspec
1996 --creation-factor= --no-dual-color
1997 $__git_diff_common_options
2002 __git_complete_revlist
2007 __git_find_repo_path
2008 if [ -f "$__git_repo_path"/rebase-merge/interactive ]; then
2009 __gitcomp "--continue --skip --abort --quit --edit-todo --show-current-patch"
2011 elif [ -d "$__git_repo_path"/rebase-apply ] || \
2012 [ -d "$__git_repo_path"/rebase-merge ]; then
2013 __gitcomp "--continue --skip --abort --quit --show-current-patch"
2016 __git_complete_strategy && return
2019 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
2024 --onto --merge --strategy --interactive
2025 --rebase-merges --preserve-merges --stat --no-stat
2026 --committer-date-is-author-date --ignore-date
2027 --ignore-whitespace --whitespace=
2028 --autosquash --no-autosquash
2029 --fork-point --no-fork-point
2030 --autostash --no-autostash
2031 --verify --no-verify
2032 --keep-empty --root --force-rebase --no-ff
2044 local subcommands="show delete expire"
2045 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2047 if [ -z "$subcommand" ]; then
2048 __gitcomp "$subcommands"
2054 __git_send_email_confirm_options="always never auto cc compose"
2055 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
2060 --to|--cc|--bcc|--from)
2061 __gitcomp "$(__git send-email --dump-aliases)"
2069 $__git_send_email_confirm_options
2070 " "" "${cur##--confirm=}"
2075 $__git_send_email_suppresscc_options
2076 " "" "${cur##--suppress-cc=}"
2080 --smtp-encryption=*)
2081 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
2087 " "" "${cur##--thread=}"
2090 --to=*|--cc=*|--bcc=*|--from=*)
2091 __gitcomp "$(__git send-email --dump-aliases)" "" "${cur#--*=}"
2095 __gitcomp_builtin send-email "--annotate --bcc --cc --cc-cmd --chain-reply-to
2096 --compose --confirm= --dry-run --envelope-sender
2098 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
2099 --no-suppress-from --no-thread --quiet --reply-to
2100 --signed-off-by-cc --smtp-pass --smtp-server
2101 --smtp-server-port --smtp-encryption= --smtp-user
2102 --subject --suppress-cc= --suppress-from --thread --to
2103 --validate --no-validate
2104 $__git_format_patch_extra_options"
2108 __git_complete_revlist
2119 local untracked_state
2122 --ignore-submodules=*)
2123 __gitcomp "none untracked dirty all" "" "${cur##--ignore-submodules=}"
2126 --untracked-files=*)
2127 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
2132 always never auto column row plain dense nodense
2133 " "" "${cur##--column=}"
2137 __gitcomp_builtin status
2142 untracked_state="$(__git_get_option_value "-u" "--untracked-files=" \
2143 "$__git_untracked_file_modes" "status.showUntrackedFiles")"
2145 case "$untracked_state" in
2147 # --ignored option does not matter
2151 complete_opt="--cached --directory --no-empty-directory --others"
2153 if [ -n "$(__git_find_on_cmdline "--ignored")" ]; then
2154 complete_opt="$complete_opt --ignored --exclude=*"
2159 __git_complete_index_file "$complete_opt"
2166 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
2169 __gitcomp_builtin switch
2172 # check if --track, --no-track, or --no-guess was specified
2173 # if so, disable DWIM mode
2174 local track_opt="--track" only_local_ref=n
2175 if [ "$GIT_COMPLETION_CHECKOUT_NO_GUESS" = "1" ] ||
2176 [ -n "$(__git_find_on_cmdline "--track --no-track --no-guess")" ]; then
2179 # explicit --guess enables DWIM mode regardless of
2180 # $GIT_COMPLETION_CHECKOUT_NO_GUESS
2181 if [ -n "$(__git_find_on_cmdline "--guess")" ]; then
2184 if [ -z "$(__git_find_on_cmdline "-d --detach")" ]; then
2187 if [ $only_local_ref = y -a -z "$track_opt" ]; then
2188 __gitcomp_direct "$(__git_heads "" "$cur" " ")"
2190 __git_complete_refs $track_opt
2196 __git_config_get_set_variables ()
2198 local prevword word config_file= c=$cword
2199 while [ $c -gt 1 ]; do
2202 --system|--global|--local|--file=*)
2207 config_file="$word $prevword"
2215 __git config $config_file --name-only --list
2219 __git_compute_config_vars ()
2221 test -n "$__git_config_vars" ||
2222 __git_config_vars="$(git help --config-for-completion | sort | uniq)"
2229 if [ "${BASH_VERSINFO[0]:-0}" -ge 4 ]; then
2232 varname="$(echo "$prev" |tr A-Z a-z)"
2236 branch.*.remote|branch.*.pushremote)
2237 __gitcomp_nl "$(__git_remotes)"
2245 __gitcomp "false true merges preserve interactive"
2249 __gitcomp_nl "$(__git_remotes)"
2253 local remote="${prev#remote.}"
2254 remote="${remote%.fetch}"
2255 if [ -z "$cur" ]; then
2256 __gitcomp_nl "refs/heads/" "" "" ""
2259 __gitcomp_nl "$(__git_refs_remotes "$remote")"
2263 local remote="${prev#remote.}"
2264 remote="${remote%.push}"
2265 __gitcomp_nl "$(__git for-each-ref \
2266 --format='%(refname):%(refname)' refs/heads)"
2269 pull.twohead|pull.octopus)
2270 __git_compute_merge_strategies
2271 __gitcomp "$__git_merge_strategies"
2274 color.branch|color.diff|color.interactive|\
2275 color.showbranch|color.status|color.ui)
2276 __gitcomp "always never auto"
2280 __gitcomp "false true"
2285 normal black red green yellow blue magenta cyan white
2286 bold dim ul blink reverse
2291 __gitcomp "$__git_diff_submodule_formats"
2295 __gitcomp "man info web html"
2299 __gitcomp "$__git_log_date_formats"
2302 sendemail.aliasfiletype)
2303 __gitcomp "mutt mailrc pine elm gnus"
2307 __gitcomp "$__git_send_email_confirm_options"
2310 sendemail.suppresscc)
2311 __gitcomp "$__git_send_email_suppresscc_options"
2314 sendemail.transferencoding)
2315 __gitcomp "7bit 8bit quoted-printable base64"
2318 --get|--get-all|--unset|--unset-all)
2319 __gitcomp_nl "$(__git_config_get_set_variables)"
2328 __gitcomp_builtin config
2332 local pfx="${cur%.*}." cur_="${cur##*.}"
2333 __gitcomp "remote pushRemote merge mergeOptions rebase" "$pfx" "$cur_"
2337 local pfx="${cur%.*}." cur_="${cur#*.}"
2338 __gitcomp_direct "$(__git_heads "$pfx" "$cur_" ".")"
2339 __gitcomp_nl_append $'autoSetupMerge\nautoSetupRebase\n' "$pfx" "$cur_"
2343 local pfx="${cur%.*}." cur_="${cur##*.}"
2345 argPrompt cmd confirm needsFile noConsole noRescan
2346 prompt revPrompt revUnmerged title
2351 local pfx="${cur%.*}." cur_="${cur##*.}"
2352 __gitcomp "cmd path" "$pfx" "$cur_"
2356 local pfx="${cur%.*}." cur_="${cur##*.}"
2357 __gitcomp "cmd path" "$pfx" "$cur_"
2361 local pfx="${cur%.*}." cur_="${cur##*.}"
2362 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
2366 local pfx="${cur%.*}." cur_="${cur#*.}"
2367 __git_compute_all_commands
2368 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
2372 local pfx="${cur%.*}." cur_="${cur##*.}"
2374 url proxy fetch push mirror skipDefaultUpdate
2375 receivepack uploadpack tagOpt pushurl
2380 local pfx="${cur%.*}." cur_="${cur#*.}"
2381 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
2382 __gitcomp_nl_append "pushDefault" "$pfx" "$cur_"
2386 local pfx="${cur%.*}." cur_="${cur##*.}"
2387 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
2391 __git_compute_config_vars
2392 __gitcomp "$__git_config_vars"
2395 __git_compute_config_vars
2396 __gitcomp "$(echo "$__git_config_vars" | sed 's/\.[^ ]*/./g')"
2403 add rename remove set-head set-branches
2404 get-url set-url show prune update
2406 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2407 if [ -z "$subcommand" ]; then
2410 __gitcomp_builtin remote
2413 __gitcomp "$subcommands"
2419 case "$subcommand,$cur" in
2421 __gitcomp_builtin remote_add
2426 __gitcomp_builtin remote_set-head
2429 __gitcomp_builtin remote_set-branches
2431 set-head,*|set-branches,*)
2432 __git_complete_remote_or_refspec
2435 __gitcomp_builtin remote_update
2438 __gitcomp "$(__git_remotes) $(__git_get_config_variables "remotes")"
2441 __gitcomp_builtin remote_set-url
2444 __gitcomp_builtin remote_get-url
2447 __gitcomp_builtin remote_prune
2450 __gitcomp_nl "$(__git_remotes)"
2459 __gitcomp "short medium long" "" "${cur##--format=}"
2463 __gitcomp_builtin replace
2472 local subcommands="clear forget diff remaining status gc"
2473 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2474 if test -z "$subcommand"
2476 __gitcomp "$subcommands"
2483 __git_has_doubledash && return
2487 __gitcomp_builtin reset
2494 __git_revert_inprogress_options="--continue --quit --abort"
2498 __git_find_repo_path
2499 if [ -f "$__git_repo_path"/REVERT_HEAD ]; then
2500 __gitcomp "$__git_revert_inprogress_options"
2503 __git_complete_strategy && return
2506 __gitcomp_builtin revert "" \
2507 "$__git_revert_inprogress_options"
2518 __gitcomp_builtin rm
2523 __git_complete_index_file "--cached"
2528 __git_has_doubledash && return
2533 $__git_log_common_options
2534 $__git_log_shortlog_options
2535 --numbered --summary --email
2540 __git_complete_revlist
2545 __git_has_doubledash && return
2548 --pretty=*|--format=*)
2549 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2554 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2558 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
2562 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2564 $__git_diff_common_options
2569 __git_complete_revlist_file
2576 __gitcomp_builtin show-branch
2580 __git_complete_revlist
2585 local save_opts='--all --keep-index --no-keep-index --quiet --patch --include-untracked'
2586 local subcommands='push list show apply clear drop pop create branch'
2587 local subcommand="$(__git_find_on_cmdline "$subcommands save")"
2588 if [ -n "$(__git_find_on_cmdline "-p")" ]; then
2591 if [ -z "$subcommand" ]; then
2594 __gitcomp "$save_opts"
2597 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2602 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2603 __gitcomp "$subcommands"
2608 case "$subcommand,$cur" in
2610 __gitcomp "$save_opts --message"
2613 __gitcomp "$save_opts"
2616 __gitcomp "--index --quiet"
2622 __gitcomp "--name-status --oneline --patch-with-stat"
2624 show,--*|branch,--*)
2627 if [ $cword -eq 3 ]; then
2630 __gitcomp_nl "$(__git stash list \
2631 | sed -n -e 's/:.*//p')"
2634 show,*|apply,*|drop,*|pop,*)
2635 __gitcomp_nl "$(__git stash list \
2636 | sed -n -e 's/:.*//p')"
2646 __git_has_doubledash && return
2648 local subcommands="add status init deinit update summary foreach sync absorbgitdirs"
2649 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2650 if [ -z "$subcommand" ]; then
2656 __gitcomp "$subcommands"
2662 case "$subcommand,$cur" in
2664 __gitcomp "--branch --force --name --reference --depth"
2667 __gitcomp "--cached --recursive"
2670 __gitcomp "--force --all"
2674 --init --remote --no-fetch
2675 --recommend-shallow --no-recommend-shallow
2676 --force --rebase --merge --reference --depth --recursive --jobs
2680 __gitcomp "--cached --files --summary-limit"
2682 foreach,--*|sync,--*)
2683 __gitcomp "--recursive"
2693 init fetch clone rebase dcommit log find-rev
2694 set-tree commit-diff info create-ignore propget
2695 proplist show-ignore show-externals branch tag blame
2696 migrate mkdirs reset gc
2698 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2699 if [ -z "$subcommand" ]; then
2700 __gitcomp "$subcommands"
2702 local remote_opts="--username= --config-dir= --no-auth-cache"
2704 --follow-parent --authors-file= --repack=
2705 --no-metadata --use-svm-props --use-svnsync-props
2706 --log-window-size= --no-checkout --quiet
2707 --repack-flags --use-log-author --localtime
2709 --ignore-paths= --include-paths= $remote_opts
2712 --template= --shared= --trunk= --tags=
2713 --branches= --stdlayout --minimize-url
2714 --no-metadata --use-svm-props --use-svnsync-props
2715 --rewrite-root= --prefix= $remote_opts
2718 --edit --rmdir --find-copies-harder --copy-similarity=
2721 case "$subcommand,$cur" in
2723 __gitcomp "--revision= --fetch-all $fc_opts"
2726 __gitcomp "--revision= $fc_opts $init_opts"
2729 __gitcomp "$init_opts"
2733 --merge --strategy= --verbose --dry-run
2734 --fetch-all --no-rebase --commit-url
2735 --revision --interactive $cmt_opts $fc_opts
2739 __gitcomp "--stdin $cmt_opts $fc_opts"
2741 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2742 show-externals,--*|mkdirs,--*)
2743 __gitcomp "--revision="
2747 --limit= --revision= --verbose --incremental
2748 --oneline --show-commit --non-recursive
2749 --authors-file= --color
2754 --merge --verbose --strategy= --local
2755 --fetch-all --dry-run $fc_opts
2759 __gitcomp "--message= --file= --revision= $cmt_opts"
2765 __gitcomp "--dry-run --message --tag"
2768 __gitcomp "--dry-run --message"
2771 __gitcomp "--git-format"
2775 --config-dir= --ignore-paths= --minimize
2776 --no-auth-cache --username=
2780 __gitcomp "--revision= --parent"
2791 while [ $c -lt $cword ]; do
2794 -d|--delete|-v|--verify)
2795 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2810 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2820 __gitcomp_builtin tag
2832 local subcommands="add list lock move prune remove unlock"
2833 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2834 if [ -z "$subcommand" ]; then
2835 __gitcomp "$subcommands"
2837 case "$subcommand,$cur" in
2839 __gitcomp_builtin worktree_add
2842 __gitcomp_builtin worktree_list
2845 __gitcomp_builtin worktree_lock
2848 __gitcomp_builtin worktree_prune
2859 __git_complete_common () {
2864 __gitcomp_builtin "$command"
2869 __git_cmds_with_parseopt_helper=
2870 __git_support_parseopt_helper () {
2871 test -n "$__git_cmds_with_parseopt_helper" ||
2872 __git_cmds_with_parseopt_helper="$(__git --list-cmds=parseopt)"
2874 case " $__git_cmds_with_parseopt_helper " in
2884 __git_complete_command () {
2886 local completion_func="_git_${command//-/_}"
2887 if ! declare -f $completion_func >/dev/null 2>/dev/null &&
2888 declare -f _completion_loader >/dev/null 2>/dev/null
2890 _completion_loader "git-$command"
2892 if declare -f $completion_func >/dev/null 2>/dev/null
2896 elif __git_support_parseopt_helper "$command"
2898 __git_complete_common "$command"
2907 local i c=1 command __git_dir __git_repo_path
2908 local __git_C_args C_args_count=0
2910 while [ $c -lt $cword ]; do
2913 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2914 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2915 --bare) __git_dir="." ;;
2916 --help) command="help"; break ;;
2917 -c|--work-tree|--namespace) ((c++)) ;;
2918 -C) __git_C_args[C_args_count++]=-C
2920 __git_C_args[C_args_count++]="${words[c]}"
2923 *) command="$i"; break ;;
2928 if [ -z "$command" ]; then
2930 --git-dir|-C|--work-tree)
2931 # these need a path argument, let's fall back to
2932 # Bash filename completion
2936 # we don't support completing these options' arguments
2954 --no-replace-objects
2959 if test -n "$GIT_TESTING_PORCELAIN_COMMAND_LIST"
2961 __gitcomp "$GIT_TESTING_PORCELAIN_COMMAND_LIST"
2963 __gitcomp "$(git --list-cmds=list-mainporcelain,others,nohelpers,alias,list-complete,config)"
2970 __git_complete_command "$command" && return
2972 local expansion=$(__git_aliased_command "$command")
2973 if [ -n "$expansion" ]; then
2975 __git_complete_command "$expansion"
2981 __git_has_doubledash && return
2983 local __git_repo_path
2984 __git_find_repo_path
2987 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
2993 $__git_log_common_options
2994 $__git_log_gitk_options
3000 __git_complete_revlist
3003 if [[ -n ${ZSH_VERSION-} ]] &&
3004 # Don't define these functions when sourced from 'git-completion.zsh',
3005 # it has its own implementations.
3006 [[ -z ${GIT_SOURCING_ZSH_COMPLETION-} ]]; then
3007 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
3009 autoload -U +X compinit && compinit
3015 local cur_="${3-$cur}"
3021 local c IFS=$' \t\n'
3029 array[${#array[@]}+1]="$c"
3032 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
3043 compadd -Q -- ${=1} && _ret=0
3052 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
3055 __gitcomp_file_direct ()
3061 compadd -f -- ${=1} && _ret=0
3070 compadd -p "${2-}" -f -- ${=1} && _ret=0
3075 local _ret=1 cur cword prev
3076 cur=${words[CURRENT]}
3077 prev=${words[CURRENT-1]}
3079 emulate ksh -c __${service}_main
3080 let _ret && _default && _ret=0
3084 compdef _git git gitk
3090 local cur words cword prev
3091 _get_comp_words_by_ref -n =: cur words cword prev
3095 # Setup completion for certain functions defined above by setting common
3096 # variables and workarounds.
3097 # This is NOT a public function; use at your own risk.
3100 local wrapper="__git_wrap${2}"
3101 eval "$wrapper () { __git_func_wrap $2 ; }"
3102 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
3103 || complete -o default -o nospace -F $wrapper $1
3106 # wrapper for backwards compatibility
3109 __git_wrap__git_main
3112 # wrapper for backwards compatibility
3115 __git_wrap__gitk_main
3118 __git_complete git __git_main
3119 __git_complete gitk __gitk_main
3121 # The following are necessary only for Cygwin, and only are needed
3122 # when the user has tab-completed the executable name and consequently
3123 # included the '.exe' suffix.
3125 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
3126 __git_complete git.exe __git_main