1 # bash/zsh completion support for core Git.
3 # Copyright (C) 2006,2007 Shawn O. Pearce <spearce@spearce.org>
4 # Conceptually based on gitcompletion (http://gitweb.hawaga.org.uk/).
5 # Distributed under the GNU General Public License, version 2.0.
7 # The contained completion routines provide support for completing:
9 # *) local and remote branch names
10 # *) local and remote tag names
11 # *) .git/remotes file names
12 # *) git 'subcommands'
13 # *) git email aliases for git-send-email
14 # *) tree paths within 'ref:path/to/file' expressions
15 # *) file paths within current working directory and index
16 # *) common --long-options
18 # To use these routines:
20 # 1) Copy this file to somewhere (e.g. ~/.git-completion.bash).
21 # 2) Add the following line to your .bashrc/.zshrc:
22 # source ~/.git-completion.bash
23 # 3) Consider changing your PS1 to also show the current branch,
24 # see git-prompt.sh for details.
26 # If you use complex aliases of form '!f() { ... }; f', you can use the null
27 # command ':' as the first command in the function body to declare the desired
28 # completion style. For example '!f() { : git commit ; ... }; f' will
29 # tell the completion to use commit completion. This also works with aliases
30 # of form "!sh -c '...'". For example, "!sh -c ': git commit ; ... '".
32 # Compatible with bash 3.2.57.
34 # You can set the following environment variables to influence the behavior of
35 # the completion routines:
37 # GIT_COMPLETION_CHECKOUT_NO_GUESS
39 # When set to "1", do not include "DWIM" suggestions in git-checkout
40 # completion (e.g., completing "foo" when "origin/foo" exists).
42 case "$COMP_WORDBREAKS" in
44 *) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
47 # Discovers the path to the git repository taking any '--git-dir=<path>' and
48 # '-C <path>' options into account and stores it in the $__git_repo_path
50 __git_find_repo_path ()
52 if [ -n "$__git_repo_path" ]; then
53 # we already know where it is
57 if [ -n "${__git_C_args-}" ]; then
58 __git_repo_path="$(git "${__git_C_args[@]}" \
59 ${__git_dir:+--git-dir="$__git_dir"} \
60 rev-parse --absolute-git-dir 2>/dev/null)"
61 elif [ -n "${__git_dir-}" ]; then
62 test -d "$__git_dir" &&
63 __git_repo_path="$__git_dir"
64 elif [ -n "${GIT_DIR-}" ]; then
65 test -d "${GIT_DIR-}" &&
66 __git_repo_path="$GIT_DIR"
67 elif [ -d .git ]; then
70 __git_repo_path="$(git rev-parse --git-dir 2>/dev/null)"
74 # Deprecated: use __git_find_repo_path() and $__git_repo_path instead
75 # __gitdir accepts 0 or 1 arguments (i.e., location)
76 # returns location of .git repo
79 if [ -z "${1-}" ]; then
80 __git_find_repo_path || return 1
81 echo "$__git_repo_path"
82 elif [ -d "$1/.git" ]; then
89 # Runs git with all the options given as argument, respecting any
90 # '--git-dir=<path>' and '-C <path>' options present on the command line
93 git ${__git_C_args:+"${__git_C_args[@]}"} \
94 ${__git_dir:+--git-dir="$__git_dir"} "$@" 2>/dev/null
97 # The following function is based on code from:
99 # bash_completion - programmable completion functions for bash 3.2+
101 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
102 # © 2009-2010, Bash Completion Maintainers
103 # <bash-completion-devel@lists.alioth.debian.org>
105 # This program is free software; you can redistribute it and/or modify
106 # it under the terms of the GNU General Public License as published by
107 # the Free Software Foundation; either version 2, or (at your option)
110 # This program is distributed in the hope that it will be useful,
111 # but WITHOUT ANY WARRANTY; without even the implied warranty of
112 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
113 # GNU General Public License for more details.
115 # You should have received a copy of the GNU General Public License
116 # along with this program; if not, see <http://www.gnu.org/licenses/>.
118 # The latest version of this software can be obtained here:
120 # http://bash-completion.alioth.debian.org/
124 # This function can be used to access a tokenized list of words
125 # on the command line:
127 # __git_reassemble_comp_words_by_ref '=:'
128 # if test "${words_[cword_-1]}" = -w
133 # The argument should be a collection of characters from the list of
134 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
137 # This is roughly equivalent to going back in time and setting
138 # COMP_WORDBREAKS to exclude those characters. The intent is to
139 # make option types like --date=<type> and <rev>:<path> easy to
140 # recognize by treating each shell word as a single token.
142 # It is best not to set COMP_WORDBREAKS directly because the value is
143 # shared with other completion scripts. By the time the completion
144 # function gets called, COMP_WORDS has already been populated so local
145 # changes to COMP_WORDBREAKS have no effect.
147 # Output: words_, cword_, cur_.
149 __git_reassemble_comp_words_by_ref()
151 local exclude i j first
152 # Which word separators to exclude?
153 exclude="${1//[^$COMP_WORDBREAKS]}"
155 if [ -z "$exclude" ]; then
156 words_=("${COMP_WORDS[@]}")
159 # List of word completion separators has shrunk;
160 # re-assemble words to complete.
161 for ((i=0, j=0; i < ${#COMP_WORDS[@]}; i++, j++)); do
162 # Append each nonempty word consisting of just
163 # word separator characters to the current word.
167 [ -n "${COMP_WORDS[$i]}" ] &&
168 # word consists of excluded word separators
169 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
171 # Attach to the previous token,
172 # unless the previous token is the command name.
173 if [ $j -ge 2 ] && [ -n "$first" ]; then
177 words_[$j]=${words_[j]}${COMP_WORDS[i]}
178 if [ $i = $COMP_CWORD ]; then
181 if (($i < ${#COMP_WORDS[@]} - 1)); then
188 words_[$j]=${words_[j]}${COMP_WORDS[i]}
189 if [ $i = $COMP_CWORD ]; then
195 if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
196 _get_comp_words_by_ref ()
198 local exclude cur_ words_ cword_
199 if [ "$1" = "-n" ]; then
203 __git_reassemble_comp_words_by_ref "$exclude"
204 cur_=${words_[cword_]}
205 while [ $# -gt 0 ]; do
211 prev=${words_[$cword_-1]}
214 words=("${words_[@]}")
225 # Fills the COMPREPLY array with prefiltered words without any additional
227 # Callers must take care of providing only words that match the current word
228 # to be completed and adding any prefix and/or suffix (trailing space!), if
230 # 1: List of newline-separated matching completion words, complete with
241 local x i=${#COMPREPLY[@]}
243 if [[ "$x" == "$3"* ]]; then
244 COMPREPLY[i++]="$2$x$4"
255 # Generates completion reply, appending a space to possible completion words,
257 # It accepts 1 to 4 arguments:
258 # 1: List of possible completion words.
259 # 2: A prefix to be added to each possible completion word (optional).
260 # 3: Generate possible completion matches for this word (optional).
261 # 4: A suffix to be appended to each possible completion word (optional).
264 local cur_="${3-$cur}"
270 local c i=0 IFS=$' \t\n'
273 if [[ $c == "$cur_"* ]]; then
278 COMPREPLY[i++]="${2-}$c"
285 # Clear the variables caching builtins' options when (re-)sourcing
286 # the completion script.
287 unset $(set |sed -ne 's/^\(__gitcomp_builtin_[a-zA-Z0-9_][a-zA-Z0-9_]*\)=.*/\1/p') 2>/dev/null
289 # This function is equivalent to
291 # __gitcomp "$(git xxx --git-completion-helper) ..."
293 # except that the output is cached. Accept 1-3 arguments:
294 # 1: the git command to execute, this is also the cache key
295 # 2: extra options to be added on top (e.g. negative forms)
296 # 3: options to be excluded
299 # spaces must be replaced with underscore for multi-word
300 # commands, e.g. "git remote add" becomes remote_add.
305 local var=__gitcomp_builtin_"${cmd/-/_}"
307 eval "options=\$$var"
309 if [ -z "$options" ]; then
310 # leading and trailing spaces are significant to make
311 # option removal work correctly.
312 options=" $(__git ${cmd/_/ } --git-completion-helper) $incl "
314 options="${options/ $i / }"
316 eval "$var=\"$options\""
322 # Variation of __gitcomp_nl () that appends to the existing list of
323 # completion candidates, COMPREPLY.
324 __gitcomp_nl_append ()
327 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
330 # Generates completion reply from newline-separated possible completion words
331 # by appending a space to all of them.
332 # It accepts 1 to 4 arguments:
333 # 1: List of possible completion words, separated by a single newline.
334 # 2: A prefix to be added to each possible completion word (optional).
335 # 3: Generate possible completion matches for this word (optional).
336 # 4: A suffix to be appended to each possible completion word instead of
337 # the default space (optional). If specified but empty, nothing is
342 __gitcomp_nl_append "$@"
345 # Generates completion reply with compgen from newline-separated possible
346 # completion filenames.
347 # It accepts 1 to 3 arguments:
348 # 1: List of possible completion filenames, separated by a single newline.
349 # 2: A directory prefix to be added to each possible completion filename
351 # 3: Generate possible completion matches for this word (optional).
356 # XXX does not work when the directory prefix contains a tilde,
357 # since tilde expansion is not applied.
358 # This means that COMPREPLY will be empty and Bash default
359 # completion will be used.
360 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
362 # use a hack to enable file mode in bash < 4
363 compopt -o filenames +o nospace 2>/dev/null ||
364 compgen -f /non-existing-dir/ > /dev/null
367 # Execute 'git ls-files', unless the --committable option is specified, in
368 # which case it runs 'git diff-index' to find out the files that can be
369 # committed. It return paths relative to the directory specified in the first
370 # argument, and using the options specified in the second argument.
371 __git_ls_files_helper ()
373 if [ "$2" == "--committable" ]; then
374 __git -C "$1" diff-index --name-only --relative HEAD
376 # NOTE: $2 is not quoted in order to support multiple options
377 __git -C "$1" ls-files --exclude-standard $2
382 # __git_index_files accepts 1 or 2 arguments:
383 # 1: Options to pass to ls-files (required).
384 # 2: A directory path (optional).
385 # If provided, only files within the specified directory are listed.
386 # Sub directories are never recursed. Path must have a trailing
390 local root="${2-.}" file
392 __git_ls_files_helper "$root" "$1" |
393 while read -r file; do
395 ?*/*) echo "${file%%/*}" ;;
401 # Lists branches from the local repository.
402 # 1: A prefix to be added to each listed branch (optional).
403 # 2: List only branches matching this word (optional; list all branches if
405 # 3: A suffix to be appended to each listed branch (optional).
408 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
410 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
411 "refs/heads/$cur_*" "refs/heads/$cur_*/**"
414 # Lists tags from the local repository.
415 # Accepts the same positional parameters as __git_heads() above.
418 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
420 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
421 "refs/tags/$cur_*" "refs/tags/$cur_*/**"
424 # Lists refs from the local (by default) or from a remote repository.
425 # It accepts 0, 1 or 2 arguments:
426 # 1: The remote to list refs from (optional; ignored, if set but empty).
427 # Can be the name of a configured remote, a path, or a URL.
428 # 2: In addition to local refs, list unique branches from refs/remotes/ for
429 # 'git checkout's tracking DWIMery (optional; ignored, if set but empty).
430 # 3: A prefix to be added to each listed ref (optional).
431 # 4: List only refs matching this word (optional; list all refs if unset or
433 # 5: A suffix to be appended to each listed ref (optional; ignored, if set
436 # Use __git_complete_refs() instead.
439 local i hash dir track="${2-}"
440 local list_refs_from=path remote="${1-}"
442 local pfx="${3-}" cur_="${4-$cur}" sfx="${5-}"
444 local fer_pfx="${pfx//\%/%%}" # "escape" for-each-ref format specifiers
447 dir="$__git_repo_path"
449 if [ -z "$remote" ]; then
450 if [ -z "$dir" ]; then
454 if __git_is_configured_remote "$remote"; then
455 # configured remote takes precedence over a
456 # local directory with the same name
457 list_refs_from=remote
458 elif [ -d "$remote/.git" ]; then
460 elif [ -d "$remote" ]; then
467 if [ "$list_refs_from" = path ]; then
468 if [[ "$cur_" == ^* ]]; then
477 refs=("$match*" "$match*/**")
481 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD REBASE_HEAD; do
484 if [ -e "$dir/$i" ]; then
490 format="refname:strip=2"
491 refs=("refs/tags/$match*" "refs/tags/$match*/**"
492 "refs/heads/$match*" "refs/heads/$match*/**"
493 "refs/remotes/$match*" "refs/remotes/$match*/**")
496 __git_dir="$dir" __git for-each-ref --format="$fer_pfx%($format)$sfx" \
498 if [ -n "$track" ]; then
499 # employ the heuristic used by git checkout
500 # Try to find a remote branch that matches the completion word
501 # but only output if the branch name is unique
502 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
503 --sort="refname:strip=3" \
504 "refs/remotes/*/$match*" "refs/remotes/*/$match*/**" | \
511 __git ls-remote "$remote" "$match*" | \
512 while read -r hash i; do
515 *) echo "$pfx$i$sfx" ;;
520 if [ "$list_refs_from" = remote ]; then
522 $match*) echo "${pfx}HEAD$sfx" ;;
524 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
525 "refs/remotes/$remote/$match*" \
526 "refs/remotes/$remote/$match*/**"
530 $match*) query_symref="HEAD" ;;
532 __git ls-remote "$remote" $query_symref \
533 "refs/tags/$match*" "refs/heads/$match*" \
534 "refs/remotes/$match*" |
535 while read -r hash i; do
538 refs/*) echo "$pfx${i#refs/*/}$sfx" ;;
539 *) echo "$pfx$i$sfx" ;; # symbolic refs
547 # Completes refs, short and long, local and remote, symbolic and pseudo.
549 # Usage: __git_complete_refs [<option>]...
550 # --remote=<remote>: The remote to list refs from, can be the name of a
551 # configured remote, a path, or a URL.
552 # --track: List unique remote branches for 'git checkout's tracking DWIMery.
553 # --pfx=<prefix>: A prefix to be added to each ref.
554 # --cur=<word>: The current ref to be completed. Defaults to the current
555 # word to be completed.
556 # --sfx=<suffix>: A suffix to be appended to each ref instead of the default
558 __git_complete_refs ()
560 local remote track pfx cur_="$cur" sfx=" "
562 while test $# != 0; do
564 --remote=*) remote="${1##--remote=}" ;;
565 --track) track="yes" ;;
566 --pfx=*) pfx="${1##--pfx=}" ;;
567 --cur=*) cur_="${1##--cur=}" ;;
568 --sfx=*) sfx="${1##--sfx=}" ;;
574 __gitcomp_direct "$(__git_refs "$remote" "$track" "$pfx" "$cur_" "$sfx")"
577 # __git_refs2 requires 1 argument (to pass to __git_refs)
578 # Deprecated: use __git_complete_fetch_refspecs() instead.
582 for i in $(__git_refs "$1"); do
587 # Completes refspecs for fetching from a remote repository.
588 # 1: The remote repository.
589 # 2: A prefix to be added to each listed refspec (optional).
590 # 3: The ref to be completed as a refspec instead of the current word to be
591 # completed (optional)
592 # 4: A suffix to be appended to each listed refspec instead of the default
594 __git_complete_fetch_refspecs ()
596 local i remote="$1" pfx="${2-}" cur_="${3-$cur}" sfx="${4- }"
599 for i in $(__git_refs "$remote" "" "" "$cur_") ; do
605 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
606 __git_refs_remotes ()
609 __git ls-remote "$1" 'refs/heads/*' | \
610 while read -r hash i; do
611 echo "$i:refs/remotes/$1/${i#refs/heads/}"
618 test -d "$__git_repo_path/remotes" && ls -1 "$__git_repo_path/remotes"
622 # Returns true if $1 matches the name of a configured remote, false otherwise.
623 __git_is_configured_remote ()
626 for remote in $(__git_remotes); do
627 if [ "$remote" = "$1" ]; then
634 __git_list_merge_strategies ()
636 LANG=C LC_ALL=C git merge -s help 2>&1 |
637 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
646 __git_merge_strategies=
647 # 'git merge -s help' (and thus detection of the merge strategy
648 # list) fails, unfortunately, if run outside of any git working
649 # tree. __git_merge_strategies is set to the empty string in
650 # that case, and the detection will be repeated the next time it
652 __git_compute_merge_strategies ()
654 test -n "$__git_merge_strategies" ||
655 __git_merge_strategies=$(__git_list_merge_strategies)
658 __git_complete_revlist_file ()
660 local pfx ls ref cur_="$cur"
680 case "$COMP_WORDBREAKS" in
682 *) pfx="$ref:$pfx" ;;
685 __gitcomp_nl "$(__git ls-tree "$ls" \
686 | sed '/^100... blob /{
702 pfx="${cur_%...*}..."
704 __git_complete_refs --pfx="$pfx" --cur="$cur_"
709 __git_complete_refs --pfx="$pfx" --cur="$cur_"
718 # __git_complete_index_file requires 1 argument:
719 # 1: the options to pass to ls-file
721 # The exception is --committable, which finds the files appropriate commit.
722 __git_complete_index_file ()
724 local pfx="" cur_="$cur"
734 __gitcomp_file "$(__git_index_files "$1" ${pfx:+"$pfx"})" "$pfx" "$cur_"
737 __git_complete_file ()
739 __git_complete_revlist_file
742 __git_complete_revlist ()
744 __git_complete_revlist_file
747 __git_complete_remote_or_refspec ()
749 local cur_="$cur" cmd="${words[1]}"
750 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
751 if [ "$cmd" = "remote" ]; then
754 while [ $c -lt $cword ]; do
757 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
758 -d|--delete) [ "$cmd" = "push" ] && lhs=0 ;;
761 push) no_complete_refspec=1 ;;
769 *) remote="$i"; break ;;
773 if [ -z "$remote" ]; then
774 __gitcomp_nl "$(__git_remotes)"
777 if [ $no_complete_refspec = 1 ]; then
780 [ "$remote" = "." ] && remote=
783 case "$COMP_WORDBREAKS" in
785 *) pfx="${cur_%%:*}:" ;;
797 if [ $lhs = 1 ]; then
798 __git_complete_fetch_refspecs "$remote" "$pfx" "$cur_"
800 __git_complete_refs --pfx="$pfx" --cur="$cur_"
804 if [ $lhs = 1 ]; then
805 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
807 __git_complete_refs --pfx="$pfx" --cur="$cur_"
811 if [ $lhs = 1 ]; then
812 __git_complete_refs --pfx="$pfx" --cur="$cur_"
814 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
820 __git_complete_strategy ()
822 __git_compute_merge_strategies
825 __gitcomp "$__git_merge_strategies"
830 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
838 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
840 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
842 git help -a|egrep '^ [a-zA-Z0-9]'
846 __git_list_all_commands ()
849 for i in $(__git_commands)
852 *--*) : helper pattern;;
859 __git_compute_all_commands ()
861 test -n "$__git_all_commands" ||
862 __git_all_commands=$(__git_list_all_commands)
865 __git_list_porcelain_commands ()
868 __git_compute_all_commands
869 for i in $__git_all_commands
872 *--*) : helper pattern;;
873 applymbox) : ask gittus;;
874 applypatch) : ask gittus;;
875 archimport) : import;;
876 cat-file) : plumbing;;
877 check-attr) : plumbing;;
878 check-ignore) : plumbing;;
879 check-mailmap) : plumbing;;
880 check-ref-format) : plumbing;;
881 checkout-index) : plumbing;;
882 column) : internal helper;;
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 --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 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.aliasesfiletype)
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
2355 core.deltaBaseCacheLimit
2360 core.fsyncobjectfiles
2366 core.logAllRefUpdates
2367 core.loosecompression
2370 core.packedGitWindowSize
2371 core.packedRefsTimeout
2373 core.precomposeUnicode
2374 core.preferSymlinkRefs
2379 core.repositoryFormatVersion
2381 core.sharedRepository
2388 core.warnAmbiguousRefs
2392 credential.useHttpPath
2394 credentialCache.ignoreSIGHUP
2395 diff.autorefreshindex
2397 diff.ignoreSubmodules
2404 diff.suppressBlankEmpty
2410 fetch.recurseSubmodules
2421 format.subjectprefix
2435 gc.reflogexpireunreachable
2438 gc.worktreePruneExpire
2440 gitcvs.commitmsgannotation
2441 gitcvs.dbTableNamePrefix
2452 gui.copyblamethreshold
2456 gui.matchtrackingbranch
2457 gui.newbranchtemplate
2458 gui.pruneduringfetch
2459 gui.spellingdictionary
2476 http.sslCertPasswordProtected
2481 i18n.logOutputEncoding
2487 imap.preformattedHTML
2497 interactive.singlekey
2513 mergetool.keepBackup
2514 mergetool.keepTemporaries
2519 notes.rewrite.rebase
2523 pack.deltaCacheLimit
2540 receive.denyCurrentBranch
2541 receive.denyDeleteCurrent
2543 receive.denyNonFastForwards
2546 receive.updateserverinfo
2549 repack.usedeltabaseoffset
2553 sendemail.aliasesfile
2554 sendemail.aliasfiletype
2558 sendemail.chainreplyto
2560 sendemail.envelopesender
2564 sendemail.signedoffbycc
2565 sendemail.smtpdomain
2566 sendemail.smtpencryption
2568 sendemail.smtpserver
2569 sendemail.smtpserveroption
2570 sendemail.smtpserverport
2572 sendemail.suppresscc
2573 sendemail.suppressfrom
2578 sendemail.smtpbatchsize
2579 sendemail.smtprelogindelay
2581 status.relativePaths
2582 status.showUntrackedFiles
2583 status.submodulesummary
2586 transfer.unpackLimit
2599 add rename remove set-head set-branches
2600 get-url set-url show prune update
2602 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2603 if [ -z "$subcommand" ]; then
2606 __gitcomp_builtin remote
2609 __gitcomp "$subcommands"
2615 case "$subcommand,$cur" in
2617 __gitcomp_builtin remote_add "--no-tags"
2622 __gitcomp_builtin remote_set-head
2625 __gitcomp_builtin remote_set-branches
2627 set-head,*|set-branches,*)
2628 __git_complete_remote_or_refspec
2631 __gitcomp_builtin remote_update
2634 __gitcomp "$(__git_get_config_variables "remotes")"
2637 __gitcomp_builtin remote_set-url
2640 __gitcomp_builtin remote_get-url
2643 __gitcomp_builtin remote_prune
2646 __gitcomp_nl "$(__git_remotes)"
2655 __gitcomp_builtin replace
2664 local subcommands="clear forget diff remaining status gc"
2665 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2666 if test -z "$subcommand"
2668 __gitcomp "$subcommands"
2675 __git_has_doubledash && return
2679 __gitcomp_builtin reset
2686 __git_revert_inprogress_options="--continue --quit --abort"
2690 __git_find_repo_path
2691 if [ -f "$__git_repo_path"/REVERT_HEAD ]; then
2692 __gitcomp "$__git_revert_inprogress_options"
2697 __gitcomp_builtin revert "--no-edit" \
2698 "$__git_revert_inprogress_options"
2709 __gitcomp_builtin rm
2714 __git_complete_index_file "--cached"
2719 __git_has_doubledash && return
2724 $__git_log_common_options
2725 $__git_log_shortlog_options
2726 --numbered --summary --email
2731 __git_complete_revlist
2736 __git_has_doubledash && return
2739 --pretty=*|--format=*)
2740 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2745 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2749 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
2753 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2755 $__git_diff_common_options
2760 __git_complete_revlist_file
2767 __gitcomp_builtin show-branch "--no-color"
2771 __git_complete_revlist
2776 local save_opts='--all --keep-index --no-keep-index --quiet --patch --include-untracked'
2777 local subcommands='push save list show apply clear drop pop create branch'
2778 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2779 if [ -z "$subcommand" ]; then
2782 __gitcomp "$save_opts"
2785 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2786 __gitcomp "$subcommands"
2791 case "$subcommand,$cur" in
2793 __gitcomp "$save_opts --message"
2796 __gitcomp "$save_opts"
2799 __gitcomp "--index --quiet"
2804 show,--*|branch,--*)
2807 if [ $cword -eq 3 ]; then
2810 __gitcomp_nl "$(__git stash list \
2811 | sed -n -e 's/:.*//p')"
2814 show,*|apply,*|drop,*|pop,*)
2815 __gitcomp_nl "$(__git stash list \
2816 | sed -n -e 's/:.*//p')"
2826 __git_has_doubledash && return
2828 local subcommands="add status init deinit update summary foreach sync"
2829 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2830 if [ -z "$subcommand" ]; then
2836 __gitcomp "$subcommands"
2842 case "$subcommand,$cur" in
2844 __gitcomp "--branch --force --name --reference --depth"
2847 __gitcomp "--cached --recursive"
2850 __gitcomp "--force --all"
2854 --init --remote --no-fetch
2855 --recommend-shallow --no-recommend-shallow
2856 --force --rebase --merge --reference --depth --recursive --jobs
2860 __gitcomp "--cached --files --summary-limit"
2862 foreach,--*|sync,--*)
2863 __gitcomp "--recursive"
2873 init fetch clone rebase dcommit log find-rev
2874 set-tree commit-diff info create-ignore propget
2875 proplist show-ignore show-externals branch tag blame
2876 migrate mkdirs reset gc
2878 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2879 if [ -z "$subcommand" ]; then
2880 __gitcomp "$subcommands"
2882 local remote_opts="--username= --config-dir= --no-auth-cache"
2884 --follow-parent --authors-file= --repack=
2885 --no-metadata --use-svm-props --use-svnsync-props
2886 --log-window-size= --no-checkout --quiet
2887 --repack-flags --use-log-author --localtime
2889 --ignore-paths= --include-paths= $remote_opts
2892 --template= --shared= --trunk= --tags=
2893 --branches= --stdlayout --minimize-url
2894 --no-metadata --use-svm-props --use-svnsync-props
2895 --rewrite-root= --prefix= $remote_opts
2898 --edit --rmdir --find-copies-harder --copy-similarity=
2901 case "$subcommand,$cur" in
2903 __gitcomp "--revision= --fetch-all $fc_opts"
2906 __gitcomp "--revision= $fc_opts $init_opts"
2909 __gitcomp "$init_opts"
2913 --merge --strategy= --verbose --dry-run
2914 --fetch-all --no-rebase --commit-url
2915 --revision --interactive $cmt_opts $fc_opts
2919 __gitcomp "--stdin $cmt_opts $fc_opts"
2921 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2922 show-externals,--*|mkdirs,--*)
2923 __gitcomp "--revision="
2927 --limit= --revision= --verbose --incremental
2928 --oneline --show-commit --non-recursive
2929 --authors-file= --color
2934 --merge --verbose --strategy= --local
2935 --fetch-all --dry-run $fc_opts
2939 __gitcomp "--message= --file= --revision= $cmt_opts"
2945 __gitcomp "--dry-run --message --tag"
2948 __gitcomp "--dry-run --message"
2951 __gitcomp "--git-format"
2955 --config-dir= --ignore-paths= --minimize
2956 --no-auth-cache --username=
2960 __gitcomp "--revision= --parent"
2971 while [ $c -lt $cword ]; do
2974 -d|--delete|-v|--verify)
2975 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2990 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
3000 __gitcomp_builtin tag
3012 local subcommands="add list lock move prune remove unlock"
3013 local subcommand="$(__git_find_on_cmdline "$subcommands")"
3014 if [ -z "$subcommand" ]; then
3015 __gitcomp "$subcommands"
3017 case "$subcommand,$cur" in
3019 __gitcomp_builtin worktree_add
3022 __gitcomp_builtin worktree_list
3025 __gitcomp_builtin worktree_lock
3028 __gitcomp_builtin worktree_prune
3039 __git_complete_common () {
3044 __gitcomp_builtin "$command"
3049 __git_cmds_with_parseopt_helper=
3050 __git_support_parseopt_helper () {
3051 test -n "$__git_cmds_with_parseopt_helper" ||
3052 __git_cmds_with_parseopt_helper="$(__git --list-parseopt-builtins)"
3054 case " $__git_cmds_with_parseopt_helper " in
3064 __git_complete_command () {
3066 local completion_func="_git_${command//-/_}"
3067 if declare -f $completion_func >/dev/null 2>/dev/null; then
3070 elif __git_support_parseopt_helper "$command"; then
3071 __git_complete_common "$command"
3080 local i c=1 command __git_dir __git_repo_path
3081 local __git_C_args C_args_count=0
3083 while [ $c -lt $cword ]; do
3086 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
3087 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
3088 --bare) __git_dir="." ;;
3089 --help) command="help"; break ;;
3090 -c|--work-tree|--namespace) ((c++)) ;;
3091 -C) __git_C_args[C_args_count++]=-C
3093 __git_C_args[C_args_count++]="${words[c]}"
3096 *) command="$i"; break ;;
3101 if [ -z "$command" ]; then
3103 --git-dir|-C|--work-tree)
3104 # these need a path argument, let's fall back to
3105 # Bash filename completion
3109 # we don't support completing these options' arguments
3127 --no-replace-objects
3131 *) __git_compute_porcelain_commands
3132 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
3137 __git_complete_command "$command" && return
3139 local expansion=$(__git_aliased_command "$command")
3140 if [ -n "$expansion" ]; then
3142 __git_complete_command "$expansion"
3148 __git_has_doubledash && return
3150 local __git_repo_path
3151 __git_find_repo_path
3154 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
3160 $__git_log_common_options
3161 $__git_log_gitk_options
3167 __git_complete_revlist
3170 if [[ -n ${ZSH_VERSION-} ]]; then
3171 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
3173 autoload -U +X compinit && compinit
3179 local cur_="${3-$cur}"
3185 local c IFS=$' \t\n'
3193 array[${#array[@]}+1]="$c"
3196 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
3207 compadd -Q -- ${=1} && _ret=0
3216 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
3225 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
3230 local _ret=1 cur cword prev
3231 cur=${words[CURRENT]}
3232 prev=${words[CURRENT-1]}
3234 emulate ksh -c __${service}_main
3235 let _ret && _default && _ret=0
3239 compdef _git git gitk
3245 local cur words cword prev
3246 _get_comp_words_by_ref -n =: cur words cword prev
3250 # Setup completion for certain functions defined above by setting common
3251 # variables and workarounds.
3252 # This is NOT a public function; use at your own risk.
3255 local wrapper="__git_wrap${2}"
3256 eval "$wrapper () { __git_func_wrap $2 ; }"
3257 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
3258 || complete -o default -o nospace -F $wrapper $1
3261 # wrapper for backwards compatibility
3264 __git_wrap__git_main
3267 # wrapper for backwards compatibility
3270 __git_wrap__gitk_main
3273 __git_complete git __git_main
3274 __git_complete gitk __gitk_main
3276 # The following are necessary only for Cygwin, and only are needed
3277 # when the user has tab-completed the executable name and consequently
3278 # included the '.exe' suffix.
3280 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
3281 __git_complete git.exe __git_main