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 # You can set the following environment variables to influence the behavior of
33 # the completion routines:
35 # GIT_COMPLETION_CHECKOUT_NO_GUESS
37 # When set to "1", do not include "DWIM" suggestions in git-checkout
38 # completion (e.g., completing "foo" when "origin/foo" exists).
40 case "$COMP_WORDBREAKS" in
42 *) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
45 # Discovers the path to the git repository taking any '--git-dir=<path>' and
46 # '-C <path>' options into account and stores it in the $__git_repo_path
48 __git_find_repo_path ()
50 if [ -n "$__git_repo_path" ]; then
51 # we already know where it is
55 if [ -n "${__git_C_args-}" ]; then
56 __git_repo_path="$(git "${__git_C_args[@]}" \
57 ${__git_dir:+--git-dir="$__git_dir"} \
58 rev-parse --absolute-git-dir 2>/dev/null)"
59 elif [ -n "${__git_dir-}" ]; then
60 test -d "$__git_dir" &&
61 __git_repo_path="$__git_dir"
62 elif [ -n "${GIT_DIR-}" ]; then
63 test -d "${GIT_DIR-}" &&
64 __git_repo_path="$GIT_DIR"
65 elif [ -d .git ]; then
68 __git_repo_path="$(git rev-parse --git-dir 2>/dev/null)"
72 # Deprecated: use __git_find_repo_path() and $__git_repo_path instead
73 # __gitdir accepts 0 or 1 arguments (i.e., location)
74 # returns location of .git repo
77 if [ -z "${1-}" ]; then
78 __git_find_repo_path || return 1
79 echo "$__git_repo_path"
80 elif [ -d "$1/.git" ]; then
87 # Runs git with all the options given as argument, respecting any
88 # '--git-dir=<path>' and '-C <path>' options present on the command line
91 git ${__git_C_args:+"${__git_C_args[@]}"} \
92 ${__git_dir:+--git-dir="$__git_dir"} "$@" 2>/dev/null
95 # The following function is based on code from:
97 # bash_completion - programmable completion functions for bash 3.2+
99 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
100 # © 2009-2010, Bash Completion Maintainers
101 # <bash-completion-devel@lists.alioth.debian.org>
103 # This program is free software; you can redistribute it and/or modify
104 # it under the terms of the GNU General Public License as published by
105 # the Free Software Foundation; either version 2, or (at your option)
108 # This program is distributed in the hope that it will be useful,
109 # but WITHOUT ANY WARRANTY; without even the implied warranty of
110 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
111 # GNU General Public License for more details.
113 # You should have received a copy of the GNU General Public License
114 # along with this program; if not, see <http://www.gnu.org/licenses/>.
116 # The latest version of this software can be obtained here:
118 # http://bash-completion.alioth.debian.org/
122 # This function can be used to access a tokenized list of words
123 # on the command line:
125 # __git_reassemble_comp_words_by_ref '=:'
126 # if test "${words_[cword_-1]}" = -w
131 # The argument should be a collection of characters from the list of
132 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
135 # This is roughly equivalent to going back in time and setting
136 # COMP_WORDBREAKS to exclude those characters. The intent is to
137 # make option types like --date=<type> and <rev>:<path> easy to
138 # recognize by treating each shell word as a single token.
140 # It is best not to set COMP_WORDBREAKS directly because the value is
141 # shared with other completion scripts. By the time the completion
142 # function gets called, COMP_WORDS has already been populated so local
143 # changes to COMP_WORDBREAKS have no effect.
145 # Output: words_, cword_, cur_.
147 __git_reassemble_comp_words_by_ref()
149 local exclude i j first
150 # Which word separators to exclude?
151 exclude="${1//[^$COMP_WORDBREAKS]}"
153 if [ -z "$exclude" ]; then
154 words_=("${COMP_WORDS[@]}")
157 # List of word completion separators has shrunk;
158 # re-assemble words to complete.
159 for ((i=0, j=0; i < ${#COMP_WORDS[@]}; i++, j++)); do
160 # Append each nonempty word consisting of just
161 # word separator characters to the current word.
165 [ -n "${COMP_WORDS[$i]}" ] &&
166 # word consists of excluded word separators
167 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
169 # Attach to the previous token,
170 # unless the previous token is the command name.
171 if [ $j -ge 2 ] && [ -n "$first" ]; then
175 words_[$j]=${words_[j]}${COMP_WORDS[i]}
176 if [ $i = $COMP_CWORD ]; then
179 if (($i < ${#COMP_WORDS[@]} - 1)); then
186 words_[$j]=${words_[j]}${COMP_WORDS[i]}
187 if [ $i = $COMP_CWORD ]; then
193 if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
194 _get_comp_words_by_ref ()
196 local exclude cur_ words_ cword_
197 if [ "$1" = "-n" ]; then
201 __git_reassemble_comp_words_by_ref "$exclude"
202 cur_=${words_[cword_]}
203 while [ $# -gt 0 ]; do
209 prev=${words_[$cword_-1]}
212 words=("${words_[@]}")
223 # Fills the COMPREPLY array with prefiltered words without any additional
225 # Callers must take care of providing only words that match the current word
226 # to be completed and adding any prefix and/or suffix (trailing space!), if
228 # 1: List of newline-separated matching completion words, complete with
239 local x i=${#COMPREPLY[@]}
241 if [[ "$x" == "$3"* ]]; then
242 COMPREPLY[i++]="$2$x$4"
253 # Generates completion reply, appending a space to possible completion words,
255 # It accepts 1 to 4 arguments:
256 # 1: List of possible completion words.
257 # 2: A prefix to be added to each possible completion word (optional).
258 # 3: Generate possible completion matches for this word (optional).
259 # 4: A suffix to be appended to each possible completion word (optional).
262 local cur_="${3-$cur}"
268 local c i=0 IFS=$' \t\n'
271 if [[ $c == "$cur_"* ]]; then
276 COMPREPLY[i++]="${2-}$c"
283 # Clear the variables caching builtins' options when (re-)sourcing
284 # the completion script.
285 if [[ -n ${ZSH_VERSION-} ]]; then
286 unset $(set |sed -ne 's/^\(__gitcomp_builtin_[a-zA-Z0-9_][a-zA-Z0-9_]*\)=.*/\1/p') 2>/dev/null
288 unset $(compgen -v __gitcomp_builtin_)
291 # This function is equivalent to
293 # __gitcomp "$(git xxx --git-completion-helper) ..."
295 # except that the output is cached. Accept 1-3 arguments:
296 # 1: the git command to execute, this is also the cache key
297 # 2: extra options to be added on top (e.g. negative forms)
298 # 3: options to be excluded
301 # spaces must be replaced with underscore for multi-word
302 # commands, e.g. "git remote add" becomes remote_add.
307 local var=__gitcomp_builtin_"${cmd/-/_}"
309 eval "options=\$$var"
311 if [ -z "$options" ]; then
312 # leading and trailing spaces are significant to make
313 # option removal work correctly.
314 options=" $(__git ${cmd/_/ } --git-completion-helper) $incl "
316 options="${options/ $i / }"
318 eval "$var=\"$options\""
324 # Variation of __gitcomp_nl () that appends to the existing list of
325 # completion candidates, COMPREPLY.
326 __gitcomp_nl_append ()
329 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
332 # Generates completion reply from newline-separated possible completion words
333 # by appending a space to all of them.
334 # It accepts 1 to 4 arguments:
335 # 1: List of possible completion words, separated by a single newline.
336 # 2: A prefix to be added to each possible completion word (optional).
337 # 3: Generate possible completion matches for this word (optional).
338 # 4: A suffix to be appended to each possible completion word instead of
339 # the default space (optional). If specified but empty, nothing is
344 __gitcomp_nl_append "$@"
347 # Generates completion reply with compgen from newline-separated possible
348 # completion filenames.
349 # It accepts 1 to 3 arguments:
350 # 1: List of possible completion filenames, separated by a single newline.
351 # 2: A directory prefix to be added to each possible completion filename
353 # 3: Generate possible completion matches for this word (optional).
358 # XXX does not work when the directory prefix contains a tilde,
359 # since tilde expansion is not applied.
360 # This means that COMPREPLY will be empty and Bash default
361 # completion will be used.
362 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
364 # use a hack to enable file mode in bash < 4
365 compopt -o filenames +o nospace 2>/dev/null ||
366 compgen -f /non-existing-dir/ > /dev/null
369 # Execute 'git ls-files', unless the --committable option is specified, in
370 # which case it runs 'git diff-index' to find out the files that can be
371 # committed. It return paths relative to the directory specified in the first
372 # argument, and using the options specified in the second argument.
373 __git_ls_files_helper ()
375 if [ "$2" == "--committable" ]; then
376 __git -C "$1" diff-index --name-only --relative HEAD
378 # NOTE: $2 is not quoted in order to support multiple options
379 __git -C "$1" ls-files --exclude-standard $2
384 # __git_index_files accepts 1 or 2 arguments:
385 # 1: Options to pass to ls-files (required).
386 # 2: A directory path (optional).
387 # If provided, only files within the specified directory are listed.
388 # Sub directories are never recursed. Path must have a trailing
392 local root="${2-.}" file
394 __git_ls_files_helper "$root" "$1" |
395 while read -r file; do
397 ?*/*) echo "${file%%/*}" ;;
403 # Lists branches from the local repository.
404 # 1: A prefix to be added to each listed branch (optional).
405 # 2: List only branches matching this word (optional; list all branches if
407 # 3: A suffix to be appended to each listed branch (optional).
410 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
412 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
413 "refs/heads/$cur_*" "refs/heads/$cur_*/**"
416 # Lists tags from the local repository.
417 # Accepts the same positional parameters as __git_heads() above.
420 local pfx="${1-}" cur_="${2-}" sfx="${3-}"
422 __git for-each-ref --format="${pfx//\%/%%}%(refname:strip=2)$sfx" \
423 "refs/tags/$cur_*" "refs/tags/$cur_*/**"
426 # Lists refs from the local (by default) or from a remote repository.
427 # It accepts 0, 1 or 2 arguments:
428 # 1: The remote to list refs from (optional; ignored, if set but empty).
429 # Can be the name of a configured remote, a path, or a URL.
430 # 2: In addition to local refs, list unique branches from refs/remotes/ for
431 # 'git checkout's tracking DWIMery (optional; ignored, if set but empty).
432 # 3: A prefix to be added to each listed ref (optional).
433 # 4: List only refs matching this word (optional; list all refs if unset or
435 # 5: A suffix to be appended to each listed ref (optional; ignored, if set
438 # Use __git_complete_refs() instead.
441 local i hash dir track="${2-}"
442 local list_refs_from=path remote="${1-}"
444 local pfx="${3-}" cur_="${4-$cur}" sfx="${5-}"
446 local fer_pfx="${pfx//\%/%%}" # "escape" for-each-ref format specifiers
449 dir="$__git_repo_path"
451 if [ -z "$remote" ]; then
452 if [ -z "$dir" ]; then
456 if __git_is_configured_remote "$remote"; then
457 # configured remote takes precedence over a
458 # local directory with the same name
459 list_refs_from=remote
460 elif [ -d "$remote/.git" ]; then
462 elif [ -d "$remote" ]; then
469 if [ "$list_refs_from" = path ]; then
470 if [[ "$cur_" == ^* ]]; then
479 refs=("$match*" "$match*/**")
483 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD REBASE_HEAD; do
486 if [ -e "$dir/$i" ]; then
492 format="refname:strip=2"
493 refs=("refs/tags/$match*" "refs/tags/$match*/**"
494 "refs/heads/$match*" "refs/heads/$match*/**"
495 "refs/remotes/$match*" "refs/remotes/$match*/**")
498 __git_dir="$dir" __git for-each-ref --format="$fer_pfx%($format)$sfx" \
500 if [ -n "$track" ]; then
501 # employ the heuristic used by git checkout
502 # Try to find a remote branch that matches the completion word
503 # but only output if the branch name is unique
504 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
505 --sort="refname:strip=3" \
506 "refs/remotes/*/$match*" "refs/remotes/*/$match*/**" | \
513 __git ls-remote "$remote" "$match*" | \
514 while read -r hash i; do
517 *) echo "$pfx$i$sfx" ;;
522 if [ "$list_refs_from" = remote ]; then
524 $match*) echo "${pfx}HEAD$sfx" ;;
526 __git for-each-ref --format="$fer_pfx%(refname:strip=3)$sfx" \
527 "refs/remotes/$remote/$match*" \
528 "refs/remotes/$remote/$match*/**"
532 $match*) query_symref="HEAD" ;;
534 __git ls-remote "$remote" $query_symref \
535 "refs/tags/$match*" "refs/heads/$match*" \
536 "refs/remotes/$match*" |
537 while read -r hash i; do
540 refs/*) echo "$pfx${i#refs/*/}$sfx" ;;
541 *) echo "$pfx$i$sfx" ;; # symbolic refs
549 # Completes refs, short and long, local and remote, symbolic and pseudo.
551 # Usage: __git_complete_refs [<option>]...
552 # --remote=<remote>: The remote to list refs from, can be the name of a
553 # configured remote, a path, or a URL.
554 # --track: List unique remote branches for 'git checkout's tracking DWIMery.
555 # --pfx=<prefix>: A prefix to be added to each ref.
556 # --cur=<word>: The current ref to be completed. Defaults to the current
557 # word to be completed.
558 # --sfx=<suffix>: A suffix to be appended to each ref instead of the default
560 __git_complete_refs ()
562 local remote track pfx cur_="$cur" sfx=" "
564 while test $# != 0; do
566 --remote=*) remote="${1##--remote=}" ;;
567 --track) track="yes" ;;
568 --pfx=*) pfx="${1##--pfx=}" ;;
569 --cur=*) cur_="${1##--cur=}" ;;
570 --sfx=*) sfx="${1##--sfx=}" ;;
576 __gitcomp_direct "$(__git_refs "$remote" "$track" "$pfx" "$cur_" "$sfx")"
579 # __git_refs2 requires 1 argument (to pass to __git_refs)
580 # Deprecated: use __git_complete_fetch_refspecs() instead.
584 for i in $(__git_refs "$1"); do
589 # Completes refspecs for fetching from a remote repository.
590 # 1: The remote repository.
591 # 2: A prefix to be added to each listed refspec (optional).
592 # 3: The ref to be completed as a refspec instead of the current word to be
593 # completed (optional)
594 # 4: A suffix to be appended to each listed refspec instead of the default
596 __git_complete_fetch_refspecs ()
598 local i remote="$1" pfx="${2-}" cur_="${3-$cur}" sfx="${4- }"
601 for i in $(__git_refs "$remote" "" "" "$cur_") ; do
607 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
608 __git_refs_remotes ()
611 __git ls-remote "$1" 'refs/heads/*' | \
612 while read -r hash i; do
613 echo "$i:refs/remotes/$1/${i#refs/heads/}"
620 test -d "$__git_repo_path/remotes" && ls -1 "$__git_repo_path/remotes"
624 # Returns true if $1 matches the name of a configured remote, false otherwise.
625 __git_is_configured_remote ()
628 for remote in $(__git_remotes); do
629 if [ "$remote" = "$1" ]; then
636 __git_list_merge_strategies ()
638 LANG=C LC_ALL=C git merge -s help 2>&1 |
639 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
648 __git_merge_strategies=
649 # 'git merge -s help' (and thus detection of the merge strategy
650 # list) fails, unfortunately, if run outside of any git working
651 # tree. __git_merge_strategies is set to the empty string in
652 # that case, and the detection will be repeated the next time it
654 __git_compute_merge_strategies ()
656 test -n "$__git_merge_strategies" ||
657 __git_merge_strategies=$(__git_list_merge_strategies)
660 __git_complete_revlist_file ()
662 local pfx ls ref cur_="$cur"
682 case "$COMP_WORDBREAKS" in
684 *) pfx="$ref:$pfx" ;;
687 __gitcomp_nl "$(__git ls-tree "$ls" \
688 | sed '/^100... blob /{
704 pfx="${cur_%...*}..."
706 __git_complete_refs --pfx="$pfx" --cur="$cur_"
711 __git_complete_refs --pfx="$pfx" --cur="$cur_"
720 # __git_complete_index_file requires 1 argument:
721 # 1: the options to pass to ls-file
723 # The exception is --committable, which finds the files appropriate commit.
724 __git_complete_index_file ()
726 local pfx="" cur_="$cur"
736 __gitcomp_file "$(__git_index_files "$1" ${pfx:+"$pfx"})" "$pfx" "$cur_"
739 __git_complete_file ()
741 __git_complete_revlist_file
744 __git_complete_revlist ()
746 __git_complete_revlist_file
749 __git_complete_remote_or_refspec ()
751 local cur_="$cur" cmd="${words[1]}"
752 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
753 if [ "$cmd" = "remote" ]; then
756 while [ $c -lt $cword ]; do
759 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
760 -d|--delete) [ "$cmd" = "push" ] && lhs=0 ;;
763 push) no_complete_refspec=1 ;;
771 *) remote="$i"; break ;;
775 if [ -z "$remote" ]; then
776 __gitcomp_nl "$(__git_remotes)"
779 if [ $no_complete_refspec = 1 ]; then
782 [ "$remote" = "." ] && remote=
785 case "$COMP_WORDBREAKS" in
787 *) pfx="${cur_%%:*}:" ;;
799 if [ $lhs = 1 ]; then
800 __git_complete_fetch_refspecs "$remote" "$pfx" "$cur_"
802 __git_complete_refs --pfx="$pfx" --cur="$cur_"
806 if [ $lhs = 1 ]; then
807 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
809 __git_complete_refs --pfx="$pfx" --cur="$cur_"
813 if [ $lhs = 1 ]; then
814 __git_complete_refs --pfx="$pfx" --cur="$cur_"
816 __git_complete_refs --remote="$remote" --pfx="$pfx" --cur="$cur_"
822 __git_complete_strategy ()
824 __git_compute_merge_strategies
827 __gitcomp "$__git_merge_strategies"
832 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
840 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
842 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
844 git help -a|egrep '^ [a-zA-Z0-9]'
848 __git_list_all_commands ()
851 for i in $(__git_commands)
854 *--*) : helper pattern;;
861 __git_compute_all_commands ()
863 test -n "$__git_all_commands" ||
864 __git_all_commands=$(__git_list_all_commands)
867 __git_list_porcelain_commands ()
870 __git_compute_all_commands
871 for i in $__git_all_commands
874 *--*) : helper pattern;;
875 applymbox) : ask gittus;;
876 applypatch) : ask gittus;;
877 archimport) : import;;
878 cat-file) : plumbing;;
879 check-attr) : plumbing;;
880 check-ignore) : plumbing;;
881 check-mailmap) : plumbing;;
882 check-ref-format) : plumbing;;
883 checkout-index) : plumbing;;
884 column) : internal helper;;
885 commit-tree) : plumbing;;
886 count-objects) : infrequent;;
887 credential) : credentials;;
888 credential-*) : credentials helper;;
889 cvsexportcommit) : export;;
890 cvsimport) : import;;
891 cvsserver) : daemon;;
893 diff-files) : plumbing;;
894 diff-index) : plumbing;;
895 diff-tree) : plumbing;;
896 fast-import) : import;;
897 fast-export) : export;;
898 fsck-objects) : plumbing;;
899 fetch-pack) : plumbing;;
900 fmt-merge-msg) : plumbing;;
901 for-each-ref) : plumbing;;
902 hash-object) : plumbing;;
903 http-*) : transport;;
904 index-pack) : plumbing;;
905 init-db) : deprecated;;
906 local-fetch) : plumbing;;
907 ls-files) : plumbing;;
908 ls-remote) : plumbing;;
909 ls-tree) : plumbing;;
910 mailinfo) : plumbing;;
911 mailsplit) : plumbing;;
912 merge-*) : plumbing;;
915 pack-objects) : plumbing;;
916 pack-redundant) : plumbing;;
917 pack-refs) : plumbing;;
918 parse-remote) : plumbing;;
919 patch-id) : plumbing;;
921 prune-packed) : plumbing;;
922 quiltimport) : import;;
923 read-tree) : plumbing;;
924 receive-pack) : plumbing;;
925 remote-*) : transport;;
927 rev-list) : plumbing;;
928 rev-parse) : plumbing;;
929 runstatus) : plumbing;;
930 sh-setup) : internal;;
932 show-ref) : plumbing;;
933 send-pack) : plumbing;;
934 show-index) : plumbing;;
936 stripspace) : plumbing;;
937 symbolic-ref) : plumbing;;
938 unpack-file) : plumbing;;
939 unpack-objects) : plumbing;;
940 update-index) : plumbing;;
941 update-ref) : plumbing;;
942 update-server-info) : daemon;;
943 upload-archive) : plumbing;;
944 upload-pack) : plumbing;;
945 write-tree) : plumbing;;
947 verify-pack) : infrequent;;
948 verify-tag) : plumbing;;
954 __git_porcelain_commands=
955 __git_compute_porcelain_commands ()
957 test -n "$__git_porcelain_commands" ||
958 __git_porcelain_commands=$(__git_list_porcelain_commands)
961 # Lists all set config variables starting with the given section prefix,
962 # with the prefix removed.
963 __git_get_config_variables ()
965 local section="$1" i IFS=$'\n'
966 for i in $(__git config --name-only --get-regexp "^$section\..*"); do
967 echo "${i#$section.}"
971 __git_pretty_aliases ()
973 __git_get_config_variables "pretty"
978 __git_get_config_variables "alias"
981 # __git_aliased_command requires 1 argument
982 __git_aliased_command ()
984 local word cmdline=$(__git config --get "alias.$1")
985 for word in $cmdline; do
991 \!*) : shell command alias ;;
993 *=*) : setting env ;;
995 \(\)) : skip parens of shell function definition ;;
996 {) : skip start of shell helper function ;;
997 :) : skip null command ;;
998 \'*) : skip opening quote after sh -c ;;
1006 # __git_find_on_cmdline requires 1 argument
1007 __git_find_on_cmdline ()
1009 local word subcommand c=1
1010 while [ $c -lt $cword ]; do
1012 for subcommand in $1; do
1013 if [ "$subcommand" = "$word" ]; then
1022 # Echo the value of an option set on the command line or config
1024 # $1: short option name
1025 # $2: long option name including =
1026 # $3: list of possible values
1027 # $4: config string (optional)
1030 # result="$(__git_get_option_value "-d" "--do-something=" \
1031 # "yes no" "core.doSomething")"
1033 # result is then either empty (no option set) or "yes" or "no"
1035 # __git_get_option_value requires 3 arguments
1036 __git_get_option_value ()
1038 local c short_opt long_opt val
1039 local result= values config_key word
1047 while [ $c -ge 0 ]; do
1049 for val in $values; do
1050 if [ "$short_opt$val" = "$word" ] ||
1051 [ "$long_opt$val" = "$word" ]; then
1059 if [ -n "$config_key" ] && [ -z "$result" ]; then
1060 result="$(__git config "$config_key")"
1066 __git_has_doubledash ()
1069 while [ $c -lt $cword ]; do
1070 if [ "--" = "${words[c]}" ]; then
1078 # Try to count non option arguments passed on the command line for the
1079 # specified git command.
1080 # When options are used, it is necessary to use the special -- option to
1081 # tell the implementation were non option arguments begin.
1082 # XXX this can not be improved, since options can appear everywhere, as
1086 # __git_count_arguments requires 1 argument: the git command executed.
1087 __git_count_arguments ()
1091 # Skip "git" (first argument)
1092 for ((i=1; i < ${#words[@]}; i++)); do
1097 # Good; we can assume that the following are only non
1102 # Skip the specified git command and discard git
1115 __git_whitespacelist="nowarn warn error error-all fix"
1116 __git_am_inprogress_options="--skip --continue --resolved --abort --quit --show-current-patch"
1120 __git_find_repo_path
1121 if [ -d "$__git_repo_path"/rebase-apply ]; then
1122 __gitcomp "$__git_am_inprogress_options"
1127 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1131 __gitcomp_builtin am "--no-utf8" \
1132 "$__git_am_inprogress_options"
1141 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1145 __gitcomp_builtin apply
1154 __gitcomp_builtin add
1158 local complete_opt="--others --modified --directory --no-empty-directory"
1159 if test -n "$(__git_find_on_cmdline "-u --update")"
1161 complete_opt="--modified"
1163 __git_complete_index_file "$complete_opt"
1170 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
1174 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
1179 --format= --list --verbose
1180 --prefix= --remote= --exec= --output
1190 __git_has_doubledash && return
1192 local subcommands="start bad good skip reset visualize replay log run"
1193 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1194 if [ -z "$subcommand" ]; then
1195 __git_find_repo_path
1196 if [ -f "$__git_repo_path"/BISECT_START ]; then
1197 __gitcomp "$subcommands"
1199 __gitcomp "replay start"
1204 case "$subcommand" in
1205 bad|good|reset|skip|start)
1215 local i c=1 only_local_ref="n" has_r="n"
1217 while [ $c -lt $cword ]; do
1220 -d|--delete|-m|--move) only_local_ref="y" ;;
1221 -r|--remotes) has_r="y" ;;
1227 --set-upstream-to=*)
1228 __git_complete_refs --cur="${cur##--set-upstream-to=}"
1231 __gitcomp_builtin branch "--no-color --no-abbrev
1232 --no-track --no-column
1236 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
1237 __gitcomp_direct "$(__git_heads "" "$cur" " ")"
1247 local cmd="${words[2]}"
1250 __gitcomp "create list-heads verify unbundle"
1253 # looking for a file
1258 __git_complete_revlist
1267 __git_has_doubledash && return
1271 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1274 __gitcomp_builtin checkout "--no-track --no-recurse-submodules"
1277 # check if --track, --no-track, or --no-guess was specified
1278 # if so, disable DWIM mode
1279 local flags="--track --no-track --no-guess" track_opt="--track"
1280 if [ "$GIT_COMPLETION_CHECKOUT_NO_GUESS" = "1" ] ||
1281 [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1284 __git_complete_refs $track_opt
1294 __git_cherry_pick_inprogress_options="--continue --quit --abort"
1298 __git_find_repo_path
1299 if [ -f "$__git_repo_path"/CHERRY_PICK_HEAD ]; then
1300 __gitcomp "$__git_cherry_pick_inprogress_options"
1305 __gitcomp_builtin cherry-pick "" \
1306 "$__git_cherry_pick_inprogress_options"
1318 __gitcomp_builtin clean
1323 # XXX should we check for -x option ?
1324 __git_complete_index_file "--others --directory"
1331 __gitcomp_builtin clone "--no-single-branch"
1337 __git_untracked_file_modes="all no normal"
1350 __gitcomp "default scissors strip verbatim whitespace
1351 " "" "${cur##--cleanup=}"
1354 --reuse-message=*|--reedit-message=*|\
1355 --fixup=*|--squash=*)
1356 __git_complete_refs --cur="${cur#*=}"
1359 --untracked-files=*)
1360 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
1364 __gitcomp_builtin commit "--no-edit --verify"
1368 if __git rev-parse --verify --quiet HEAD >/dev/null; then
1369 __git_complete_index_file "--committable"
1371 # This is the first commit
1372 __git_complete_index_file "--cached"
1380 __gitcomp_builtin describe
1386 __git_diff_algorithms="myers minimal patience histogram"
1388 __git_diff_submodule_formats="diff log short"
1390 __git_diff_common_options="--stat --numstat --shortstat --summary
1391 --patch-with-stat --name-only --name-status --color
1392 --no-color --color-words --no-renames --check
1393 --full-index --binary --abbrev --diff-filter=
1394 --find-copies-harder --ignore-cr-at-eol
1395 --text --ignore-space-at-eol --ignore-space-change
1396 --ignore-all-space --ignore-blank-lines --exit-code
1397 --quiet --ext-diff --no-ext-diff
1398 --no-prefix --src-prefix= --dst-prefix=
1399 --inter-hunk-context=
1400 --patience --histogram --minimal
1401 --raw --word-diff --word-diff-regex=
1402 --dirstat --dirstat= --dirstat-by-file
1403 --dirstat-by-file= --cumulative
1405 --submodule --submodule= --ignore-submodules
1410 __git_has_doubledash && return
1414 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1418 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1422 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1423 --base --ours --theirs --no-index
1424 $__git_diff_common_options
1429 __git_complete_revlist_file
1432 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1433 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc codecompare
1438 __git_has_doubledash && return
1442 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1446 __gitcomp_builtin difftool "$__git_diff_common_options
1447 --base --cached --ours --theirs
1448 --pickaxe-all --pickaxe-regex
1454 __git_complete_revlist_file
1457 __git_fetch_recurse_submodules="yes on-demand no"
1462 --recurse-submodules=*)
1463 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1467 __gitcomp_builtin fetch "--no-tags"
1471 __git_complete_remote_or_refspec
1474 __git_format_patch_options="
1475 --stdout --attach --no-attach --thread --thread= --no-thread
1476 --numbered --start-number --numbered-files --keep-subject --signoff
1477 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1478 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1479 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1480 --output-directory --reroll-count --to= --quiet --notes
1483 _git_format_patch ()
1489 " "" "${cur##--thread=}"
1493 __gitcomp "$__git_format_patch_options"
1497 __git_complete_revlist
1504 __gitcomp_builtin fsck "--no-reflogs"
1514 __gitcomp_builtin gc
1525 # Lists matching symbol names from a tag (as in ctags) file.
1526 # 1: List symbol names matching this word.
1527 # 2: The tag file to list symbol names from.
1528 # 3: A prefix to be added to each listed symbol name (optional).
1529 # 4: A suffix to be appended to each listed symbol name (optional).
1530 __git_match_ctag () {
1531 awk -v pfx="${3-}" -v sfx="${4-}" "
1532 /^${1//\//\\/}/ { print pfx \$1 sfx }
1536 # Complete symbol names from a tag file.
1537 # Usage: __git_complete_symbol [<option>]...
1538 # --tags=<file>: The tag file to list symbol names from instead of the
1540 # --pfx=<prefix>: A prefix to be added to each symbol name.
1541 # --cur=<word>: The current symbol name to be completed. Defaults to
1542 # the current word to be completed.
1543 # --sfx=<suffix>: A suffix to be appended to each symbol name instead
1544 # of the default space.
1545 __git_complete_symbol () {
1546 local tags=tags pfx="" cur_="${cur-}" sfx=" "
1548 while test $# != 0; do
1550 --tags=*) tags="${1##--tags=}" ;;
1551 --pfx=*) pfx="${1##--pfx=}" ;;
1552 --cur=*) cur_="${1##--cur=}" ;;
1553 --sfx=*) sfx="${1##--sfx=}" ;;
1559 if test -r "$tags"; then
1560 __gitcomp_direct "$(__git_match_ctag "$cur_" "$tags" "$pfx" "$sfx")"
1566 __git_has_doubledash && return
1570 __gitcomp_builtin grep
1575 case "$cword,$prev" in
1577 __git_complete_symbol && return
1588 __gitcomp_builtin help
1592 __git_compute_all_commands
1593 __gitcomp "$__git_all_commands $(__git_aliases)
1594 attributes cli core-tutorial cvs-migration
1595 diffcore everyday gitk glossary hooks ignore modules
1596 namespaces repository-layout revisions tutorial tutorial-2
1606 false true umask group all world everybody
1607 " "" "${cur##--shared=}"
1611 __gitcomp_builtin init
1621 __gitcomp_builtin ls-files "--no-empty-directory"
1626 # XXX ignore options like --modified and always suggest all cached
1628 __git_complete_index_file "--cached"
1635 __gitcomp_builtin ls-remote
1639 __gitcomp_nl "$(__git_remotes)"
1647 # Options that go well for log, shortlog and gitk
1648 __git_log_common_options="
1650 --branches --tags --remotes
1651 --first-parent --merges --no-merges
1653 --max-age= --since= --after=
1654 --min-age= --until= --before=
1655 --min-parents= --max-parents=
1656 --no-min-parents --no-max-parents
1658 # Options that go well for log and gitk (not shortlog)
1659 __git_log_gitk_options="
1660 --dense --sparse --full-history
1661 --simplify-merges --simplify-by-decoration
1662 --left-right --notes --no-notes
1664 # Options that go well for log and shortlog (not gitk)
1665 __git_log_shortlog_options="
1666 --author= --committer= --grep=
1667 --all-match --invert-grep
1670 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1671 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1675 __git_has_doubledash && return
1676 __git_find_repo_path
1679 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
1682 case "$prev,$cur" in
1684 return # fall back to Bash filename completion
1687 __git_complete_symbol --cur="${cur#:}" --sfx=":"
1691 __git_complete_symbol
1696 --pretty=*|--format=*)
1697 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1702 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1706 __gitcomp "full short no" "" "${cur##--decorate=}"
1710 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1714 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
1719 $__git_log_common_options
1720 $__git_log_shortlog_options
1721 $__git_log_gitk_options
1722 --root --topo-order --date-order --reverse
1723 --follow --full-diff
1724 --abbrev-commit --abbrev=
1725 --relative-date --date=
1726 --pretty= --format= --oneline
1731 --decorate --decorate=
1733 --parents --children
1735 $__git_diff_common_options
1736 --pickaxe-all --pickaxe-regex
1741 return # fall back to Bash filename completion
1744 __git_complete_symbol --cur="${cur#-L:}" --sfx=":"
1748 __git_complete_symbol --pfx="-G" --cur="${cur#-G}"
1752 __git_complete_symbol --pfx="-S" --cur="${cur#-S}"
1756 __git_complete_revlist
1761 __git_complete_strategy && return
1765 __gitcomp_builtin merge "--no-rerere-autoupdate
1766 --no-commit --no-edit --no-ff
1767 --no-log --no-progress
1768 --no-squash --no-stat
1769 --no-verify-signatures
1780 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1784 __gitcomp "--tool= --prompt --no-prompt"
1794 __gitcomp_builtin merge-base
1805 __gitcomp_builtin mv
1810 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1811 # We need to show both cached and untracked files (including
1812 # empty directories) since this may not be the last argument.
1813 __git_complete_index_file "--cached --others --directory"
1815 __git_complete_index_file "--cached"
1821 __gitcomp_builtin name-rev
1826 local subcommands='add append copy edit get-ref list merge prune remove show'
1827 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1829 case "$subcommand,$cur" in
1831 __gitcomp_builtin notes
1839 __gitcomp "$subcommands --ref"
1843 *,--reuse-message=*|*,--reedit-message=*)
1844 __git_complete_refs --cur="${cur#*=}"
1847 __gitcomp_builtin notes_$subcommand
1850 # this command does not take a ref, do not complete it
1866 __git_complete_strategy && return
1869 --recurse-submodules=*)
1870 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1874 __gitcomp_builtin pull "--no-autostash --no-commit --no-edit
1875 --no-ff --no-log --no-progress --no-rebase
1876 --no-squash --no-stat --no-tags
1877 --no-verify-signatures"
1882 __git_complete_remote_or_refspec
1885 __git_push_recurse_submodules="check on-demand only"
1887 __git_complete_force_with_lease ()
1895 __git_complete_refs --cur="${cur_#*:}"
1898 __git_complete_refs --cur="$cur_"
1907 __gitcomp_nl "$(__git_remotes)"
1910 --recurse-submodules)
1911 __gitcomp "$__git_push_recurse_submodules"
1917 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1920 --recurse-submodules=*)
1921 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1924 --force-with-lease=*)
1925 __git_complete_force_with_lease "${cur##--force-with-lease=}"
1929 __gitcomp_builtin push
1933 __git_complete_remote_or_refspec
1938 __git_find_repo_path
1939 if [ -f "$__git_repo_path"/rebase-merge/interactive ]; then
1940 __gitcomp "--continue --skip --abort --quit --edit-todo --show-current-patch"
1942 elif [ -d "$__git_repo_path"/rebase-apply ] || \
1943 [ -d "$__git_repo_path"/rebase-merge ]; then
1944 __gitcomp "--continue --skip --abort --quit --show-current-patch"
1947 __git_complete_strategy && return
1950 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1955 --onto --merge --strategy --interactive
1956 --preserve-merges --stat --no-stat
1957 --committer-date-is-author-date --ignore-date
1958 --ignore-whitespace --whitespace=
1959 --autosquash --no-autosquash
1960 --fork-point --no-fork-point
1961 --autostash --no-autostash
1962 --verify --no-verify
1963 --keep-empty --root --force-rebase --no-ff
1975 local subcommands="show delete expire"
1976 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1978 if [ -z "$subcommand" ]; then
1979 __gitcomp "$subcommands"
1985 __git_send_email_confirm_options="always never auto cc compose"
1986 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1991 --to|--cc|--bcc|--from)
1992 __gitcomp "$(__git send-email --dump-aliases)"
2000 $__git_send_email_confirm_options
2001 " "" "${cur##--confirm=}"
2006 $__git_send_email_suppresscc_options
2007 " "" "${cur##--suppress-cc=}"
2011 --smtp-encryption=*)
2012 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
2018 " "" "${cur##--thread=}"
2021 --to=*|--cc=*|--bcc=*|--from=*)
2022 __gitcomp "$(__git send-email --dump-aliases)" "" "${cur#--*=}"
2026 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
2027 --compose --confirm= --dry-run --envelope-sender
2029 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
2030 --no-suppress-from --no-thread --quiet --reply-to
2031 --signed-off-by-cc --smtp-pass --smtp-server
2032 --smtp-server-port --smtp-encryption= --smtp-user
2033 --subject --suppress-cc= --suppress-from --thread --to
2034 --validate --no-validate
2035 $__git_format_patch_options"
2039 __git_complete_revlist
2050 local untracked_state
2053 --ignore-submodules=*)
2054 __gitcomp "none untracked dirty all" "" "${cur##--ignore-submodules=}"
2057 --untracked-files=*)
2058 __gitcomp "$__git_untracked_file_modes" "" "${cur##--untracked-files=}"
2063 always never auto column row plain dense nodense
2064 " "" "${cur##--column=}"
2068 __gitcomp_builtin status "--no-column"
2073 untracked_state="$(__git_get_option_value "-u" "--untracked-files=" \
2074 "$__git_untracked_file_modes" "status.showUntrackedFiles")"
2076 case "$untracked_state" in
2078 # --ignored option does not matter
2082 complete_opt="--cached --directory --no-empty-directory --others"
2084 if [ -n "$(__git_find_on_cmdline "--ignored")" ]; then
2085 complete_opt="$complete_opt --ignored --exclude=*"
2090 __git_complete_index_file "$complete_opt"
2093 __git_config_get_set_variables ()
2095 local prevword word config_file= c=$cword
2096 while [ $c -gt 1 ]; do
2099 --system|--global|--local|--file=*)
2104 config_file="$word $prevword"
2112 __git config $config_file --name-only --list
2118 branch.*.remote|branch.*.pushremote)
2119 __gitcomp_nl "$(__git_remotes)"
2127 __gitcomp "false true preserve interactive"
2131 __gitcomp_nl "$(__git_remotes)"
2135 local remote="${prev#remote.}"
2136 remote="${remote%.fetch}"
2137 if [ -z "$cur" ]; then
2138 __gitcomp_nl "refs/heads/" "" "" ""
2141 __gitcomp_nl "$(__git_refs_remotes "$remote")"
2145 local remote="${prev#remote.}"
2146 remote="${remote%.push}"
2147 __gitcomp_nl "$(__git for-each-ref \
2148 --format='%(refname):%(refname)' refs/heads)"
2151 pull.twohead|pull.octopus)
2152 __git_compute_merge_strategies
2153 __gitcomp "$__git_merge_strategies"
2156 color.branch|color.diff|color.interactive|\
2157 color.showbranch|color.status|color.ui)
2158 __gitcomp "always never auto"
2162 __gitcomp "false true"
2167 normal black red green yellow blue magenta cyan white
2168 bold dim ul blink reverse
2173 __gitcomp "log short"
2177 __gitcomp "man info web html"
2181 __gitcomp "$__git_log_date_formats"
2184 sendemail.aliasesfiletype)
2185 __gitcomp "mutt mailrc pine elm gnus"
2189 __gitcomp "$__git_send_email_confirm_options"
2192 sendemail.suppresscc)
2193 __gitcomp "$__git_send_email_suppresscc_options"
2196 sendemail.transferencoding)
2197 __gitcomp "7bit 8bit quoted-printable base64"
2200 --get|--get-all|--unset|--unset-all)
2201 __gitcomp_nl "$(__git_config_get_set_variables)"
2210 __gitcomp_builtin config
2214 local pfx="${cur%.*}." cur_="${cur##*.}"
2215 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
2219 local pfx="${cur%.*}." cur_="${cur#*.}"
2220 __gitcomp_direct "$(__git_heads "$pfx" "$cur_" ".")"
2221 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
2225 local pfx="${cur%.*}." cur_="${cur##*.}"
2227 argprompt cmd confirm needsfile noconsole norescan
2228 prompt revprompt revunmerged title
2233 local pfx="${cur%.*}." cur_="${cur##*.}"
2234 __gitcomp "cmd path" "$pfx" "$cur_"
2238 local pfx="${cur%.*}." cur_="${cur##*.}"
2239 __gitcomp "cmd path" "$pfx" "$cur_"
2243 local pfx="${cur%.*}." cur_="${cur##*.}"
2244 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
2248 local pfx="${cur%.*}." cur_="${cur#*.}"
2249 __git_compute_all_commands
2250 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
2254 local pfx="${cur%.*}." cur_="${cur##*.}"
2256 url proxy fetch push mirror skipDefaultUpdate
2257 receivepack uploadpack tagopt pushurl
2262 local pfx="${cur%.*}." cur_="${cur#*.}"
2263 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
2264 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
2268 local pfx="${cur%.*}." cur_="${cur##*.}"
2269 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
2276 advice.commitBeforeMerge
2278 advice.implicitIdentity
2279 advice.pushAlreadyExists
2280 advice.pushFetchFirst
2281 advice.pushNeedsForce
2282 advice.pushNonFFCurrent
2283 advice.pushNonFFMatching
2284 advice.pushUpdateRejected
2285 advice.resolveConflict
2288 advice.statusUoption
2293 apply.ignorewhitespace
2295 branch.autosetupmerge
2296 branch.autosetuprebase
2300 color.branch.current
2305 color.decorate.branch
2306 color.decorate.remoteBranch
2307 color.decorate.stash
2317 color.diff.whitespace
2322 color.grep.linenumber
2325 color.grep.separator
2327 color.interactive.error
2328 color.interactive.header
2329 color.interactive.help
2330 color.interactive.prompt
2335 color.status.changed
2337 color.status.localBranch
2338 color.status.nobranch
2339 color.status.remoteBranch
2340 color.status.unmerged
2341 color.status.untracked
2342 color.status.updated
2354 core.bigFileThreshold
2359 core.deltaBaseCacheLimit
2364 core.fsyncobjectfiles
2370 core.logAllRefUpdates
2371 core.loosecompression
2374 core.packedGitWindowSize
2375 core.packedRefsTimeout
2377 core.precomposeUnicode
2378 core.preferSymlinkRefs
2383 core.repositoryFormatVersion
2385 core.sharedRepository
2392 core.warnAmbiguousRefs
2396 credential.useHttpPath
2398 credentialCache.ignoreSIGHUP
2399 diff.autorefreshindex
2401 diff.ignoreSubmodules
2408 diff.suppressBlankEmpty
2414 fetch.recurseSubmodules
2425 format.subjectprefix
2439 gc.reflogexpireunreachable
2442 gc.worktreePruneExpire
2444 gitcvs.commitmsgannotation
2445 gitcvs.dbTableNamePrefix
2456 gui.copyblamethreshold
2460 gui.matchtrackingbranch
2461 gui.newbranchtemplate
2462 gui.pruneduringfetch
2463 gui.spellingdictionary
2480 http.sslCertPasswordProtected
2485 i18n.logOutputEncoding
2491 imap.preformattedHTML
2501 interactive.singlekey
2517 mergetool.keepBackup
2518 mergetool.keepTemporaries
2523 notes.rewrite.rebase
2527 pack.deltaCacheLimit
2544 receive.denyCurrentBranch
2545 receive.denyDeleteCurrent
2547 receive.denyNonFastForwards
2550 receive.updateserverinfo
2553 repack.usedeltabaseoffset
2557 sendemail.aliasesfile
2558 sendemail.aliasfiletype
2562 sendemail.chainreplyto
2564 sendemail.envelopesender
2568 sendemail.signedoffbycc
2569 sendemail.smtpdomain
2570 sendemail.smtpencryption
2572 sendemail.smtpserver
2573 sendemail.smtpserveroption
2574 sendemail.smtpserverport
2576 sendemail.suppresscc
2577 sendemail.suppressfrom
2582 sendemail.smtpbatchsize
2583 sendemail.smtprelogindelay
2585 status.relativePaths
2586 status.showUntrackedFiles
2587 status.submodulesummary
2590 transfer.unpackLimit
2603 add rename remove set-head set-branches
2604 get-url set-url show prune update
2606 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2607 if [ -z "$subcommand" ]; then
2610 __gitcomp_builtin remote
2613 __gitcomp "$subcommands"
2619 case "$subcommand,$cur" in
2621 __gitcomp_builtin remote_add "--no-tags"
2626 __gitcomp_builtin remote_set-head
2629 __gitcomp_builtin remote_set-branches
2631 set-head,*|set-branches,*)
2632 __git_complete_remote_or_refspec
2635 __gitcomp_builtin remote_update
2638 __gitcomp "$(__git_get_config_variables "remotes")"
2641 __gitcomp_builtin remote_set-url
2644 __gitcomp_builtin remote_get-url
2647 __gitcomp_builtin remote_prune
2650 __gitcomp_nl "$(__git_remotes)"
2659 __gitcomp_builtin replace
2668 local subcommands="clear forget diff remaining status gc"
2669 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2670 if test -z "$subcommand"
2672 __gitcomp "$subcommands"
2679 __git_has_doubledash && return
2683 __gitcomp_builtin reset
2690 __git_revert_inprogress_options="--continue --quit --abort"
2694 __git_find_repo_path
2695 if [ -f "$__git_repo_path"/REVERT_HEAD ]; then
2696 __gitcomp "$__git_revert_inprogress_options"
2701 __gitcomp_builtin revert "--no-edit" \
2702 "$__git_revert_inprogress_options"
2713 __gitcomp_builtin rm
2718 __git_complete_index_file "--cached"
2723 __git_has_doubledash && return
2728 $__git_log_common_options
2729 $__git_log_shortlog_options
2730 --numbered --summary --email
2735 __git_complete_revlist
2740 __git_has_doubledash && return
2743 --pretty=*|--format=*)
2744 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2749 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2753 __gitcomp "$__git_diff_submodule_formats" "" "${cur##--submodule=}"
2757 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2759 $__git_diff_common_options
2764 __git_complete_revlist_file
2771 __gitcomp_builtin show-branch "--no-color"
2775 __git_complete_revlist
2780 local save_opts='--all --keep-index --no-keep-index --quiet --patch --include-untracked'
2781 local subcommands='push save list show apply clear drop pop create branch'
2782 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2783 if [ -z "$subcommand" ]; then
2786 __gitcomp "$save_opts"
2789 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2790 __gitcomp "$subcommands"
2795 case "$subcommand,$cur" in
2797 __gitcomp "$save_opts --message"
2800 __gitcomp "$save_opts"
2803 __gitcomp "--index --quiet"
2808 show,--*|branch,--*)
2811 if [ $cword -eq 3 ]; then
2814 __gitcomp_nl "$(__git stash list \
2815 | sed -n -e 's/:.*//p')"
2818 show,*|apply,*|drop,*|pop,*)
2819 __gitcomp_nl "$(__git stash list \
2820 | sed -n -e 's/:.*//p')"
2830 __git_has_doubledash && return
2832 local subcommands="add status init deinit update summary foreach sync"
2833 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2834 if [ -z "$subcommand" ]; then
2840 __gitcomp "$subcommands"
2846 case "$subcommand,$cur" in
2848 __gitcomp "--branch --force --name --reference --depth"
2851 __gitcomp "--cached --recursive"
2854 __gitcomp "--force --all"
2858 --init --remote --no-fetch
2859 --recommend-shallow --no-recommend-shallow
2860 --force --rebase --merge --reference --depth --recursive --jobs
2864 __gitcomp "--cached --files --summary-limit"
2866 foreach,--*|sync,--*)
2867 __gitcomp "--recursive"
2877 init fetch clone rebase dcommit log find-rev
2878 set-tree commit-diff info create-ignore propget
2879 proplist show-ignore show-externals branch tag blame
2880 migrate mkdirs reset gc
2882 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2883 if [ -z "$subcommand" ]; then
2884 __gitcomp "$subcommands"
2886 local remote_opts="--username= --config-dir= --no-auth-cache"
2888 --follow-parent --authors-file= --repack=
2889 --no-metadata --use-svm-props --use-svnsync-props
2890 --log-window-size= --no-checkout --quiet
2891 --repack-flags --use-log-author --localtime
2893 --ignore-paths= --include-paths= $remote_opts
2896 --template= --shared= --trunk= --tags=
2897 --branches= --stdlayout --minimize-url
2898 --no-metadata --use-svm-props --use-svnsync-props
2899 --rewrite-root= --prefix= $remote_opts
2902 --edit --rmdir --find-copies-harder --copy-similarity=
2905 case "$subcommand,$cur" in
2907 __gitcomp "--revision= --fetch-all $fc_opts"
2910 __gitcomp "--revision= $fc_opts $init_opts"
2913 __gitcomp "$init_opts"
2917 --merge --strategy= --verbose --dry-run
2918 --fetch-all --no-rebase --commit-url
2919 --revision --interactive $cmt_opts $fc_opts
2923 __gitcomp "--stdin $cmt_opts $fc_opts"
2925 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2926 show-externals,--*|mkdirs,--*)
2927 __gitcomp "--revision="
2931 --limit= --revision= --verbose --incremental
2932 --oneline --show-commit --non-recursive
2933 --authors-file= --color
2938 --merge --verbose --strategy= --local
2939 --fetch-all --dry-run $fc_opts
2943 __gitcomp "--message= --file= --revision= $cmt_opts"
2949 __gitcomp "--dry-run --message --tag"
2952 __gitcomp "--dry-run --message"
2955 __gitcomp "--git-format"
2959 --config-dir= --ignore-paths= --minimize
2960 --no-auth-cache --username=
2964 __gitcomp "--revision= --parent"
2975 while [ $c -lt $cword ]; do
2978 -d|--delete|-v|--verify)
2979 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
2994 __gitcomp_direct "$(__git_tags "" "$cur" " ")"
3004 __gitcomp_builtin tag
3016 local subcommands="add list lock move prune remove unlock"
3017 local subcommand="$(__git_find_on_cmdline "$subcommands")"
3018 if [ -z "$subcommand" ]; then
3019 __gitcomp "$subcommands"
3021 case "$subcommand,$cur" in
3023 __gitcomp_builtin worktree_add
3026 __gitcomp_builtin worktree_list
3029 __gitcomp_builtin worktree_lock
3032 __gitcomp_builtin worktree_prune
3045 local i c=1 command __git_dir __git_repo_path
3046 local __git_C_args C_args_count=0
3048 while [ $c -lt $cword ]; do
3051 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
3052 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
3053 --bare) __git_dir="." ;;
3054 --help) command="help"; break ;;
3055 -c|--work-tree|--namespace) ((c++)) ;;
3056 -C) __git_C_args[C_args_count++]=-C
3058 __git_C_args[C_args_count++]="${words[c]}"
3061 *) command="$i"; break ;;
3066 if [ -z "$command" ]; then
3068 --git-dir|-C|--work-tree)
3069 # these need a path argument, let's fall back to
3070 # Bash filename completion
3074 # we don't support completing these options' arguments
3092 --no-replace-objects
3096 *) __git_compute_porcelain_commands
3097 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
3102 local completion_func="_git_${command//-/_}"
3103 declare -f $completion_func >/dev/null 2>/dev/null && $completion_func && return
3105 local expansion=$(__git_aliased_command "$command")
3106 if [ -n "$expansion" ]; then
3108 completion_func="_git_${expansion//-/_}"
3109 declare -f $completion_func >/dev/null 2>/dev/null && $completion_func
3115 __git_has_doubledash && return
3117 local __git_repo_path
3118 __git_find_repo_path
3121 if [ -f "$__git_repo_path/MERGE_HEAD" ]; then
3127 $__git_log_common_options
3128 $__git_log_gitk_options
3134 __git_complete_revlist
3137 if [[ -n ${ZSH_VERSION-} ]]; then
3138 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
3140 autoload -U +X compinit && compinit
3146 local cur_="${3-$cur}"
3152 local c IFS=$' \t\n'
3160 array[${#array[@]}+1]="$c"
3163 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
3174 compadd -Q -- ${=1} && _ret=0
3183 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
3192 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
3197 local _ret=1 cur cword prev
3198 cur=${words[CURRENT]}
3199 prev=${words[CURRENT-1]}
3201 emulate ksh -c __${service}_main
3202 let _ret && _default && _ret=0
3206 compdef _git git gitk
3212 local cur words cword prev
3213 _get_comp_words_by_ref -n =: cur words cword prev
3217 # Setup completion for certain functions defined above by setting common
3218 # variables and workarounds.
3219 # This is NOT a public function; use at your own risk.
3222 local wrapper="__git_wrap${2}"
3223 eval "$wrapper () { __git_func_wrap $2 ; }"
3224 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
3225 || complete -o default -o nospace -F $wrapper $1
3228 # wrapper for backwards compatibility
3231 __git_wrap__git_main
3234 # wrapper for backwards compatibility
3237 __git_wrap__gitk_main
3240 __git_complete git __git_main
3241 __git_complete gitk __gitk_main
3243 # The following are necessary only for Cygwin, and only are needed
3244 # when the user has tab-completed the executable name and consequently
3245 # included the '.exe' suffix.
3247 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
3248 __git_complete git.exe __git_main