3 # bash/zsh completion support for core Git.
5 # Copyright (C) 2006,2007 Shawn O. Pearce <spearce@spearce.org>
6 # Conceptually based on gitcompletion (http://gitweb.hawaga.org.uk/).
7 # Distributed under the GNU General Public License, version 2.0.
9 # The contained completion routines provide support for completing:
11 # *) local and remote branch names
12 # *) local and remote tag names
13 # *) .git/remotes file names
14 # *) git 'subcommands'
15 # *) tree paths within 'ref:path/to/file' expressions
16 # *) file paths within current working directory and index
17 # *) common --long-options
19 # To use these routines:
21 # 1) Copy this file to somewhere (e.g. ~/.git-completion.sh).
22 # 2) Add the following line to your .bashrc/.zshrc:
23 # source ~/.git-completion.sh
24 # 3) Consider changing your PS1 to also show the current branch,
25 # see git-prompt.sh for details.
27 case "$COMP_WORDBREAKS" in
29 *) COMP_WORDBREAKS
="$COMP_WORDBREAKS:"
32 # __gitdir accepts 0 or 1 arguments (i.e., location)
33 # returns location of .git repo
36 # Note: this function is duplicated in git-prompt.sh
37 # When updating it, make sure you update the other one to match.
38 if [ -z "${1-}" ]; then
39 if [ -n "${__git_dir-}" ]; then
41 elif [ -n "${GIT_DIR-}" ]; then
42 test -d "${GIT_DIR-}" ||
return 1
44 elif [ -d .git
]; then
47 git rev-parse
--git-dir 2>/dev
/null
49 elif [ -d "$1/.git" ]; then
69 # The following function is based on code from:
71 # bash_completion - programmable completion functions for bash 3.2+
73 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
74 # © 2009-2010, Bash Completion Maintainers
75 # <bash-completion-devel@lists.alioth.debian.org>
77 # This program is free software; you can redistribute it and/or modify
78 # it under the terms of the GNU General Public License as published by
79 # the Free Software Foundation; either version 2, or (at your option)
82 # This program is distributed in the hope that it will be useful,
83 # but WITHOUT ANY WARRANTY; without even the implied warranty of
84 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
85 # GNU General Public License for more details.
87 # You should have received a copy of the GNU General Public License
88 # along with this program; if not, write to the Free Software Foundation,
89 # Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
91 # The latest version of this software can be obtained here:
93 # http://bash-completion.alioth.debian.org/
97 # This function can be used to access a tokenized list of words
98 # on the command line:
100 # __git_reassemble_comp_words_by_ref '=:'
101 # if test "${words_[cword_-1]}" = -w
106 # The argument should be a collection of characters from the list of
107 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
110 # This is roughly equivalent to going back in time and setting
111 # COMP_WORDBREAKS to exclude those characters. The intent is to
112 # make option types like --date=<type> and <rev>:<path> easy to
113 # recognize by treating each shell word as a single token.
115 # It is best not to set COMP_WORDBREAKS directly because the value is
116 # shared with other completion scripts. By the time the completion
117 # function gets called, COMP_WORDS has already been populated so local
118 # changes to COMP_WORDBREAKS have no effect.
120 # Output: words_, cword_, cur_.
122 __git_reassemble_comp_words_by_ref
()
124 local exclude i j first
125 # Which word separators to exclude?
126 exclude
="${1//[^$COMP_WORDBREAKS]}"
128 if [ -z "$exclude" ]; then
129 words_
=("${COMP_WORDS[@]}")
132 # List of word completion separators has shrunk;
133 # re-assemble words to complete.
134 for ((i
=0, j
=0; i
< ${#COMP_WORDS[@]}; i
++, j
++)); do
135 # Append each nonempty word consisting of just
136 # word separator characters to the current word.
140 [ -n "${COMP_WORDS[$i]}" ] &&
141 # word consists of excluded word separators
142 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
144 # Attach to the previous token,
145 # unless the previous token is the command name.
146 if [ $j -ge 2 ] && [ -n "$first" ]; then
150 words_
[$j]=${words_[j]}${COMP_WORDS[i]}
151 if [ $i = $COMP_CWORD ]; then
154 if (($i < ${#COMP_WORDS[@]} - 1)); then
161 words_
[$j]=${words_[j]}${COMP_WORDS[i]}
162 if [ $i = $COMP_CWORD ]; then
168 if ! type _get_comp_words_by_ref
>/dev
/null
2>&1; then
169 _get_comp_words_by_ref
()
171 local exclude cur_ words_ cword_
172 if [ "$1" = "-n" ]; then
176 __git_reassemble_comp_words_by_ref
"$exclude"
177 cur_
=${words_[cword_]}
178 while [ $# -gt 0 ]; do
184 prev
=${words_[$cword_-1]}
187 words
=("${words_[@]}")
198 # Generates completion reply with compgen, appending a space to possible
199 # completion words, if necessary.
200 # It accepts 1 to 4 arguments:
201 # 1: List of possible completion words.
202 # 2: A prefix to be added to each possible completion word (optional).
203 # 3: Generate possible completion matches for this word (optional).
204 # 4: A suffix to be appended to each possible completion word (optional).
207 local cur_
="${3-$cur}"
215 COMPREPLY
=($
(compgen
-P "${2-}" \
216 -W "$(__gitcomp_1 "${1-}" "${4-}")" \
222 # Generates completion reply with compgen from newline-separated possible
223 # completion words by appending a space to all of them.
224 # It accepts 1 to 4 arguments:
225 # 1: List of possible completion words, separated by a single newline.
226 # 2: A prefix to be added to each possible completion word (optional).
227 # 3: Generate possible completion matches for this word (optional).
228 # 4: A suffix to be appended to each possible completion word instead of
229 # the default space (optional). If specified but empty, nothing is
234 COMPREPLY
=($
(compgen
-P "${2-}" -S "${4- }" -W "$1" -- "${3-$cur}"))
237 # Generates completion reply with compgen from newline-separated possible
238 # completion filenames.
239 # It accepts 1 to 3 arguments:
240 # 1: List of possible completion filenames, separated by a single newline.
241 # 2: A directory prefix to be added to each possible completion filename
243 # 3: Generate possible completion matches for this word (optional).
248 # XXX does not work when the directory prefix contains a tilde,
249 # since tilde expansion is not applied.
250 # This means that COMPREPLY will be empty and Bash default
251 # completion will be used.
252 COMPREPLY
=($
(compgen
-P "${2-}" -W "$1" -- "${3-$cur}"))
254 # Tell Bash that compspec generates filenames.
255 compopt
-o filenames
2>/dev
/null
258 __git_index_file_list_filter_compat
()
262 while read -r path
; do
264 ?
*/*) echo "${path%%/*}/" ;;
270 __git_index_file_list_filter_bash
()
274 while read -r path
; do
277 # XXX if we append a slash to directory names when using
278 # `compopt -o filenames`, Bash will append another slash.
279 # This is pretty stupid, and this the reason why we have to
280 # define a compatible version for this function.
281 echo "${path%%/*}" ;;
288 # Process path list returned by "ls-files" and "diff-index --name-only"
289 # commands, in order to list only file names relative to a specified
290 # directory, and append a slash to directory names.
291 __git_index_file_list_filter
()
293 # Default to Bash >= 4.x
294 __git_index_file_list_filter_bash
297 # Execute git ls-files, returning paths relative to the directory
298 # specified in the first argument, and using the options specified in
299 # the second argument.
300 __git_ls_files_helper
()
302 # NOTE: $2 is not quoted in order to support multiple options
303 cd "$1" && git ls-files
--exclude-standard $2
307 # Execute git diff-index, returning paths relative to the directory
308 # specified in the first argument, and using the tree object id
309 # specified in the second argument.
310 __git_diff_index_helper
()
312 cd "$1" && git diff-index
--name-only --relative "$2"
315 # __git_index_files accepts 1 or 2 arguments:
316 # 1: Options to pass to ls-files (required).
317 # Supported options are --cached, --modified, --deleted, --others,
319 # 2: A directory path (optional).
320 # If provided, only files within the specified directory are listed.
321 # Sub directories are never recursed. Path must have a trailing
325 local dir
="$(__gitdir)" root
="${2-.}"
327 if [ -d "$dir" ]; then
328 __git_ls_files_helper
"$root" "$1" | __git_index_file_list_filter |
333 # __git_diff_index_files accepts 1 or 2 arguments:
334 # 1) The id of a tree object.
335 # 2) A directory path (optional).
336 # If provided, only files within the specified directory are listed.
337 # Sub directories are never recursed. Path must have a trailing
339 __git_diff_index_files
()
341 local dir
="$(__gitdir)" root
="${2-.}"
343 if [ -d "$dir" ]; then
344 __git_diff_index_helper
"$root" "$1" | __git_index_file_list_filter |
351 local dir
="$(__gitdir)"
352 if [ -d "$dir" ]; then
353 git
--git-dir="$dir" for-each-ref
--format='%(refname:short)' \
361 local dir
="$(__gitdir)"
362 if [ -d "$dir" ]; then
363 git
--git-dir="$dir" for-each-ref
--format='%(refname:short)' \
369 # __git_refs accepts 0, 1 (to pass to __gitdir), or 2 arguments
370 # presence of 2nd argument means use the guess heuristic employed
371 # by checkout for tracking branches
374 local i
hash dir
="$(__gitdir "${1-}")" track
="${2-}"
376 if [ -d "$dir" ]; then
384 for i
in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD
; do
385 if [ -e "$dir/$i" ]; then echo $i; fi
387 format
="refname:short"
388 refs
="refs/tags refs/heads refs/remotes"
391 git
--git-dir="$dir" for-each-ref
--format="%($format)" \
393 if [ -n "$track" ]; then
394 # employ the heuristic used by git checkout
395 # Try to find a remote branch that matches the completion word
396 # but only output if the branch name is unique
398 git
--git-dir="$dir" for-each-ref
--shell --format="ref=%(refname:short)" \
400 while read -r entry
; do
403 if [[ "$ref" == "$cur"* ]]; then
406 done |
sort |
uniq -u
412 git ls-remote
"$dir" "$cur*" 2>/dev
/null | \
413 while read -r hash i
; do
421 git ls-remote
"$dir" HEAD ORIG_HEAD
'refs/tags/*' 'refs/heads/*' 'refs/remotes/*' 2>/dev
/null | \
422 while read -r hash i
; do
425 refs
/*) echo "${i#refs/*/}" ;;
433 # __git_refs2 requires 1 argument (to pass to __git_refs)
437 for i
in $
(__git_refs
"$1"); do
442 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
443 __git_refs_remotes
()
446 git ls-remote
"$1" 'refs/heads/*' 2>/dev
/null | \
447 while read -r hash i
; do
448 echo "$i:refs/remotes/$1/${i#refs/heads/}"
454 local i IFS
=$
'\n' d
="$(__gitdir)"
455 test -d "$d/remotes" && ls -1 "$d/remotes"
456 for i
in $
(git
--git-dir="$d" config
--get-regexp 'remote\..*\.url' 2>/dev
/null
); do
462 __git_list_merge_strategies
()
464 git merge
-s help 2>&1 |
465 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
474 __git_merge_strategies
=
475 # 'git merge -s help' (and thus detection of the merge strategy
476 # list) fails, unfortunately, if run outside of any git working
477 # tree. __git_merge_strategies is set to the empty string in
478 # that case, and the detection will be repeated the next time it
480 __git_compute_merge_strategies
()
482 test -n "$__git_merge_strategies" ||
483 __git_merge_strategies
=$
(__git_list_merge_strategies
)
486 __git_complete_revlist_file
()
488 local pfx
ls ref cur_
="$cur"
508 case "$COMP_WORDBREAKS" in
510 *) pfx
="$ref:$pfx" ;;
513 __gitcomp_nl
"$(git --git-dir="$
(__gitdir
)" ls-tree "$ls" 2>/dev/null \
514 | sed '/^100... blob /{
530 pfx
="${cur_%...*}..."
532 __gitcomp_nl
"$(__git_refs)" "$pfx" "$cur_"
537 __gitcomp_nl
"$(__git_refs)" "$pfx" "$cur_"
540 __gitcomp_nl
"$(__git_refs)"
546 # __git_complete_index_file requires 1 argument: the options to pass to
548 __git_complete_index_file
()
550 local pfx cur_
="$cur"
558 __gitcomp_file
"$(__git_index_files "$1" "$pfx")" "$pfx" "$cur_"
561 __gitcomp_file
"$(__git_index_files "$1")" "" "$cur_"
566 # __git_complete_diff_index_file requires 1 argument: the id of a tree
568 __git_complete_diff_index_file
()
570 local pfx cur_
="$cur"
578 __gitcomp_file
"$(__git_diff_index_files "$1" "$pfx")" "$pfx" "$cur_"
581 __gitcomp_file
"$(__git_diff_index_files "$1")" "" "$cur_"
586 __git_complete_file
()
588 __git_complete_revlist_file
591 __git_complete_revlist
()
593 __git_complete_revlist_file
596 __git_complete_remote_or_refspec
()
598 local cur_
="$cur" cmd
="${words[1]}"
599 local i c
=2 remote
="" pfx
="" lhs
=1 no_complete_refspec
=0
600 if [ "$cmd" = "remote" ]; then
603 while [ $c -lt $cword ]; do
606 --mirror) [ "$cmd" = "push" ] && no_complete_refspec
=1 ;;
609 push
) no_complete_refspec
=1 ;;
618 *) remote
="$i"; break ;;
622 if [ -z "$remote" ]; then
623 __gitcomp_nl
"$(__git_remotes)"
626 if [ $no_complete_refspec = 1 ]; then
630 [ "$remote" = "." ] && remote
=
633 case "$COMP_WORDBREAKS" in
635 *) pfx
="${cur_%%:*}:" ;;
647 if [ $lhs = 1 ]; then
648 __gitcomp_nl
"$(__git_refs2 "$remote")" "$pfx" "$cur_"
650 __gitcomp_nl
"$(__git_refs)" "$pfx" "$cur_"
654 if [ $lhs = 1 ]; then
655 __gitcomp_nl
"$(__git_refs "$remote")" "$pfx" "$cur_"
657 __gitcomp_nl
"$(__git_refs)" "$pfx" "$cur_"
661 if [ $lhs = 1 ]; then
662 __gitcomp_nl
"$(__git_refs)" "$pfx" "$cur_"
664 __gitcomp_nl
"$(__git_refs "$remote")" "$pfx" "$cur_"
670 __git_complete_strategy
()
672 __git_compute_merge_strategies
675 __gitcomp
"$__git_merge_strategies"
680 __gitcomp
"$__git_merge_strategies" "" "${cur##--strategy=}"
688 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
690 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
692 git
help -a|
egrep '^ [a-zA-Z0-9]'
696 __git_list_all_commands
()
699 for i
in $
(__git_commands
)
702 *--*) : helper pattern
;;
709 __git_compute_all_commands
()
711 test -n "$__git_all_commands" ||
712 __git_all_commands
=$
(__git_list_all_commands
)
715 __git_list_porcelain_commands
()
718 __git_compute_all_commands
719 for i
in $__git_all_commands
722 *--*) : helper pattern
;;
723 applymbox
) : ask gittus
;;
724 applypatch
) : ask gittus
;;
725 archimport
) : import
;;
726 cat-file
) : plumbing
;;
727 check-attr
) : plumbing
;;
728 check-ignore
) : plumbing
;;
729 check-ref-format
) : plumbing
;;
730 checkout-index
) : plumbing
;;
731 commit-tree
) : plumbing
;;
732 count-objects
) : infrequent
;;
733 credential-cache
) : credentials helper
;;
734 credential-store
) : credentials helper
;;
735 cvsexportcommit
) : export;;
736 cvsimport
) : import
;;
737 cvsserver
) : daemon
;;
739 diff-files
) : plumbing
;;
740 diff-index
) : plumbing
;;
741 diff-tree
) : plumbing
;;
742 fast-import
) : import
;;
743 fast-export
) : export;;
744 fsck-objects
) : plumbing
;;
745 fetch-pack
) : plumbing
;;
746 fmt-merge-msg
) : plumbing
;;
747 for-each-ref
) : plumbing
;;
748 hash-object
) : plumbing
;;
749 http-
*) : transport
;;
750 index-pack
) : plumbing
;;
751 init-db
) : deprecated
;;
752 local-fetch
) : plumbing
;;
753 lost-found
) : infrequent
;;
754 ls-files
) : plumbing
;;
755 ls-remote
) : plumbing
;;
756 ls-tree
) : plumbing
;;
757 mailinfo
) : plumbing
;;
758 mailsplit
) : plumbing
;;
759 merge-
*) : plumbing
;;
762 pack-objects
) : plumbing
;;
763 pack-redundant
) : plumbing
;;
764 pack-refs
) : plumbing
;;
765 parse-remote
) : plumbing
;;
766 patch-id
) : plumbing
;;
767 peek-remote
) : plumbing
;;
769 prune-packed
) : plumbing
;;
770 quiltimport
) : import
;;
771 read-tree
) : plumbing
;;
772 receive-pack
) : plumbing
;;
773 remote-
*) : transport
;;
774 repo-config
) : deprecated
;;
776 rev-list
) : plumbing
;;
777 rev-parse
) : plumbing
;;
778 runstatus
) : plumbing
;;
779 sh-setup
) : internal
;;
781 show-ref
) : plumbing
;;
782 send-pack
) : plumbing
;;
783 show-index
) : plumbing
;;
785 stripspace
) : plumbing
;;
786 symbolic-ref
) : plumbing
;;
787 tar-tree
) : deprecated
;;
788 unpack-file
) : plumbing
;;
789 unpack-objects
) : plumbing
;;
790 update-index
) : plumbing
;;
791 update-ref
) : plumbing
;;
792 update-server-info
) : daemon
;;
793 upload-archive
) : plumbing
;;
794 upload-pack
) : plumbing
;;
795 write-tree
) : plumbing
;;
797 verify-pack
) : infrequent
;;
798 verify-tag
) : plumbing
;;
804 __git_porcelain_commands
=
805 __git_compute_porcelain_commands
()
807 __git_compute_all_commands
808 test -n "$__git_porcelain_commands" ||
809 __git_porcelain_commands
=$
(__git_list_porcelain_commands
)
812 __git_pretty_aliases
()
815 for i
in $
(git
--git-dir="$(__gitdir)" config
--get-regexp "pretty\..*" 2>/dev
/null
); do
828 for i
in $
(git
--git-dir="$(__gitdir)" config
--get-regexp "alias\..*" 2>/dev
/null
); do
838 # __git_aliased_command requires 1 argument
839 __git_aliased_command
()
841 local word cmdline
=$
(git
--git-dir="$(__gitdir)" \
842 config
--get "alias.$1")
843 for word
in $cmdline; do
849 \
!*) : shell
command alias ;;
851 *=*) : setting env
;;
860 # __git_find_on_cmdline requires 1 argument
861 __git_find_on_cmdline
()
863 local word subcommand c
=1
864 while [ $c -lt $cword ]; do
866 for subcommand
in $1; do
867 if [ "$subcommand" = "$word" ]; then
876 __git_has_doubledash
()
879 while [ $c -lt $cword ]; do
880 if [ "--" = "${words[c]}" ]; then
888 # Try to count non option arguments passed on the command line for the
889 # specified git command.
890 # When options are used, it is necessary to use the special -- option to
891 # tell the implementation were non option arguments begin.
892 # XXX this can not be improved, since options can appear everywhere, as
896 # __git_count_arguments requires 1 argument: the git command executed.
897 __git_count_arguments
()
901 # Skip "git" (first argument)
902 for ((i
=1; i
< ${#words[@]}; i
++)); do
907 # Good; we can assume that the following are only non
912 # Skip the specified git command and discard git
925 __git_whitespacelist
="nowarn warn error error-all fix"
929 local dir
="$(__gitdir)"
930 if [ -d "$dir"/rebase-apply
]; then
931 __gitcomp
"--skip --continue --resolved --abort"
936 __gitcomp
"$__git_whitespacelist" "" "${cur##--whitespace=}"
941 --3way --committer-date-is-author-date --ignore-date
942 --ignore-whitespace --ignore-space-change
943 --interactive --keep --no-utf8 --signoff --utf8
944 --whitespace= --scissors
955 __gitcomp
"$__git_whitespacelist" "" "${cur##--whitespace=}"
960 --stat --numstat --summary --check --index
961 --cached --index-info --reverse --reject --unidiff-zero
962 --apply --no-add --exclude=
963 --ignore-whitespace --ignore-space-change
964 --whitespace= --inaccurate-eof --verbose
976 --interactive --refresh --patch --update --dry-run
977 --ignore-errors --intent-to-add
982 # XXX should we check for --update and --all options ?
983 __git_complete_index_file
"--others --modified"
990 __gitcomp
"$(git archive --list)" "" "${cur##--format=}"
994 __gitcomp_nl
"$(__git_remotes)" "" "${cur##--remote=}"
999 --format= --list --verbose
1000 --prefix= --remote= --exec=
1010 __git_has_doubledash
&& return
1012 local subcommands
="start bad good skip reset visualize replay log run"
1013 local subcommand
="$(__git_find_on_cmdline "$subcommands")"
1014 if [ -z "$subcommand" ]; then
1015 if [ -f "$(__gitdir)"/BISECT_START
]; then
1016 __gitcomp
"$subcommands"
1018 __gitcomp
"replay start"
1023 case "$subcommand" in
1024 bad|good|
reset|skip|start
)
1025 __gitcomp_nl
"$(__git_refs)"
1035 local i c
=1 only_local_ref
="n" has_r
="n"
1037 while [ $c -lt $cword ]; do
1040 -d|
-m) only_local_ref
="y" ;;
1047 --set-upstream-to=*)
1048 __gitcomp
"$(__git_refs)" "" "${cur##--set-upstream-to=}"
1052 --color --no-color --verbose --abbrev= --no-abbrev
1053 --track --no-track --contains --merged --no-merged
1054 --set-upstream-to= --edit-description --list
1059 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
1060 __gitcomp_nl
"$(__git_heads)"
1062 __gitcomp_nl
"$(__git_refs)"
1070 local cmd
="${words[2]}"
1073 __gitcomp
"create list-heads verify unbundle"
1076 # looking for a file
1081 __git_complete_revlist
1090 __git_has_doubledash
&& return
1094 __gitcomp
"diff3 merge" "" "${cur##--conflict=}"
1098 --quiet --ours --theirs --track --no-track --merge
1099 --conflict= --orphan --patch
1103 # check if --track, --no-track, or --no-guess was specified
1104 # if so, disable DWIM mode
1105 local flags
="--track --no-track --no-guess" track
=1
1106 if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1109 __gitcomp_nl
"$(__git_refs '' $track)"
1116 __gitcomp
"$(__git_refs)"
1123 __gitcomp
"--edit --no-commit"
1126 __gitcomp_nl
"$(__git_refs)"
1135 __gitcomp
"--dry-run --quiet"
1140 # XXX should we check for -x option ?
1141 __git_complete_index_file
"--others"
1174 __gitcomp_nl
"$(__git_refs)" "" "${cur}"
1181 __gitcomp_nl
"$(__git_refs)" "" "${cur}"
1188 __gitcomp
"default strip verbatim whitespace
1189 " "" "${cur##--cleanup=}"
1192 --reuse-message=*|
--reedit-message=*|\
1193 --fixup=*|
--squash=*)
1194 __gitcomp_nl
"$(__git_refs)" "" "${cur#*=}"
1197 --untracked-files=*)
1198 __gitcomp
"all no normal" "" "${cur##--untracked-files=}"
1203 --all --author= --signoff --verify --no-verify
1205 --amend --include --only --interactive
1206 --dry-run --reuse-message= --reedit-message=
1207 --reset-author --file= --message= --template=
1208 --cleanup= --untracked-files --untracked-files=
1209 --verbose --quiet --fixup= --squash=
1214 if git rev-parse
--verify --quiet HEAD
>/dev
/null
; then
1215 __git_complete_diff_index_file
"HEAD"
1217 # This is the first commit
1218 __git_complete_index_file
"--cached"
1227 --all --tags --contains --abbrev= --candidates=
1228 --exact-match --debug --long --match --always
1232 __gitcomp_nl
"$(__git_refs)"
1235 __git_diff_common_options
="--stat --numstat --shortstat --summary
1236 --patch-with-stat --name-only --name-status --color
1237 --no-color --color-words --no-renames --check
1238 --full-index --binary --abbrev --diff-filter=
1239 --find-copies-harder
1240 --text --ignore-space-at-eol --ignore-space-change
1241 --ignore-all-space --exit-code --quiet --ext-diff
1243 --no-prefix --src-prefix= --dst-prefix=
1244 --inter-hunk-context=
1247 --dirstat --dirstat= --dirstat-by-file
1248 --dirstat-by-file= --cumulative
1253 __git_has_doubledash
&& return
1257 __gitcomp
"--cached --staged --pickaxe-all --pickaxe-regex
1258 --base --ours --theirs --no-index
1259 $__git_diff_common_options
1264 __git_complete_revlist_file
1267 __git_mergetools_common
="diffuse ecmerge emerge kdiff3 meld opendiff
1268 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc3 codecompare
1273 __git_has_doubledash
&& return
1277 __gitcomp
"$__git_mergetools_common kompare" "" "${cur##--tool=}"
1281 __gitcomp
"--cached --staged --pickaxe-all --pickaxe-regex
1282 --base --ours --theirs
1283 --no-renames --diff-filter= --find-copies-harder
1284 --relative --ignore-submodules
1292 __git_fetch_options
="
1293 --quiet --verbose --append --upload-pack --force --keep --depth=
1294 --tags --no-tags --all --prune --dry-run
1301 __gitcomp
"$__git_fetch_options"
1305 __git_complete_remote_or_refspec
1308 __git_format_patch_options
="
1309 --stdout --attach --no-attach --thread --thread= --output-directory
1310 --numbered --start-number --numbered-files --keep-subject --signoff
1311 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1312 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1313 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1316 _git_format_patch
()
1322 " "" "${cur##--thread=}"
1326 __gitcomp
"$__git_format_patch_options"
1330 __git_complete_revlist
1338 --tags --root --unreachable --cache --no-reflogs --full
1339 --strict --verbose --lost-found
1351 __gitcomp
"--prune --aggressive"
1363 __git_match_ctag
() {
1364 awk "/^${1////\\/}/ { print \$1 }" "$2"
1369 __git_has_doubledash
&& return
1375 --text --ignore-case --word-regexp --invert-match
1376 --full-name --line-number
1377 --extended-regexp --basic-regexp --fixed-strings
1379 --files-with-matches --name-only
1380 --files-without-match
1383 --and --or --not --all-match
1389 case "$cword,$prev" in
1391 if test -r tags
; then
1392 __gitcomp_nl
"$(__git_match_ctag "$cur" tags)"
1398 __gitcomp_nl
"$(__git_refs)"
1405 __gitcomp
"--all --info --man --web"
1409 __git_compute_all_commands
1410 __gitcomp
"$__git_all_commands $(__git_aliases)
1411 attributes cli core-tutorial cvs-migration
1412 diffcore gitk glossary hooks ignore modules
1413 namespaces repository-layout tutorial tutorial-2
1423 false true umask group all world everybody
1424 " "" "${cur##--shared=}"
1428 __gitcomp
"--quiet --bare --template= --shared --shared="
1439 __gitcomp
"--cached --deleted --modified --others --ignored
1440 --stage --directory --no-empty-directory --unmerged
1441 --killed --exclude= --exclude-from=
1442 --exclude-per-directory= --exclude-standard
1443 --error-unmatch --with-tree= --full-name
1444 --abbrev --ignored --exclude-per-directory
1450 # XXX ignore options like --modified and always suggest all cached
1452 __git_complete_index_file
"--cached"
1457 __gitcomp_nl
"$(__git_remotes)"
1465 # Options that go well for log, shortlog and gitk
1466 __git_log_common_options
="
1468 --branches --tags --remotes
1469 --first-parent --merges --no-merges
1471 --max-age= --since= --after=
1472 --min-age= --until= --before=
1473 --min-parents= --max-parents=
1474 --no-min-parents --no-max-parents
1476 # Options that go well for log and gitk (not shortlog)
1477 __git_log_gitk_options
="
1478 --dense --sparse --full-history
1479 --simplify-merges --simplify-by-decoration
1480 --left-right --notes --no-notes
1482 # Options that go well for log and shortlog (not gitk)
1483 __git_log_shortlog_options
="
1484 --author= --committer= --grep=
1488 __git_log_pretty_formats
="oneline short medium full fuller email raw format:"
1489 __git_log_date_formats
="relative iso8601 rfc2822 short local default raw"
1493 __git_has_doubledash
&& return
1495 local g
="$(git rev-parse --git-dir 2>/dev/null)"
1497 if [ -f "$g/MERGE_HEAD" ]; then
1501 --pretty=*|
--format=*)
1502 __gitcomp
"$__git_log_pretty_formats $(__git_pretty_aliases)
1507 __gitcomp
"$__git_log_date_formats" "" "${cur##--date=}"
1511 __gitcomp
"long short" "" "${cur##--decorate=}"
1516 $__git_log_common_options
1517 $__git_log_shortlog_options
1518 $__git_log_gitk_options
1519 --root --topo-order --date-order --reverse
1520 --follow --full-diff
1521 --abbrev-commit --abbrev=
1522 --relative-date --date=
1523 --pretty= --format= --oneline
1526 --decorate --decorate=
1528 --parents --children
1530 $__git_diff_common_options
1531 --pickaxe-all --pickaxe-regex
1536 __git_complete_revlist
1539 __git_merge_options
="
1540 --no-commit --no-stat --log --no-log --squash --strategy
1541 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1546 __git_complete_strategy
&& return
1550 __gitcomp
"$__git_merge_options"
1553 __gitcomp_nl
"$(__git_refs)"
1560 __gitcomp
"$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1573 __gitcomp_nl
"$(__git_refs)"
1580 __gitcomp
"--dry-run"
1585 if [ $
(__git_count_arguments
"mv") -gt 0 ]; then
1586 # We need to show both cached and untracked files (including
1587 # empty directories) since this may not be the last argument.
1588 __git_complete_index_file
"--cached --others --directory"
1590 __git_complete_index_file
"--cached"
1596 __gitcomp
"--tags --all --stdin"
1601 local subcommands
='add append copy edit list prune remove show'
1602 local subcommand
="$(__git_find_on_cmdline "$subcommands")"
1604 case "$subcommand,$cur" in
1611 __gitcomp_nl
"$(__git_refs)"
1614 __gitcomp
"$subcommands --ref"
1618 add
,--reuse-message=*|append
,--reuse-message=*|\
1619 add
,--reedit-message=*|append
,--reedit-message=*)
1620 __gitcomp_nl
"$(__git_refs)" "" "${cur#*=}"
1623 __gitcomp
'--file= --message= --reedit-message=
1630 __gitcomp
'--dry-run --verbose'
1639 __gitcomp_nl
"$(__git_refs)"
1648 __git_complete_strategy
&& return
1653 --rebase --no-rebase
1654 $__git_merge_options
1655 $__git_fetch_options
1660 __git_complete_remote_or_refspec
1667 __gitcomp_nl
"$(__git_remotes)"
1672 __gitcomp_nl
"$(__git_remotes)" "" "${cur##--repo=}"
1677 --all --mirror --tags --dry-run --force --verbose
1678 --receive-pack= --repo= --set-upstream
1683 __git_complete_remote_or_refspec
1688 local dir
="$(__gitdir)"
1689 if [ -d "$dir"/rebase-apply
] ||
[ -d "$dir"/rebase-merge
]; then
1690 __gitcomp
"--continue --skip --abort"
1693 __git_complete_strategy
&& return
1696 __gitcomp
"$__git_whitespacelist" "" "${cur##--whitespace=}"
1701 --onto --merge --strategy --interactive
1702 --preserve-merges --stat --no-stat
1703 --committer-date-is-author-date --ignore-date
1704 --ignore-whitespace --whitespace=
1710 __gitcomp_nl
"$(__git_refs)"
1715 local subcommands
="show delete expire"
1716 local subcommand
="$(__git_find_on_cmdline "$subcommands")"
1718 if [ -z "$subcommand" ]; then
1719 __gitcomp
"$subcommands"
1721 __gitcomp_nl
"$(__git_refs)"
1725 __git_send_email_confirm_options
="always never auto cc compose"
1726 __git_send_email_suppresscc_options
="author self cc bodycc sob cccmd body all"
1733 $__git_send_email_confirm_options
1734 " "" "${cur##--confirm=}"
1739 $__git_send_email_suppresscc_options
1740 " "" "${cur##--suppress-cc=}"
1744 --smtp-encryption=*)
1745 __gitcomp
"ssl tls" "" "${cur##--smtp-encryption=}"
1751 " "" "${cur##--thread=}"
1755 __gitcomp
"--annotate --bcc --cc --cc-cmd --chain-reply-to
1756 --compose --confirm= --dry-run --envelope-sender
1758 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1759 --no-suppress-from --no-thread --quiet
1760 --signed-off-by-cc --smtp-pass --smtp-server
1761 --smtp-server-port --smtp-encryption= --smtp-user
1762 --subject --suppress-cc= --suppress-from --thread --to
1763 --validate --no-validate
1764 $__git_format_patch_options"
1768 __git_complete_revlist
1776 __git_config_get_set_variables
()
1778 local prevword word config_file
= c
=$cword
1779 while [ $c -gt 1 ]; do
1782 --global|
--system|
--file=*)
1787 config_file
="$word $prevword"
1795 git
--git-dir="$(__gitdir)" config
$config_file --list 2>/dev
/null |
1810 __gitcomp_nl
"$(__git_remotes)"
1814 __gitcomp_nl
"$(__git_refs)"
1818 local remote
="${prev#remote.}"
1819 remote
="${remote%.fetch}"
1820 if [ -z "$cur" ]; then
1821 COMPREPLY
=("refs/heads/")
1824 __gitcomp_nl
"$(__git_refs_remotes "$remote")"
1828 local remote
="${prev#remote.}"
1829 remote
="${remote%.push}"
1830 __gitcomp_nl
"$(git --git-dir="$
(__gitdir
)" \
1831 for-each-ref --format='%(refname):%(refname)' \
1835 pull.twohead|pull.octopus
)
1836 __git_compute_merge_strategies
1837 __gitcomp
"$__git_merge_strategies"
1840 color.branch|color.
diff|color.interactive|\
1841 color.showbranch|color.status|color.ui
)
1842 __gitcomp
"always never auto"
1846 __gitcomp
"false true"
1851 normal black red green yellow blue magenta cyan white
1852 bold dim ul blink reverse
1857 __gitcomp
"man info web html"
1861 __gitcomp
"$__git_log_date_formats"
1864 sendemail.aliasesfiletype
)
1865 __gitcomp
"mutt mailrc pine elm gnus"
1869 __gitcomp
"$__git_send_email_confirm_options"
1872 sendemail.suppresscc
)
1873 __gitcomp
"$__git_send_email_suppresscc_options"
1876 --get|
--get-all|
--unset|
--unset-all)
1877 __gitcomp_nl
"$(__git_config_get_set_variables)"
1888 --global --system --file=
1889 --list --replace-all
1890 --get --get-all --get-regexp
1891 --add --unset --unset-all
1892 --remove-section --rename-section
1897 local pfx
="${cur%.*}." cur_
="${cur##*.}"
1898 __gitcomp
"remote merge mergeoptions rebase" "$pfx" "$cur_"
1902 local pfx
="${cur%.*}." cur_
="${cur#*.}"
1903 __gitcomp_nl
"$(__git_heads)" "$pfx" "$cur_" "."
1907 local pfx
="${cur%.*}." cur_
="${cur##*.}"
1909 argprompt cmd confirm needsfile noconsole norescan
1910 prompt revprompt revunmerged title
1915 local pfx
="${cur%.*}." cur_
="${cur##*.}"
1916 __gitcomp
"cmd path" "$pfx" "$cur_"
1920 local pfx
="${cur%.*}." cur_
="${cur##*.}"
1921 __gitcomp
"cmd path" "$pfx" "$cur_"
1925 local pfx
="${cur%.*}." cur_
="${cur##*.}"
1926 __gitcomp
"cmd path trustExitCode" "$pfx" "$cur_"
1930 local pfx
="${cur%.*}." cur_
="${cur#*.}"
1931 __git_compute_all_commands
1932 __gitcomp_nl
"$__git_all_commands" "$pfx" "$cur_"
1936 local pfx
="${cur%.*}." cur_
="${cur##*.}"
1938 url proxy fetch push mirror skipDefaultUpdate
1939 receivepack uploadpack tagopt pushurl
1944 local pfx
="${cur%.*}." cur_
="${cur#*.}"
1945 __gitcomp_nl
"$(__git_remotes)" "$pfx" "$cur_" "."
1949 local pfx
="${cur%.*}." cur_
="${cur##*.}"
1950 __gitcomp
"insteadOf pushInsteadOf" "$pfx" "$cur_"
1956 advice.commitBeforeMerge
1958 advice.implicitIdentity
1959 advice.pushNonFastForward
1960 advice.resolveConflict
1964 apply.ignorewhitespace
1966 branch.autosetupmerge
1967 branch.autosetuprebase
1971 color.branch.current
1976 color.decorate.branch
1977 color.decorate.remoteBranch
1978 color.decorate.stash
1988 color.diff.whitespace
1993 color.grep.linenumber
1996 color.grep.separator
1998 color.interactive.error
1999 color.interactive.header
2000 color.interactive.help
2001 color.interactive.prompt
2006 color.status.changed
2008 color.status.nobranch
2009 color.status.untracked
2010 color.status.updated
2019 core.bigFileThreshold
2022 core.deltaBaseCacheLimit
2027 core.fsyncobjectfiles
2029 core.ignoreCygwinFSTricks
2032 core.logAllRefUpdates
2033 core.loosecompression
2036 core.packedGitWindowSize
2038 core.preferSymlinkRefs
2041 core.repositoryFormatVersion
2043 core.sharedRepository
2047 core.warnAmbiguousRefs
2050 diff.autorefreshindex
2053 diff.ignoreSubmodules
2058 diff.suppressBlankEmpty
2063 fetch.recurseSubmodules
2072 format.subjectprefix
2083 gc.reflogexpireunreachable
2087 gitcvs.commitmsgannotation
2088 gitcvs.dbTableNamePrefix
2099 gui.copyblamethreshold
2103 gui.matchtrackingbranch
2104 gui.newbranchtemplate
2105 gui.pruneduringfetch
2106 gui.spellingdictionary
2121 http.sslCertPasswordProtected
2126 i18n.logOutputEncoding
2132 imap.preformattedHTML
2142 interactive.singlekey
2158 mergetool.keepBackup
2159 mergetool.keepTemporaries
2164 notes.rewrite.rebase
2168 pack.deltaCacheLimit
2184 receive.denyCurrentBranch
2185 receive.denyDeleteCurrent
2187 receive.denyNonFastForwards
2190 receive.updateserverinfo
2192 repack.usedeltabaseoffset
2196 sendemail.aliasesfile
2197 sendemail.aliasfiletype
2201 sendemail.chainreplyto
2203 sendemail.envelopesender
2207 sendemail.signedoffbycc
2208 sendemail.smtpdomain
2209 sendemail.smtpencryption
2211 sendemail.smtpserver
2212 sendemail.smtpserveroption
2213 sendemail.smtpserverport
2215 sendemail.suppresscc
2216 sendemail.suppressfrom
2221 status.relativePaths
2222 status.showUntrackedFiles
2223 status.submodulesummary
2226 transfer.unpackLimit
2238 local subcommands
="add rename remove set-head set-branches set-url show prune update"
2239 local subcommand
="$(__git_find_on_cmdline "$subcommands")"
2240 if [ -z "$subcommand" ]; then
2241 __gitcomp
"$subcommands"
2245 case "$subcommand" in
2246 rename|remove|set-url|show|prune
)
2247 __gitcomp_nl
"$(__git_remotes)"
2249 set-head|set-branches
)
2250 __git_complete_remote_or_refspec
2253 local i c
='' IFS
=$
'\n'
2254 for i
in $
(git
--git-dir="$(__gitdir)" config
--get-regexp "remotes\..*" 2>/dev
/null
); do
2268 __gitcomp_nl
"$(__git_refs)"
2273 __git_has_doubledash
&& return
2277 __gitcomp
"--merge --mixed --hard --soft --patch"
2281 __gitcomp_nl
"$(__git_refs)"
2288 __gitcomp
"--edit --mainline --no-edit --no-commit --signoff"
2292 __gitcomp_nl
"$(__git_refs)"
2299 __gitcomp
"--cached --dry-run --ignore-unmatch --quiet"
2304 __git_complete_index_file
"--cached"
2309 __git_has_doubledash
&& return
2314 $__git_log_common_options
2315 $__git_log_shortlog_options
2316 --numbered --summary
2321 __git_complete_revlist
2326 __git_has_doubledash
&& return
2329 --pretty=*|
--format=*)
2330 __gitcomp
"$__git_log_pretty_formats $(__git_pretty_aliases)
2335 __gitcomp
"--pretty= --format= --abbrev-commit --oneline
2336 $__git_diff_common_options
2349 --all --remotes --topo-order --current --more=
2350 --list --independent --merge-base --no-name
2352 --sha1-name --sparse --topics --reflog
2357 __git_complete_revlist
2362 local save_opts
='--keep-index --no-keep-index --quiet --patch'
2363 local subcommands
='save list show apply clear drop pop create branch'
2364 local subcommand
="$(__git_find_on_cmdline "$subcommands")"
2365 if [ -z "$subcommand" ]; then
2368 __gitcomp
"$save_opts"
2371 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2372 __gitcomp
"$subcommands"
2379 case "$subcommand,$cur" in
2381 __gitcomp
"$save_opts"
2384 __gitcomp
"--index --quiet"
2386 show
,--*|drop
,--*|branch
,--*)
2389 show
,*|apply
,*|drop
,*|pop
,*|branch
,*)
2390 __gitcomp_nl
"$(git --git-dir="$
(__gitdir
)" stash list \
2391 | sed -n -e 's/:.*//p')"
2402 __git_has_doubledash
&& return
2404 local subcommands
="add status init update summary foreach sync"
2405 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2408 __gitcomp
"--quiet --cached"
2411 __gitcomp
"$subcommands"
2421 init fetch clone rebase dcommit log find-rev
2422 set-tree commit-diff info create-ignore propget
2423 proplist show-ignore show-externals branch tag blame
2424 migrate mkdirs reset gc
2426 local subcommand
="$(__git_find_on_cmdline "$subcommands")"
2427 if [ -z "$subcommand" ]; then
2428 __gitcomp
"$subcommands"
2430 local remote_opts
="--username= --config-dir= --no-auth-cache"
2432 --follow-parent --authors-file= --repack=
2433 --no-metadata --use-svm-props --use-svnsync-props
2434 --log-window-size= --no-checkout --quiet
2435 --repack-flags --use-log-author --localtime
2436 --ignore-paths= $remote_opts
2439 --template= --shared= --trunk= --tags=
2440 --branches= --stdlayout --minimize-url
2441 --no-metadata --use-svm-props --use-svnsync-props
2442 --rewrite-root= --prefix= --use-log-author
2443 --add-author-from $remote_opts
2446 --edit --rmdir --find-copies-harder --copy-similarity=
2449 case "$subcommand,$cur" in
2451 __gitcomp
"--revision= --fetch-all $fc_opts"
2454 __gitcomp
"--revision= $fc_opts $init_opts"
2457 __gitcomp
"$init_opts"
2461 --merge --strategy= --verbose --dry-run
2462 --fetch-all --no-rebase --commit-url
2463 --revision --interactive $cmt_opts $fc_opts
2467 __gitcomp
"--stdin $cmt_opts $fc_opts"
2469 create-ignore
,--*|propget
,--*|proplist
,--*|show-ignore
,--*|\
2470 show-externals
,--*|mkdirs
,--*)
2471 __gitcomp
"--revision="
2475 --limit= --revision= --verbose --incremental
2476 --oneline --show-commit --non-recursive
2477 --authors-file= --color
2482 --merge --verbose --strategy= --local
2483 --fetch-all --dry-run $fc_opts
2487 __gitcomp
"--message= --file= --revision= $cmt_opts"
2493 __gitcomp
"--dry-run --message --tag"
2496 __gitcomp
"--dry-run --message"
2499 __gitcomp
"--git-format"
2503 --config-dir= --ignore-paths= --minimize
2504 --no-auth-cache --username=
2508 __gitcomp
"--revision= --parent"
2520 while [ $c -lt $cword ]; do
2524 __gitcomp_nl
"$(__git_tags)"
2540 __gitcomp_nl
"$(__git_tags)"
2546 __gitcomp_nl
"$(__git_refs)"
2558 local i c
=1 command __git_dir
2560 while [ $c -lt $cword ]; do
2563 --git-dir=*) __git_dir
="${i#--git-dir=}" ;;
2564 --bare) __git_dir
="." ;;
2565 --help) command="help"; break ;;
2568 *) command="$i"; break ;;
2573 if [ -z "$command" ]; then
2587 --no-replace-objects
2591 *) __git_compute_porcelain_commands
2592 __gitcomp
"$__git_porcelain_commands $(__git_aliases)" ;;
2597 local completion_func
="_git_${command//-/_}"
2598 declare -f $completion_func >/dev
/null
&& $completion_func && return
2600 local expansion
=$
(__git_aliased_command
"$command")
2601 if [ -n "$expansion" ]; then
2602 completion_func
="_git_${expansion//-/_}"
2603 declare -f $completion_func >/dev
/null
&& $completion_func
2609 __git_has_doubledash
&& return
2611 local g
="$(__gitdir)"
2613 if [ -f "$g/MERGE_HEAD" ]; then
2619 $__git_log_common_options
2620 $__git_log_gitk_options
2626 __git_complete_revlist
2629 if [[ -n ${ZSH_VERSION-} ]]; then
2630 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2632 autoload
-U +X compinit
&& compinit
2638 local cur_
="${3-$cur}"
2644 local c IFS
=$
' \t\n'
2652 array
[$#array+1]="$c"
2655 compadd
-Q -S '' -p "${2-}" -a -- array
&& _ret
=0
2666 compadd
-Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2675 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2681 local cur cword prev
2682 cur=${words[CURRENT-1]}
2683 prev=${words[CURRENT-2]}
2693 let _ret && _default -S '' && _ret=0
2697 compdef _git git gitk
2699 elif [[ -n ${BASH_VERSION-} ]]; then
2700 if ((${BASH_VERSINFO[0]} < 4)); then
2701 # compopt is not supported
2702 __git_index_file_list_filter ()
2704 __git_index_file_list_filter_compat
2711 local cur words cword prev
2712 _get_comp_words_by_ref -n =: cur words cword prev
2716 # Setup completion for certain functions defined above by setting common
2717 # variables and workarounds.
2718 # This is NOT a public function; use at your own risk.
2721 local wrapper="__git_wrap
${2}"
2722 eval "$wrapper () { __git_func_wrap
$2 ; }"
2723 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2724 || complete -o default -o nospace -F $wrapper $1
2727 # wrapper for backwards compatibility
2730 __git_wrap__git_main
2733 # wrapper for backwards compatibility
2736 __git_wrap__gitk_main
2739 __git_complete git __git_main
2740 __git_complete gitk __gitk_main
2742 # The following are necessary only for Cygwin, and only are needed
2743 # when the user has tab-completed the executable name and consequently
2744 # included the '.exe' suffix.
2746 if [ Cygwin = "$
(uname
-o 2>/dev
/null
)" ]; then
2747 __git_complete git.exe __git_main