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 # *) tree paths within 'ref:path/to/file' expressions
14 # *) file paths within current working directory and index
15 # *) common --long-options
17 # To use these routines:
19 # 1) Copy this file to somewhere (e.g. ~/.git-completion.sh).
20 # 2) Add the following line to your .bashrc/.zshrc:
21 # source ~/.git-completion.sh
22 # 3) Consider changing your PS1 to also show the current branch,
23 # see git-prompt.sh for details.
25 case "$COMP_WORDBREAKS" in
27 *) COMP_WORDBREAKS="$COMP_WORDBREAKS:"
30 # __gitdir accepts 0 or 1 arguments (i.e., location)
31 # returns location of .git repo
34 if [ -z "${1-}" ]; then
35 if [ -n "${__git_dir-}" ]; then
37 elif [ -n "${GIT_DIR-}" ]; then
38 test -d "${GIT_DIR-}" || return 1
40 elif [ -d .git ]; then
43 git rev-parse --git-dir 2>/dev/null
45 elif [ -d "$1/.git" ]; then
52 # The following function is based on code from:
54 # bash_completion - programmable completion functions for bash 3.2+
56 # Copyright © 2006-2008, Ian Macdonald <ian@caliban.org>
57 # © 2009-2010, Bash Completion Maintainers
58 # <bash-completion-devel@lists.alioth.debian.org>
60 # This program is free software; you can redistribute it and/or modify
61 # it under the terms of the GNU General Public License as published by
62 # the Free Software Foundation; either version 2, or (at your option)
65 # This program is distributed in the hope that it will be useful,
66 # but WITHOUT ANY WARRANTY; without even the implied warranty of
67 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
68 # GNU General Public License for more details.
70 # You should have received a copy of the GNU General Public License
71 # along with this program; if not, write to the Free Software Foundation,
72 # Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
74 # The latest version of this software can be obtained here:
76 # http://bash-completion.alioth.debian.org/
80 # This function can be used to access a tokenized list of words
81 # on the command line:
83 # __git_reassemble_comp_words_by_ref '=:'
84 # if test "${words_[cword_-1]}" = -w
89 # The argument should be a collection of characters from the list of
90 # word completion separators (COMP_WORDBREAKS) to treat as ordinary
93 # This is roughly equivalent to going back in time and setting
94 # COMP_WORDBREAKS to exclude those characters. The intent is to
95 # make option types like --date=<type> and <rev>:<path> easy to
96 # recognize by treating each shell word as a single token.
98 # It is best not to set COMP_WORDBREAKS directly because the value is
99 # shared with other completion scripts. By the time the completion
100 # function gets called, COMP_WORDS has already been populated so local
101 # changes to COMP_WORDBREAKS have no effect.
103 # Output: words_, cword_, cur_.
105 __git_reassemble_comp_words_by_ref()
107 local exclude i j first
108 # Which word separators to exclude?
109 exclude="${1//[^$COMP_WORDBREAKS]}"
111 if [ -z "$exclude" ]; then
112 words_=("${COMP_WORDS[@]}")
115 # List of word completion separators has shrunk;
116 # re-assemble words to complete.
117 for ((i=0, j=0; i < ${#COMP_WORDS[@]}; i++, j++)); do
118 # Append each nonempty word consisting of just
119 # word separator characters to the current word.
123 [ -n "${COMP_WORDS[$i]}" ] &&
124 # word consists of excluded word separators
125 [ "${COMP_WORDS[$i]//[^$exclude]}" = "${COMP_WORDS[$i]}" ]
127 # Attach to the previous token,
128 # unless the previous token is the command name.
129 if [ $j -ge 2 ] && [ -n "$first" ]; then
133 words_[$j]=${words_[j]}${COMP_WORDS[i]}
134 if [ $i = $COMP_CWORD ]; then
137 if (($i < ${#COMP_WORDS[@]} - 1)); then
144 words_[$j]=${words_[j]}${COMP_WORDS[i]}
145 if [ $i = $COMP_CWORD ]; then
151 if ! type _get_comp_words_by_ref >/dev/null 2>&1; then
152 _get_comp_words_by_ref ()
154 local exclude cur_ words_ cword_
155 if [ "$1" = "-n" ]; then
159 __git_reassemble_comp_words_by_ref "$exclude"
160 cur_=${words_[cword_]}
161 while [ $# -gt 0 ]; do
167 prev=${words_[$cword_-1]}
170 words=("${words_[@]}")
183 local i=${#COMPREPLY[@]}
185 if [[ "$x" == "$3"* ]]; then
186 COMPREPLY[i++]="$2$x$4"
197 # Generates completion reply, appending a space to possible completion words,
199 # It accepts 1 to 4 arguments:
200 # 1: List of possible completion words.
201 # 2: A prefix to be added to each possible completion word (optional).
202 # 3: Generate possible completion matches for this word (optional).
203 # 4: A suffix to be appended to each possible completion word (optional).
206 local cur_="${3-$cur}"
212 local c i=0 IFS=$' \t\n'
215 if [[ $c == "$cur_"* ]]; then
220 COMPREPLY[i++]="${2-}$c"
227 # Variation of __gitcomp_nl () that appends to the existing list of
228 # completion candidates, COMPREPLY.
229 __gitcomp_nl_append ()
232 __gitcompappend "$1" "${2-}" "${3-$cur}" "${4- }"
235 # Generates completion reply from newline-separated possible completion words
236 # by appending a space to all of them.
237 # It accepts 1 to 4 arguments:
238 # 1: List of possible completion words, separated by a single newline.
239 # 2: A prefix to be added to each possible completion word (optional).
240 # 3: Generate possible completion matches for this word (optional).
241 # 4: A suffix to be appended to each possible completion word instead of
242 # the default space (optional). If specified but empty, nothing is
247 __gitcomp_nl_append "$@"
250 # Generates completion reply with compgen from newline-separated possible
251 # completion filenames.
252 # It accepts 1 to 3 arguments:
253 # 1: List of possible completion filenames, separated by a single newline.
254 # 2: A directory prefix to be added to each possible completion filename
256 # 3: Generate possible completion matches for this word (optional).
261 # XXX does not work when the directory prefix contains a tilde,
262 # since tilde expansion is not applied.
263 # This means that COMPREPLY will be empty and Bash default
264 # completion will be used.
265 __gitcompadd "$1" "${2-}" "${3-$cur}" ""
267 # use a hack to enable file mode in bash < 4
268 compopt -o filenames +o nospace 2>/dev/null ||
269 compgen -f /non-existing-dir/ > /dev/null
272 # Execute 'git ls-files', unless the --committable option is specified, in
273 # which case it runs 'git diff-index' to find out the files that can be
274 # committed. It return paths relative to the directory specified in the first
275 # argument, and using the options specified in the second argument.
276 __git_ls_files_helper ()
279 test -n "${CDPATH+set}" && unset CDPATH
281 if [ "$2" == "--committable" ]; then
282 git diff-index --name-only --relative HEAD
284 # NOTE: $2 is not quoted in order to support multiple options
285 git ls-files --exclude-standard $2
291 # __git_index_files accepts 1 or 2 arguments:
292 # 1: Options to pass to ls-files (required).
293 # 2: A directory path (optional).
294 # If provided, only files within the specified directory are listed.
295 # Sub directories are never recursed. Path must have a trailing
299 local dir="$(__gitdir)" root="${2-.}" file
301 if [ -d "$dir" ]; then
302 __git_ls_files_helper "$root" "$1" |
303 while read -r file; do
305 ?*/*) echo "${file%%/*}" ;;
314 local dir="$(__gitdir)"
315 if [ -d "$dir" ]; then
316 git --git-dir="$dir" for-each-ref --format='%(refname:short)' \
324 local dir="$(__gitdir)"
325 if [ -d "$dir" ]; then
326 git --git-dir="$dir" for-each-ref --format='%(refname:short)' \
332 # __git_refs accepts 0, 1 (to pass to __gitdir), or 2 arguments
333 # presence of 2nd argument means use the guess heuristic employed
334 # by checkout for tracking branches
337 local i hash dir="$(__gitdir "${1-}")" track="${2-}"
339 if [ -d "$dir" ]; then
347 for i in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD; do
348 if [ -e "$dir/$i" ]; then echo $i; fi
350 format="refname:short"
351 refs="refs/tags refs/heads refs/remotes"
354 git --git-dir="$dir" for-each-ref --format="%($format)" \
356 if [ -n "$track" ]; then
357 # employ the heuristic used by git checkout
358 # Try to find a remote branch that matches the completion word
359 # but only output if the branch name is unique
361 git --git-dir="$dir" for-each-ref --shell --format="ref=%(refname:short)" \
363 while read -r entry; do
366 if [[ "$ref" == "$cur"* ]]; then
369 done | sort | uniq -u
375 git ls-remote "$dir" "$cur*" 2>/dev/null | \
376 while read -r hash i; do
385 git for-each-ref --format="%(refname:short)" -- "refs/remotes/$dir/" | sed -e "s#^$dir/##"
390 # __git_refs2 requires 1 argument (to pass to __git_refs)
394 for i in $(__git_refs "$1"); do
399 # __git_refs_remotes requires 1 argument (to pass to ls-remote)
400 __git_refs_remotes ()
403 git ls-remote "$1" 'refs/heads/*' 2>/dev/null | \
404 while read -r hash i; do
405 echo "$i:refs/remotes/$1/${i#refs/heads/}"
411 local i IFS=$'\n' d="$(__gitdir)"
412 test -d "$d/remotes" && ls -1 "$d/remotes"
413 for i in $(git --git-dir="$d" config --get-regexp 'remote\..*\.url' 2>/dev/null); do
419 __git_list_merge_strategies ()
421 git merge -s help 2>&1 |
422 sed -n -e '/[Aa]vailable strategies are: /,/^$/{
431 __git_merge_strategies=
432 # 'git merge -s help' (and thus detection of the merge strategy
433 # list) fails, unfortunately, if run outside of any git working
434 # tree. __git_merge_strategies is set to the empty string in
435 # that case, and the detection will be repeated the next time it
437 __git_compute_merge_strategies ()
439 test -n "$__git_merge_strategies" ||
440 __git_merge_strategies=$(__git_list_merge_strategies)
443 __git_complete_revlist_file ()
445 local pfx ls ref cur_="$cur"
465 case "$COMP_WORDBREAKS" in
467 *) pfx="$ref:$pfx" ;;
470 __gitcomp_nl "$(git --git-dir="$(__gitdir)" ls-tree "$ls" 2>/dev/null \
471 | sed '/^100... blob /{
487 pfx="${cur_%...*}..."
489 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
494 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
497 __gitcomp_nl "$(__git_refs)"
503 # __git_complete_index_file requires 1 argument:
504 # 1: the options to pass to ls-file
506 # The exception is --committable, which finds the files appropriate commit.
507 __git_complete_index_file ()
509 local pfx="" cur_="$cur"
519 __gitcomp_file "$(__git_index_files "$1" "$pfx")" "$pfx" "$cur_"
522 __git_complete_file ()
524 __git_complete_revlist_file
527 __git_complete_revlist ()
529 __git_complete_revlist_file
532 __git_complete_remote_or_refspec ()
534 local cur_="$cur" cmd="${words[1]}"
535 local i c=2 remote="" pfx="" lhs=1 no_complete_refspec=0
536 if [ "$cmd" = "remote" ]; then
539 while [ $c -lt $cword ]; do
542 --mirror) [ "$cmd" = "push" ] && no_complete_refspec=1 ;;
545 push) no_complete_refspec=1 ;;
553 *) remote="$i"; break ;;
557 if [ -z "$remote" ]; then
558 __gitcomp_nl "$(__git_remotes)"
561 if [ $no_complete_refspec = 1 ]; then
564 [ "$remote" = "." ] && remote=
567 case "$COMP_WORDBREAKS" in
569 *) pfx="${cur_%%:*}:" ;;
581 if [ $lhs = 1 ]; then
582 __gitcomp_nl "$(__git_refs2 "$remote")" "$pfx" "$cur_"
584 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
588 if [ $lhs = 1 ]; then
589 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
591 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
595 if [ $lhs = 1 ]; then
596 __gitcomp_nl "$(__git_refs)" "$pfx" "$cur_"
598 __gitcomp_nl "$(__git_refs "$remote")" "$pfx" "$cur_"
604 __git_complete_strategy ()
606 __git_compute_merge_strategies
609 __gitcomp "$__git_merge_strategies"
614 __gitcomp "$__git_merge_strategies" "" "${cur##--strategy=}"
622 if test -n "${GIT_TESTING_COMMAND_COMPLETION:-}"
624 printf "%s" "${GIT_TESTING_COMMAND_COMPLETION}"
626 git help -a|egrep '^ [a-zA-Z0-9]'
630 __git_list_all_commands ()
633 for i in $(__git_commands)
636 *--*) : helper pattern;;
643 __git_compute_all_commands ()
645 test -n "$__git_all_commands" ||
646 __git_all_commands=$(__git_list_all_commands)
649 __git_list_porcelain_commands ()
652 __git_compute_all_commands
653 for i in $__git_all_commands
656 *--*) : helper pattern;;
657 applymbox) : ask gittus;;
658 applypatch) : ask gittus;;
659 archimport) : import;;
660 cat-file) : plumbing;;
661 check-attr) : plumbing;;
662 check-ignore) : plumbing;;
663 check-mailmap) : plumbing;;
664 check-ref-format) : plumbing;;
665 checkout-index) : plumbing;;
666 commit-tree) : plumbing;;
667 count-objects) : infrequent;;
668 credential-cache) : credentials helper;;
669 credential-store) : credentials helper;;
670 cvsexportcommit) : export;;
671 cvsimport) : import;;
672 cvsserver) : daemon;;
674 diff-files) : plumbing;;
675 diff-index) : plumbing;;
676 diff-tree) : plumbing;;
677 fast-import) : import;;
678 fast-export) : export;;
679 fsck-objects) : plumbing;;
680 fetch-pack) : plumbing;;
681 fmt-merge-msg) : plumbing;;
682 for-each-ref) : plumbing;;
683 hash-object) : plumbing;;
684 http-*) : transport;;
685 index-pack) : plumbing;;
686 init-db) : deprecated;;
687 local-fetch) : plumbing;;
688 ls-files) : plumbing;;
689 ls-remote) : plumbing;;
690 ls-tree) : plumbing;;
691 mailinfo) : plumbing;;
692 mailsplit) : plumbing;;
693 merge-*) : plumbing;;
696 pack-objects) : plumbing;;
697 pack-redundant) : plumbing;;
698 pack-refs) : plumbing;;
699 parse-remote) : plumbing;;
700 patch-id) : plumbing;;
702 prune-packed) : plumbing;;
703 quiltimport) : import;;
704 read-tree) : plumbing;;
705 receive-pack) : plumbing;;
706 remote-*) : transport;;
708 rev-list) : plumbing;;
709 rev-parse) : plumbing;;
710 runstatus) : plumbing;;
711 sh-setup) : internal;;
713 show-ref) : plumbing;;
714 send-pack) : plumbing;;
715 show-index) : plumbing;;
717 stripspace) : plumbing;;
718 symbolic-ref) : plumbing;;
719 unpack-file) : plumbing;;
720 unpack-objects) : plumbing;;
721 update-index) : plumbing;;
722 update-ref) : plumbing;;
723 update-server-info) : daemon;;
724 upload-archive) : plumbing;;
725 upload-pack) : plumbing;;
726 write-tree) : plumbing;;
728 verify-pack) : infrequent;;
729 verify-tag) : plumbing;;
735 __git_porcelain_commands=
736 __git_compute_porcelain_commands ()
738 __git_compute_all_commands
739 test -n "$__git_porcelain_commands" ||
740 __git_porcelain_commands=$(__git_list_porcelain_commands)
743 __git_pretty_aliases ()
746 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "pretty\..*" 2>/dev/null); do
759 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "alias\..*" 2>/dev/null); do
769 # __git_aliased_command requires 1 argument
770 __git_aliased_command ()
772 local word cmdline=$(git --git-dir="$(__gitdir)" \
773 config --get "alias.$1")
774 for word in $cmdline; do
780 \!*) : shell command alias ;;
782 *=*) : setting env ;;
791 # __git_find_on_cmdline requires 1 argument
792 __git_find_on_cmdline ()
794 local word subcommand c=1
795 while [ $c -lt $cword ]; do
797 for subcommand in $1; do
798 if [ "$subcommand" = "$word" ]; then
807 __git_has_doubledash ()
810 while [ $c -lt $cword ]; do
811 if [ "--" = "${words[c]}" ]; then
819 # Try to count non option arguments passed on the command line for the
820 # specified git command.
821 # When options are used, it is necessary to use the special -- option to
822 # tell the implementation were non option arguments begin.
823 # XXX this can not be improved, since options can appear everywhere, as
827 # __git_count_arguments requires 1 argument: the git command executed.
828 __git_count_arguments ()
832 # Skip "git" (first argument)
833 for ((i=1; i < ${#words[@]}; i++)); do
838 # Good; we can assume that the following are only non
843 # Skip the specified git command and discard git
856 __git_whitespacelist="nowarn warn error error-all fix"
860 local dir="$(__gitdir)"
861 if [ -d "$dir"/rebase-apply ]; then
862 __gitcomp "--skip --continue --resolved --abort"
867 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
872 --3way --committer-date-is-author-date --ignore-date
873 --ignore-whitespace --ignore-space-change
874 --interactive --keep --no-utf8 --signoff --utf8
875 --whitespace= --scissors
885 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
890 --stat --numstat --summary --check --index
891 --cached --index-info --reverse --reject --unidiff-zero
892 --apply --no-add --exclude=
893 --ignore-whitespace --ignore-space-change
894 --whitespace= --inaccurate-eof --verbose
905 --interactive --refresh --patch --update --dry-run
906 --ignore-errors --intent-to-add
911 # XXX should we check for --update and --all options ?
912 __git_complete_index_file "--others --modified --directory --no-empty-directory"
919 __gitcomp "$(git archive --list)" "" "${cur##--format=}"
923 __gitcomp_nl "$(__git_remotes)" "" "${cur##--remote=}"
928 --format= --list --verbose
929 --prefix= --remote= --exec=
939 __git_has_doubledash && return
941 local subcommands="start bad good skip reset visualize replay log run"
942 local subcommand="$(__git_find_on_cmdline "$subcommands")"
943 if [ -z "$subcommand" ]; then
944 if [ -f "$(__gitdir)"/BISECT_START ]; then
945 __gitcomp "$subcommands"
947 __gitcomp "replay start"
952 case "$subcommand" in
953 bad|good|reset|skip|start)
954 __gitcomp_nl "$(__git_refs)"
963 local i c=1 only_local_ref="n" has_r="n"
965 while [ $c -lt $cword ]; do
968 -d|-m) only_local_ref="y" ;;
976 __gitcomp "$(__git_refs)" "" "${cur##--set-upstream-to=}"
980 --color --no-color --verbose --abbrev= --no-abbrev
981 --track --no-track --contains --merged --no-merged
982 --set-upstream-to= --edit-description --list
987 if [ $only_local_ref = "y" -a $has_r = "n" ]; then
988 __gitcomp_nl "$(__git_heads)"
990 __gitcomp_nl "$(__git_refs)"
998 local cmd="${words[2]}"
1001 __gitcomp "create list-heads verify unbundle"
1004 # looking for a file
1009 __git_complete_revlist
1018 __git_has_doubledash && return
1022 __gitcomp "diff3 merge" "" "${cur##--conflict=}"
1026 --quiet --ours --theirs --track --no-track --merge
1027 --conflict= --orphan --patch
1031 # check if --track, --no-track, or --no-guess was specified
1032 # if so, disable DWIM mode
1033 local flags="--track --no-track --no-guess" track=1
1034 if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
1037 __gitcomp_nl "$(__git_refs '' $track)"
1044 __gitcomp "$(__git_refs)"
1049 local dir="$(__gitdir)"
1050 if [ -f "$dir"/CHERRY_PICK_HEAD ]; then
1051 __gitcomp "--continue --quit --abort"
1056 __gitcomp "--edit --no-commit --signoff --strategy= --mainline"
1059 __gitcomp_nl "$(__git_refs)"
1068 __gitcomp "--dry-run --quiet"
1073 # XXX should we check for -x option ?
1074 __git_complete_index_file "--others --directory"
1106 __gitcomp_nl "$(__git_refs)" "" "${cur}"
1113 __gitcomp "default strip verbatim whitespace
1114 " "" "${cur##--cleanup=}"
1117 --reuse-message=*|--reedit-message=*|\
1118 --fixup=*|--squash=*)
1119 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1122 --untracked-files=*)
1123 __gitcomp "all no normal" "" "${cur##--untracked-files=}"
1128 --all --author= --signoff --verify --no-verify
1130 --amend --include --only --interactive
1131 --dry-run --reuse-message= --reedit-message=
1132 --reset-author --file= --message= --template=
1133 --cleanup= --untracked-files --untracked-files=
1134 --verbose --quiet --fixup= --squash=
1139 if git rev-parse --verify --quiet HEAD >/dev/null; then
1140 __git_complete_index_file "--committable"
1142 # This is the first commit
1143 __git_complete_index_file "--cached"
1152 --all --tags --contains --abbrev= --candidates=
1153 --exact-match --debug --long --match --always
1157 __gitcomp_nl "$(__git_refs)"
1160 __git_diff_algorithms="myers minimal patience histogram"
1162 __git_diff_common_options="--stat --numstat --shortstat --summary
1163 --patch-with-stat --name-only --name-status --color
1164 --no-color --color-words --no-renames --check
1165 --full-index --binary --abbrev --diff-filter=
1166 --find-copies-harder
1167 --text --ignore-space-at-eol --ignore-space-change
1168 --ignore-all-space --exit-code --quiet --ext-diff
1170 --no-prefix --src-prefix= --dst-prefix=
1171 --inter-hunk-context=
1172 --patience --histogram --minimal
1174 --dirstat --dirstat= --dirstat-by-file
1175 --dirstat-by-file= --cumulative
1181 __git_has_doubledash && return
1185 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
1189 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1190 --base --ours --theirs --no-index
1191 $__git_diff_common_options
1196 __git_complete_revlist_file
1199 __git_mergetools_common="diffuse diffmerge ecmerge emerge kdiff3 meld opendiff
1200 tkdiff vimdiff gvimdiff xxdiff araxis p4merge bc3 codecompare
1205 __git_has_doubledash && return
1209 __gitcomp "$__git_mergetools_common kompare" "" "${cur##--tool=}"
1213 __gitcomp "--cached --staged --pickaxe-all --pickaxe-regex
1214 --base --ours --theirs
1215 --no-renames --diff-filter= --find-copies-harder
1216 --relative --ignore-submodules
1221 __git_complete_revlist_file
1224 __git_fetch_recurse_submodules="yes on-demand no"
1226 __git_fetch_options="
1227 --quiet --verbose --append --upload-pack --force --keep --depth=
1228 --tags --no-tags --all --prune --dry-run --recurse-submodules=
1234 --recurse-submodules=*)
1235 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1239 __gitcomp "$__git_fetch_options"
1243 __git_complete_remote_or_refspec
1246 __git_format_patch_options="
1247 --stdout --attach --no-attach --thread --thread= --no-thread
1248 --numbered --start-number --numbered-files --keep-subject --signoff
1249 --signature --no-signature --in-reply-to= --cc= --full-index --binary
1250 --not --all --cover-letter --no-prefix --src-prefix= --dst-prefix=
1251 --inline --suffix= --ignore-if-in-upstream --subject-prefix=
1252 --output-directory --reroll-count --to= --quiet --notes
1255 _git_format_patch ()
1261 " "" "${cur##--thread=}"
1265 __gitcomp "$__git_format_patch_options"
1269 __git_complete_revlist
1277 --tags --root --unreachable --cache --no-reflogs --full
1278 --strict --verbose --lost-found
1289 __gitcomp "--prune --aggressive"
1300 __git_match_ctag() {
1301 awk "/^${1////\\/}/ { print \$1 }" "$2"
1306 __git_has_doubledash && return
1312 --text --ignore-case --word-regexp --invert-match
1313 --full-name --line-number
1314 --extended-regexp --basic-regexp --fixed-strings
1316 --files-with-matches --name-only
1317 --files-without-match
1320 --and --or --not --all-match
1326 case "$cword,$prev" in
1328 if test -r tags; then
1329 __gitcomp_nl "$(__git_match_ctag "$cur" tags)"
1335 __gitcomp_nl "$(__git_refs)"
1342 __gitcomp "--all --info --man --web"
1346 __git_compute_all_commands
1347 __gitcomp "$__git_all_commands $(__git_aliases)
1348 attributes cli core-tutorial cvs-migration
1349 diffcore gitk glossary hooks ignore modules
1350 namespaces repository-layout tutorial tutorial-2
1360 false true umask group all world everybody
1361 " "" "${cur##--shared=}"
1365 __gitcomp "--quiet --bare --template= --shared --shared="
1375 __gitcomp "--cached --deleted --modified --others --ignored
1376 --stage --directory --no-empty-directory --unmerged
1377 --killed --exclude= --exclude-from=
1378 --exclude-per-directory= --exclude-standard
1379 --error-unmatch --with-tree= --full-name
1380 --abbrev --ignored --exclude-per-directory
1386 # XXX ignore options like --modified and always suggest all cached
1388 __git_complete_index_file "--cached"
1393 __gitcomp_nl "$(__git_remotes)"
1401 # Options that go well for log, shortlog and gitk
1402 __git_log_common_options="
1404 --branches --tags --remotes
1405 --first-parent --merges --no-merges
1407 --max-age= --since= --after=
1408 --min-age= --until= --before=
1409 --min-parents= --max-parents=
1410 --no-min-parents --no-max-parents
1412 # Options that go well for log and gitk (not shortlog)
1413 __git_log_gitk_options="
1414 --dense --sparse --full-history
1415 --simplify-merges --simplify-by-decoration
1416 --left-right --notes --no-notes
1418 # Options that go well for log and shortlog (not gitk)
1419 __git_log_shortlog_options="
1420 --author= --committer= --grep=
1424 __git_log_pretty_formats="oneline short medium full fuller email raw format:"
1425 __git_log_date_formats="relative iso8601 rfc2822 short local default raw"
1429 __git_has_doubledash && return
1431 local g="$(git rev-parse --git-dir 2>/dev/null)"
1433 if [ -f "$g/MERGE_HEAD" ]; then
1437 --pretty=*|--format=*)
1438 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
1443 __gitcomp "$__git_log_date_formats" "" "${cur##--date=}"
1447 __gitcomp "long short" "" "${cur##--decorate=}"
1452 $__git_log_common_options
1453 $__git_log_shortlog_options
1454 $__git_log_gitk_options
1455 --root --topo-order --date-order --reverse
1456 --follow --full-diff
1457 --abbrev-commit --abbrev=
1458 --relative-date --date=
1459 --pretty= --format= --oneline
1462 --decorate --decorate=
1464 --parents --children
1466 $__git_diff_common_options
1467 --pickaxe-all --pickaxe-regex
1472 __git_complete_revlist
1475 # Common merge options shared by git-merge(1) and git-pull(1).
1476 __git_merge_options="
1477 --no-commit --no-stat --log --no-log --squash --strategy
1478 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1483 __git_complete_strategy && return
1487 __gitcomp "$__git_merge_options"
1490 __gitcomp_nl "$(__git_refs)"
1497 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1511 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1515 __gitcomp_nl "$(__git_refs)"
1522 __gitcomp "--dry-run"
1527 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1528 # We need to show both cached and untracked files (including
1529 # empty directories) since this may not be the last argument.
1530 __git_complete_index_file "--cached --others --directory"
1532 __git_complete_index_file "--cached"
1538 __gitcomp "--tags --all --stdin"
1543 local subcommands='add append copy edit list prune remove show'
1544 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1546 case "$subcommand,$cur" in
1553 __gitcomp_nl "$(__git_refs)"
1556 __gitcomp "$subcommands --ref"
1560 add,--reuse-message=*|append,--reuse-message=*|\
1561 add,--reedit-message=*|append,--reedit-message=*)
1562 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1565 __gitcomp '--file= --message= --reedit-message=
1572 __gitcomp '--dry-run --verbose'
1581 __gitcomp_nl "$(__git_refs)"
1590 __git_complete_strategy && return
1593 --recurse-submodules=*)
1594 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1599 --rebase --no-rebase
1600 $__git_merge_options
1601 $__git_fetch_options
1606 __git_complete_remote_or_refspec
1609 __git_push_recurse_submodules="check on-demand"
1615 __gitcomp_nl "$(__git_remotes)"
1620 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1623 --recurse-submodules=*)
1624 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1629 --all --mirror --tags --dry-run --force --verbose
1630 --receive-pack= --repo= --set-upstream
1631 --recurse-submodules=
1636 __git_complete_remote_or_refspec
1641 local dir="$(__gitdir)"
1642 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1643 __gitcomp "--continue --skip --abort"
1646 __git_complete_strategy && return
1649 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1654 --onto --merge --strategy --interactive
1655 --preserve-merges --stat --no-stat
1656 --committer-date-is-author-date --ignore-date
1657 --ignore-whitespace --whitespace=
1658 --autosquash --fork-point --no-fork-point
1663 __gitcomp_nl "$(__git_refs)"
1668 local subcommands="show delete expire"
1669 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1671 if [ -z "$subcommand" ]; then
1672 __gitcomp "$subcommands"
1674 __gitcomp_nl "$(__git_refs)"
1678 __git_send_email_confirm_options="always never auto cc compose"
1679 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1686 $__git_send_email_confirm_options
1687 " "" "${cur##--confirm=}"
1692 $__git_send_email_suppresscc_options
1693 " "" "${cur##--suppress-cc=}"
1697 --smtp-encryption=*)
1698 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1704 " "" "${cur##--thread=}"
1708 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1709 --compose --confirm= --dry-run --envelope-sender
1711 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1712 --no-suppress-from --no-thread --quiet
1713 --signed-off-by-cc --smtp-pass --smtp-server
1714 --smtp-server-port --smtp-encryption= --smtp-user
1715 --subject --suppress-cc= --suppress-from --thread --to
1716 --validate --no-validate
1717 $__git_format_patch_options"
1721 __git_complete_revlist
1729 __git_config_get_set_variables ()
1731 local prevword word config_file= c=$cword
1732 while [ $c -gt 1 ]; do
1735 --system|--global|--local|--file=*)
1740 config_file="$word $prevword"
1748 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1762 branch.*.remote|branch.*.pushremote)
1763 __gitcomp_nl "$(__git_remotes)"
1767 __gitcomp_nl "$(__git_refs)"
1771 __gitcomp "false true"
1775 __gitcomp_nl "$(__git_remotes)"
1779 local remote="${prev#remote.}"
1780 remote="${remote%.fetch}"
1781 if [ -z "$cur" ]; then
1782 __gitcomp_nl "refs/heads/" "" "" ""
1785 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1789 local remote="${prev#remote.}"
1790 remote="${remote%.push}"
1791 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1792 for-each-ref --format='%(refname):%(refname)' \
1796 pull.twohead|pull.octopus)
1797 __git_compute_merge_strategies
1798 __gitcomp "$__git_merge_strategies"
1801 color.branch|color.diff|color.interactive|\
1802 color.showbranch|color.status|color.ui)
1803 __gitcomp "always never auto"
1807 __gitcomp "false true"
1812 normal black red green yellow blue magenta cyan white
1813 bold dim ul blink reverse
1818 __gitcomp "log short"
1822 __gitcomp "man info web html"
1826 __gitcomp "$__git_log_date_formats"
1829 sendemail.aliasesfiletype)
1830 __gitcomp "mutt mailrc pine elm gnus"
1834 __gitcomp "$__git_send_email_confirm_options"
1837 sendemail.suppresscc)
1838 __gitcomp "$__git_send_email_suppresscc_options"
1841 --get|--get-all|--unset|--unset-all)
1842 __gitcomp_nl "$(__git_config_get_set_variables)"
1852 --system --global --local --file=
1853 --list --replace-all
1854 --get --get-all --get-regexp
1855 --add --unset --unset-all
1856 --remove-section --rename-section
1861 local pfx="${cur%.*}." cur_="${cur##*.}"
1862 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1866 local pfx="${cur%.*}." cur_="${cur#*.}"
1867 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1868 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1872 local pfx="${cur%.*}." cur_="${cur##*.}"
1874 argprompt cmd confirm needsfile noconsole norescan
1875 prompt revprompt revunmerged title
1880 local pfx="${cur%.*}." cur_="${cur##*.}"
1881 __gitcomp "cmd path" "$pfx" "$cur_"
1885 local pfx="${cur%.*}." cur_="${cur##*.}"
1886 __gitcomp "cmd path" "$pfx" "$cur_"
1890 local pfx="${cur%.*}." cur_="${cur##*.}"
1891 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1895 local pfx="${cur%.*}." cur_="${cur#*.}"
1896 __git_compute_all_commands
1897 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1901 local pfx="${cur%.*}." cur_="${cur##*.}"
1903 url proxy fetch push mirror skipDefaultUpdate
1904 receivepack uploadpack tagopt pushurl
1909 local pfx="${cur%.*}." cur_="${cur#*.}"
1910 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1911 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1915 local pfx="${cur%.*}." cur_="${cur##*.}"
1916 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1922 advice.commitBeforeMerge
1924 advice.implicitIdentity
1925 advice.pushNonFastForward
1926 advice.resolveConflict
1930 apply.ignorewhitespace
1932 branch.autosetupmerge
1933 branch.autosetuprebase
1937 color.branch.current
1942 color.decorate.branch
1943 color.decorate.remoteBranch
1944 color.decorate.stash
1954 color.diff.whitespace
1959 color.grep.linenumber
1962 color.grep.separator
1964 color.interactive.error
1965 color.interactive.header
1966 color.interactive.help
1967 color.interactive.prompt
1972 color.status.changed
1974 color.status.nobranch
1975 color.status.untracked
1976 color.status.updated
1985 core.bigFileThreshold
1988 core.deltaBaseCacheLimit
1993 core.fsyncobjectfiles
1997 core.logAllRefUpdates
1998 core.loosecompression
2001 core.packedGitWindowSize
2003 core.preferSymlinkRefs
2006 core.repositoryFormatVersion
2008 core.sharedRepository
2012 core.warnAmbiguousRefs
2015 diff.autorefreshindex
2017 diff.ignoreSubmodules
2024 diff.suppressBlankEmpty
2030 fetch.recurseSubmodules
2040 format.subjectprefix
2051 gc.reflogexpireunreachable
2055 gitcvs.commitmsgannotation
2056 gitcvs.dbTableNamePrefix
2067 gui.copyblamethreshold
2071 gui.matchtrackingbranch
2072 gui.newbranchtemplate
2073 gui.pruneduringfetch
2074 gui.spellingdictionary
2089 http.sslCertPasswordProtected
2094 i18n.logOutputEncoding
2100 imap.preformattedHTML
2110 interactive.singlekey
2126 mergetool.keepBackup
2127 mergetool.keepTemporaries
2132 notes.rewrite.rebase
2136 pack.deltaCacheLimit
2152 receive.denyCurrentBranch
2153 receive.denyDeleteCurrent
2155 receive.denyNonFastForwards
2158 receive.updateserverinfo
2161 repack.usedeltabaseoffset
2165 sendemail.aliasesfile
2166 sendemail.aliasfiletype
2170 sendemail.chainreplyto
2172 sendemail.envelopesender
2176 sendemail.signedoffbycc
2177 sendemail.smtpdomain
2178 sendemail.smtpencryption
2180 sendemail.smtpserver
2181 sendemail.smtpserveroption
2182 sendemail.smtpserverport
2184 sendemail.suppresscc
2185 sendemail.suppressfrom
2190 status.relativePaths
2191 status.showUntrackedFiles
2192 status.submodulesummary
2195 transfer.unpackLimit
2207 local subcommands="add rename remove set-head set-branches set-url show prune update"
2208 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2209 if [ -z "$subcommand" ]; then
2210 __gitcomp "$subcommands"
2214 case "$subcommand" in
2215 rename|remove|set-url|show|prune)
2216 __gitcomp_nl "$(__git_remotes)"
2218 set-head|set-branches)
2219 __git_complete_remote_or_refspec
2222 local i c='' IFS=$'\n'
2223 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "remotes\..*" 2>/dev/null); do
2236 __gitcomp_nl "$(__git_refs)"
2241 __git_has_doubledash && return
2245 __gitcomp "--merge --mixed --hard --soft --patch"
2249 __gitcomp_nl "$(__git_refs)"
2256 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2260 __gitcomp_nl "$(__git_refs)"
2267 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2272 __git_complete_index_file "--cached"
2277 __git_has_doubledash && return
2282 $__git_log_common_options
2283 $__git_log_shortlog_options
2284 --numbered --summary
2289 __git_complete_revlist
2294 __git_has_doubledash && return
2297 --pretty=*|--format=*)
2298 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2303 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2307 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2308 $__git_diff_common_options
2313 __git_complete_revlist_file
2321 --all --remotes --topo-order --current --more=
2322 --list --independent --merge-base --no-name
2324 --sha1-name --sparse --topics --reflog
2329 __git_complete_revlist
2334 local save_opts='--keep-index --no-keep-index --quiet --patch'
2335 local subcommands='save list show apply clear drop pop create branch'
2336 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2337 if [ -z "$subcommand" ]; then
2340 __gitcomp "$save_opts"
2343 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2344 __gitcomp "$subcommands"
2349 case "$subcommand,$cur" in
2351 __gitcomp "$save_opts"
2354 __gitcomp "--index --quiet"
2356 show,--*|drop,--*|branch,--*)
2358 show,*|apply,*|drop,*|pop,*|branch,*)
2359 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2360 | sed -n -e 's/:.*//p')"
2370 __git_has_doubledash && return
2372 local subcommands="add status init deinit update summary foreach sync"
2373 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2376 __gitcomp "--quiet --cached"
2379 __gitcomp "$subcommands"
2389 init fetch clone rebase dcommit log find-rev
2390 set-tree commit-diff info create-ignore propget
2391 proplist show-ignore show-externals branch tag blame
2392 migrate mkdirs reset gc
2394 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2395 if [ -z "$subcommand" ]; then
2396 __gitcomp "$subcommands"
2398 local remote_opts="--username= --config-dir= --no-auth-cache"
2400 --follow-parent --authors-file= --repack=
2401 --no-metadata --use-svm-props --use-svnsync-props
2402 --log-window-size= --no-checkout --quiet
2403 --repack-flags --use-log-author --localtime
2404 --ignore-paths= --include-paths= $remote_opts
2407 --template= --shared= --trunk= --tags=
2408 --branches= --stdlayout --minimize-url
2409 --no-metadata --use-svm-props --use-svnsync-props
2410 --rewrite-root= --prefix= --use-log-author
2411 --add-author-from $remote_opts
2414 --edit --rmdir --find-copies-harder --copy-similarity=
2417 case "$subcommand,$cur" in
2419 __gitcomp "--revision= --fetch-all $fc_opts"
2422 __gitcomp "--revision= $fc_opts $init_opts"
2425 __gitcomp "$init_opts"
2429 --merge --strategy= --verbose --dry-run
2430 --fetch-all --no-rebase --commit-url
2431 --revision --interactive $cmt_opts $fc_opts
2435 __gitcomp "--stdin $cmt_opts $fc_opts"
2437 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2438 show-externals,--*|mkdirs,--*)
2439 __gitcomp "--revision="
2443 --limit= --revision= --verbose --incremental
2444 --oneline --show-commit --non-recursive
2445 --authors-file= --color
2450 --merge --verbose --strategy= --local
2451 --fetch-all --dry-run $fc_opts
2455 __gitcomp "--message= --file= --revision= $cmt_opts"
2461 __gitcomp "--dry-run --message --tag"
2464 __gitcomp "--dry-run --message"
2467 __gitcomp "--git-format"
2471 --config-dir= --ignore-paths= --minimize
2472 --no-auth-cache --username=
2476 __gitcomp "--revision= --parent"
2487 while [ $c -lt $cword ]; do
2491 __gitcomp_nl "$(__git_tags)"
2506 __gitcomp_nl "$(__git_tags)"
2510 __gitcomp_nl "$(__git_refs)"
2522 local i c=1 command __git_dir
2524 while [ $c -lt $cword ]; do
2527 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2528 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2529 --bare) __git_dir="." ;;
2530 --help) command="help"; break ;;
2531 -c|--work-tree|--namespace) ((c++)) ;;
2533 *) command="$i"; break ;;
2538 if [ -z "$command" ]; then
2553 --no-replace-objects
2557 *) __git_compute_porcelain_commands
2558 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2563 local completion_func="_git_${command//-/_}"
2564 declare -f $completion_func >/dev/null && $completion_func && return
2566 local expansion=$(__git_aliased_command "$command")
2567 if [ -n "$expansion" ]; then
2569 completion_func="_git_${expansion//-/_}"
2570 declare -f $completion_func >/dev/null && $completion_func
2576 __git_has_doubledash && return
2578 local g="$(__gitdir)"
2580 if [ -f "$g/MERGE_HEAD" ]; then
2586 $__git_log_common_options
2587 $__git_log_gitk_options
2593 __git_complete_revlist
2596 if [[ -n ${ZSH_VERSION-} ]]; then
2597 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2599 autoload -U +X compinit && compinit
2605 local cur_="${3-$cur}"
2611 local c IFS=$' \t\n'
2619 array[${#array[@]}+1]="$c"
2622 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
2633 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2642 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2647 local _ret=1 cur cword prev
2648 cur=${words[CURRENT]}
2649 prev=${words[CURRENT-1]}
2651 emulate ksh -c __${service}_main
2652 let _ret && _default && _ret=0
2656 compdef _git git gitk
2662 local cur words cword prev
2663 _get_comp_words_by_ref -n =: cur words cword prev
2667 # Setup completion for certain functions defined above by setting common
2668 # variables and workarounds.
2669 # This is NOT a public function; use at your own risk.
2672 local wrapper="__git_wrap${2}"
2673 eval "$wrapper () { __git_func_wrap $2 ; }"
2674 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2675 || complete -o default -o nospace -F $wrapper $1
2678 # wrapper for backwards compatibility
2681 __git_wrap__git_main
2684 # wrapper for backwards compatibility
2687 __git_wrap__gitk_main
2690 __git_complete git __git_main
2691 __git_complete gitk __gitk_main
2693 # The following are necessary only for Cygwin, and only are needed
2694 # when the user has tab-completed the executable name and consequently
2695 # included the '.exe' suffix.
2697 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2698 __git_complete git.exe __git_main