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 __git_merge_options="
1476 --no-commit --no-stat --log --no-log --squash --strategy
1477 --commit --stat --no-squash --ff --no-ff --ff-only --edit --no-edit
1482 __git_complete_strategy && return
1486 __gitcomp "$__git_merge_options"
1489 __gitcomp_nl "$(__git_refs)"
1496 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1510 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1514 __gitcomp_nl "$(__git_refs)"
1521 __gitcomp "--dry-run"
1526 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1527 # We need to show both cached and untracked files (including
1528 # empty directories) since this may not be the last argument.
1529 __git_complete_index_file "--cached --others --directory"
1531 __git_complete_index_file "--cached"
1537 __gitcomp "--tags --all --stdin"
1542 local subcommands='add append copy edit list prune remove show'
1543 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1545 case "$subcommand,$cur" in
1552 __gitcomp_nl "$(__git_refs)"
1555 __gitcomp "$subcommands --ref"
1559 add,--reuse-message=*|append,--reuse-message=*|\
1560 add,--reedit-message=*|append,--reedit-message=*)
1561 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1564 __gitcomp '--file= --message= --reedit-message=
1571 __gitcomp '--dry-run --verbose'
1580 __gitcomp_nl "$(__git_refs)"
1589 __git_complete_strategy && return
1592 --recurse-submodules=*)
1593 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1598 --rebase --no-rebase
1599 $__git_merge_options
1600 $__git_fetch_options
1605 __git_complete_remote_or_refspec
1608 __git_push_recurse_submodules="check on-demand"
1614 __gitcomp_nl "$(__git_remotes)"
1619 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1622 --recurse-submodules=*)
1623 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1628 --all --mirror --tags --dry-run --force --verbose
1629 --receive-pack= --repo= --set-upstream
1630 --recurse-submodules=
1635 __git_complete_remote_or_refspec
1640 local dir="$(__gitdir)"
1641 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1642 __gitcomp "--continue --skip --abort"
1645 __git_complete_strategy && return
1648 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1653 --onto --merge --strategy --interactive
1654 --preserve-merges --stat --no-stat
1655 --committer-date-is-author-date --ignore-date
1656 --ignore-whitespace --whitespace=
1657 --autosquash --fork-point --no-fork-point
1662 __gitcomp_nl "$(__git_refs)"
1667 local subcommands="show delete expire"
1668 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1670 if [ -z "$subcommand" ]; then
1671 __gitcomp "$subcommands"
1673 __gitcomp_nl "$(__git_refs)"
1677 __git_send_email_confirm_options="always never auto cc compose"
1678 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1685 $__git_send_email_confirm_options
1686 " "" "${cur##--confirm=}"
1691 $__git_send_email_suppresscc_options
1692 " "" "${cur##--suppress-cc=}"
1696 --smtp-encryption=*)
1697 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1703 " "" "${cur##--thread=}"
1707 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1708 --compose --confirm= --dry-run --envelope-sender
1710 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1711 --no-suppress-from --no-thread --quiet
1712 --signed-off-by-cc --smtp-pass --smtp-server
1713 --smtp-server-port --smtp-encryption= --smtp-user
1714 --subject --suppress-cc= --suppress-from --thread --to
1715 --validate --no-validate
1716 $__git_format_patch_options"
1720 __git_complete_revlist
1728 __git_config_get_set_variables ()
1730 local prevword word config_file= c=$cword
1731 while [ $c -gt 1 ]; do
1734 --system|--global|--local|--file=*)
1739 config_file="$word $prevword"
1747 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1761 branch.*.remote|branch.*.pushremote)
1762 __gitcomp_nl "$(__git_remotes)"
1766 __gitcomp_nl "$(__git_refs)"
1770 __gitcomp "false true"
1774 __gitcomp_nl "$(__git_remotes)"
1778 local remote="${prev#remote.}"
1779 remote="${remote%.fetch}"
1780 if [ -z "$cur" ]; then
1781 __gitcomp_nl "refs/heads/" "" "" ""
1784 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1788 local remote="${prev#remote.}"
1789 remote="${remote%.push}"
1790 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1791 for-each-ref --format='%(refname):%(refname)' \
1795 pull.twohead|pull.octopus)
1796 __git_compute_merge_strategies
1797 __gitcomp "$__git_merge_strategies"
1800 color.branch|color.diff|color.interactive|\
1801 color.showbranch|color.status|color.ui)
1802 __gitcomp "always never auto"
1806 __gitcomp "false true"
1811 normal black red green yellow blue magenta cyan white
1812 bold dim ul blink reverse
1817 __gitcomp "log short"
1821 __gitcomp "man info web html"
1825 __gitcomp "$__git_log_date_formats"
1828 sendemail.aliasesfiletype)
1829 __gitcomp "mutt mailrc pine elm gnus"
1833 __gitcomp "$__git_send_email_confirm_options"
1836 sendemail.suppresscc)
1837 __gitcomp "$__git_send_email_suppresscc_options"
1840 --get|--get-all|--unset|--unset-all)
1841 __gitcomp_nl "$(__git_config_get_set_variables)"
1851 --system --global --local --file=
1852 --list --replace-all
1853 --get --get-all --get-regexp
1854 --add --unset --unset-all
1855 --remove-section --rename-section
1860 local pfx="${cur%.*}." cur_="${cur##*.}"
1861 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1865 local pfx="${cur%.*}." cur_="${cur#*.}"
1866 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1867 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1871 local pfx="${cur%.*}." cur_="${cur##*.}"
1873 argprompt cmd confirm needsfile noconsole norescan
1874 prompt revprompt revunmerged title
1879 local pfx="${cur%.*}." cur_="${cur##*.}"
1880 __gitcomp "cmd path" "$pfx" "$cur_"
1884 local pfx="${cur%.*}." cur_="${cur##*.}"
1885 __gitcomp "cmd path" "$pfx" "$cur_"
1889 local pfx="${cur%.*}." cur_="${cur##*.}"
1890 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1894 local pfx="${cur%.*}." cur_="${cur#*.}"
1895 __git_compute_all_commands
1896 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1900 local pfx="${cur%.*}." cur_="${cur##*.}"
1902 url proxy fetch push mirror skipDefaultUpdate
1903 receivepack uploadpack tagopt pushurl
1908 local pfx="${cur%.*}." cur_="${cur#*.}"
1909 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1910 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1914 local pfx="${cur%.*}." cur_="${cur##*.}"
1915 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1921 advice.commitBeforeMerge
1923 advice.implicitIdentity
1924 advice.pushNonFastForward
1925 advice.resolveConflict
1929 apply.ignorewhitespace
1931 branch.autosetupmerge
1932 branch.autosetuprebase
1936 color.branch.current
1941 color.decorate.branch
1942 color.decorate.remoteBranch
1943 color.decorate.stash
1953 color.diff.whitespace
1958 color.grep.linenumber
1961 color.grep.separator
1963 color.interactive.error
1964 color.interactive.header
1965 color.interactive.help
1966 color.interactive.prompt
1971 color.status.changed
1973 color.status.nobranch
1974 color.status.untracked
1975 color.status.updated
1984 core.bigFileThreshold
1987 core.deltaBaseCacheLimit
1992 core.fsyncobjectfiles
1996 core.logAllRefUpdates
1997 core.loosecompression
2000 core.packedGitWindowSize
2002 core.preferSymlinkRefs
2005 core.repositoryFormatVersion
2007 core.sharedRepository
2011 core.warnAmbiguousRefs
2014 diff.autorefreshindex
2016 diff.ignoreSubmodules
2023 diff.suppressBlankEmpty
2029 fetch.recurseSubmodules
2039 format.subjectprefix
2050 gc.reflogexpireunreachable
2054 gitcvs.commitmsgannotation
2055 gitcvs.dbTableNamePrefix
2066 gui.copyblamethreshold
2070 gui.matchtrackingbranch
2071 gui.newbranchtemplate
2072 gui.pruneduringfetch
2073 gui.spellingdictionary
2088 http.sslCertPasswordProtected
2093 i18n.logOutputEncoding
2099 imap.preformattedHTML
2109 interactive.singlekey
2125 mergetool.keepBackup
2126 mergetool.keepTemporaries
2131 notes.rewrite.rebase
2135 pack.deltaCacheLimit
2151 receive.denyCurrentBranch
2152 receive.denyDeleteCurrent
2154 receive.denyNonFastForwards
2157 receive.updateserverinfo
2160 repack.usedeltabaseoffset
2164 sendemail.aliasesfile
2165 sendemail.aliasfiletype
2169 sendemail.chainreplyto
2171 sendemail.envelopesender
2175 sendemail.signedoffbycc
2176 sendemail.smtpdomain
2177 sendemail.smtpencryption
2179 sendemail.smtpserver
2180 sendemail.smtpserveroption
2181 sendemail.smtpserverport
2183 sendemail.suppresscc
2184 sendemail.suppressfrom
2189 status.relativePaths
2190 status.showUntrackedFiles
2191 status.submodulesummary
2194 transfer.unpackLimit
2206 local subcommands="add rename remove set-head set-branches set-url show prune update"
2207 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2208 if [ -z "$subcommand" ]; then
2209 __gitcomp "$subcommands"
2213 case "$subcommand" in
2214 rename|remove|set-url|show|prune)
2215 __gitcomp_nl "$(__git_remotes)"
2217 set-head|set-branches)
2218 __git_complete_remote_or_refspec
2221 local i c='' IFS=$'\n'
2222 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "remotes\..*" 2>/dev/null); do
2235 __gitcomp_nl "$(__git_refs)"
2240 __git_has_doubledash && return
2244 __gitcomp "--merge --mixed --hard --soft --patch"
2248 __gitcomp_nl "$(__git_refs)"
2255 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2259 __gitcomp_nl "$(__git_refs)"
2266 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2271 __git_complete_index_file "--cached"
2276 __git_has_doubledash && return
2281 $__git_log_common_options
2282 $__git_log_shortlog_options
2283 --numbered --summary
2288 __git_complete_revlist
2293 __git_has_doubledash && return
2296 --pretty=*|--format=*)
2297 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2302 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2306 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2307 $__git_diff_common_options
2312 __git_complete_revlist_file
2320 --all --remotes --topo-order --current --more=
2321 --list --independent --merge-base --no-name
2323 --sha1-name --sparse --topics --reflog
2328 __git_complete_revlist
2333 local save_opts='--keep-index --no-keep-index --quiet --patch'
2334 local subcommands='save list show apply clear drop pop create branch'
2335 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2336 if [ -z "$subcommand" ]; then
2339 __gitcomp "$save_opts"
2342 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2343 __gitcomp "$subcommands"
2348 case "$subcommand,$cur" in
2350 __gitcomp "$save_opts"
2353 __gitcomp "--index --quiet"
2355 show,--*|drop,--*|branch,--*)
2357 show,*|apply,*|drop,*|pop,*|branch,*)
2358 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2359 | sed -n -e 's/:.*//p')"
2369 __git_has_doubledash && return
2371 local subcommands="add status init deinit update summary foreach sync"
2372 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2375 __gitcomp "--quiet --cached"
2378 __gitcomp "$subcommands"
2388 init fetch clone rebase dcommit log find-rev
2389 set-tree commit-diff info create-ignore propget
2390 proplist show-ignore show-externals branch tag blame
2391 migrate mkdirs reset gc
2393 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2394 if [ -z "$subcommand" ]; then
2395 __gitcomp "$subcommands"
2397 local remote_opts="--username= --config-dir= --no-auth-cache"
2399 --follow-parent --authors-file= --repack=
2400 --no-metadata --use-svm-props --use-svnsync-props
2401 --log-window-size= --no-checkout --quiet
2402 --repack-flags --use-log-author --localtime
2403 --ignore-paths= --include-paths= $remote_opts
2406 --template= --shared= --trunk= --tags=
2407 --branches= --stdlayout --minimize-url
2408 --no-metadata --use-svm-props --use-svnsync-props
2409 --rewrite-root= --prefix= --use-log-author
2410 --add-author-from $remote_opts
2413 --edit --rmdir --find-copies-harder --copy-similarity=
2416 case "$subcommand,$cur" in
2418 __gitcomp "--revision= --fetch-all $fc_opts"
2421 __gitcomp "--revision= $fc_opts $init_opts"
2424 __gitcomp "$init_opts"
2428 --merge --strategy= --verbose --dry-run
2429 --fetch-all --no-rebase --commit-url
2430 --revision --interactive $cmt_opts $fc_opts
2434 __gitcomp "--stdin $cmt_opts $fc_opts"
2436 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2437 show-externals,--*|mkdirs,--*)
2438 __gitcomp "--revision="
2442 --limit= --revision= --verbose --incremental
2443 --oneline --show-commit --non-recursive
2444 --authors-file= --color
2449 --merge --verbose --strategy= --local
2450 --fetch-all --dry-run $fc_opts
2454 __gitcomp "--message= --file= --revision= $cmt_opts"
2460 __gitcomp "--dry-run --message --tag"
2463 __gitcomp "--dry-run --message"
2466 __gitcomp "--git-format"
2470 --config-dir= --ignore-paths= --minimize
2471 --no-auth-cache --username=
2475 __gitcomp "--revision= --parent"
2486 while [ $c -lt $cword ]; do
2490 __gitcomp_nl "$(__git_tags)"
2505 __gitcomp_nl "$(__git_tags)"
2509 __gitcomp_nl "$(__git_refs)"
2521 local i c=1 command __git_dir
2523 while [ $c -lt $cword ]; do
2526 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2527 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2528 --bare) __git_dir="." ;;
2529 --help) command="help"; break ;;
2530 -c|--work-tree|--namespace) ((c++)) ;;
2532 *) command="$i"; break ;;
2537 if [ -z "$command" ]; then
2552 --no-replace-objects
2556 *) __git_compute_porcelain_commands
2557 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2562 local completion_func="_git_${command//-/_}"
2563 declare -f $completion_func >/dev/null && $completion_func && return
2565 local expansion=$(__git_aliased_command "$command")
2566 if [ -n "$expansion" ]; then
2568 completion_func="_git_${expansion//-/_}"
2569 declare -f $completion_func >/dev/null && $completion_func
2575 __git_has_doubledash && return
2577 local g="$(__gitdir)"
2579 if [ -f "$g/MERGE_HEAD" ]; then
2585 $__git_log_common_options
2586 $__git_log_gitk_options
2592 __git_complete_revlist
2595 if [[ -n ${ZSH_VERSION-} ]]; then
2596 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2598 autoload -U +X compinit && compinit
2604 local cur_="${3-$cur}"
2610 local c IFS=$' \t\n'
2618 array[${#array[@]}+1]="$c"
2621 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
2632 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2641 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2646 local _ret=1 cur cword prev
2647 cur=${words[CURRENT]}
2648 prev=${words[CURRENT-1]}
2650 emulate ksh -c __${service}_main
2651 let _ret && _default && _ret=0
2655 compdef _git git gitk
2661 local cur words cword prev
2662 _get_comp_words_by_ref -n =: cur words cword prev
2666 # Setup completion for certain functions defined above by setting common
2667 # variables and workarounds.
2668 # This is NOT a public function; use at your own risk.
2671 local wrapper="__git_wrap${2}"
2672 eval "$wrapper () { __git_func_wrap $2 ; }"
2673 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2674 || complete -o default -o nospace -F $wrapper $1
2677 # wrapper for backwards compatibility
2680 __git_wrap__git_main
2683 # wrapper for backwards compatibility
2686 __git_wrap__gitk_main
2689 __git_complete git __git_main
2690 __git_complete gitk __gitk_main
2692 # The following are necessary only for Cygwin, and only are needed
2693 # when the user has tab-completed the executable name and consequently
2694 # included the '.exe' suffix.
2696 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2697 __git_complete git.exe __git_main