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
1479 --verify-signatures --no-verify-signatures --gpg-sign
1480 --quiet --verbose --progress --no-progress
1485 __git_complete_strategy && return
1489 __gitcomp "$__git_merge_options
1490 --rerere-autoupdate --no-rerere-autoupdate --abort"
1493 __gitcomp_nl "$(__git_refs)"
1500 __gitcomp "$__git_mergetools_common tortoisemerge" "" "${cur##--tool=}"
1514 __gitcomp "--octopus --independent --is-ancestor --fork-point"
1518 __gitcomp_nl "$(__git_refs)"
1525 __gitcomp "--dry-run"
1530 if [ $(__git_count_arguments "mv") -gt 0 ]; then
1531 # We need to show both cached and untracked files (including
1532 # empty directories) since this may not be the last argument.
1533 __git_complete_index_file "--cached --others --directory"
1535 __git_complete_index_file "--cached"
1541 __gitcomp "--tags --all --stdin"
1546 local subcommands='add append copy edit list prune remove show'
1547 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1549 case "$subcommand,$cur" in
1556 __gitcomp_nl "$(__git_refs)"
1559 __gitcomp "$subcommands --ref"
1563 add,--reuse-message=*|append,--reuse-message=*|\
1564 add,--reedit-message=*|append,--reedit-message=*)
1565 __gitcomp_nl "$(__git_refs)" "" "${cur#*=}"
1568 __gitcomp '--file= --message= --reedit-message=
1575 __gitcomp '--dry-run --verbose'
1584 __gitcomp_nl "$(__git_refs)"
1593 __git_complete_strategy && return
1596 --recurse-submodules=*)
1597 __gitcomp "$__git_fetch_recurse_submodules" "" "${cur##--recurse-submodules=}"
1602 --rebase --no-rebase
1603 $__git_merge_options
1604 $__git_fetch_options
1609 __git_complete_remote_or_refspec
1612 __git_push_recurse_submodules="check on-demand"
1618 __gitcomp_nl "$(__git_remotes)"
1623 __gitcomp_nl "$(__git_remotes)" "" "${cur##--repo=}"
1626 --recurse-submodules=*)
1627 __gitcomp "$__git_push_recurse_submodules" "" "${cur##--recurse-submodules=}"
1632 --all --mirror --tags --dry-run --force --verbose
1633 --receive-pack= --repo= --set-upstream
1634 --recurse-submodules=
1639 __git_complete_remote_or_refspec
1644 local dir="$(__gitdir)"
1645 if [ -d "$dir"/rebase-apply ] || [ -d "$dir"/rebase-merge ]; then
1646 __gitcomp "--continue --skip --abort"
1649 __git_complete_strategy && return
1652 __gitcomp "$__git_whitespacelist" "" "${cur##--whitespace=}"
1657 --onto --merge --strategy --interactive
1658 --preserve-merges --stat --no-stat
1659 --committer-date-is-author-date --ignore-date
1660 --ignore-whitespace --whitespace=
1661 --autosquash --fork-point --no-fork-point
1666 __gitcomp_nl "$(__git_refs)"
1671 local subcommands="show delete expire"
1672 local subcommand="$(__git_find_on_cmdline "$subcommands")"
1674 if [ -z "$subcommand" ]; then
1675 __gitcomp "$subcommands"
1677 __gitcomp_nl "$(__git_refs)"
1681 __git_send_email_confirm_options="always never auto cc compose"
1682 __git_send_email_suppresscc_options="author self cc bodycc sob cccmd body all"
1689 $__git_send_email_confirm_options
1690 " "" "${cur##--confirm=}"
1695 $__git_send_email_suppresscc_options
1696 " "" "${cur##--suppress-cc=}"
1700 --smtp-encryption=*)
1701 __gitcomp "ssl tls" "" "${cur##--smtp-encryption=}"
1707 " "" "${cur##--thread=}"
1711 __gitcomp "--annotate --bcc --cc --cc-cmd --chain-reply-to
1712 --compose --confirm= --dry-run --envelope-sender
1714 --in-reply-to --no-chain-reply-to --no-signed-off-by-cc
1715 --no-suppress-from --no-thread --quiet
1716 --signed-off-by-cc --smtp-pass --smtp-server
1717 --smtp-server-port --smtp-encryption= --smtp-user
1718 --subject --suppress-cc= --suppress-from --thread --to
1719 --validate --no-validate
1720 $__git_format_patch_options"
1724 __git_complete_revlist
1732 __git_config_get_set_variables ()
1734 local prevword word config_file= c=$cword
1735 while [ $c -gt 1 ]; do
1738 --system|--global|--local|--file=*)
1743 config_file="$word $prevword"
1751 git --git-dir="$(__gitdir)" config $config_file --list 2>/dev/null |
1765 branch.*.remote|branch.*.pushremote)
1766 __gitcomp_nl "$(__git_remotes)"
1770 __gitcomp_nl "$(__git_refs)"
1774 __gitcomp "false true"
1778 __gitcomp_nl "$(__git_remotes)"
1782 local remote="${prev#remote.}"
1783 remote="${remote%.fetch}"
1784 if [ -z "$cur" ]; then
1785 __gitcomp_nl "refs/heads/" "" "" ""
1788 __gitcomp_nl "$(__git_refs_remotes "$remote")"
1792 local remote="${prev#remote.}"
1793 remote="${remote%.push}"
1794 __gitcomp_nl "$(git --git-dir="$(__gitdir)" \
1795 for-each-ref --format='%(refname):%(refname)' \
1799 pull.twohead|pull.octopus)
1800 __git_compute_merge_strategies
1801 __gitcomp "$__git_merge_strategies"
1804 color.branch|color.diff|color.interactive|\
1805 color.showbranch|color.status|color.ui)
1806 __gitcomp "always never auto"
1810 __gitcomp "false true"
1815 normal black red green yellow blue magenta cyan white
1816 bold dim ul blink reverse
1821 __gitcomp "log short"
1825 __gitcomp "man info web html"
1829 __gitcomp "$__git_log_date_formats"
1832 sendemail.aliasesfiletype)
1833 __gitcomp "mutt mailrc pine elm gnus"
1837 __gitcomp "$__git_send_email_confirm_options"
1840 sendemail.suppresscc)
1841 __gitcomp "$__git_send_email_suppresscc_options"
1844 --get|--get-all|--unset|--unset-all)
1845 __gitcomp_nl "$(__git_config_get_set_variables)"
1855 --system --global --local --file=
1856 --list --replace-all
1857 --get --get-all --get-regexp
1858 --add --unset --unset-all
1859 --remove-section --rename-section
1864 local pfx="${cur%.*}." cur_="${cur##*.}"
1865 __gitcomp "remote pushremote merge mergeoptions rebase" "$pfx" "$cur_"
1869 local pfx="${cur%.*}." cur_="${cur#*.}"
1870 __gitcomp_nl "$(__git_heads)" "$pfx" "$cur_" "."
1871 __gitcomp_nl_append $'autosetupmerge\nautosetuprebase\n' "$pfx" "$cur_"
1875 local pfx="${cur%.*}." cur_="${cur##*.}"
1877 argprompt cmd confirm needsfile noconsole norescan
1878 prompt revprompt revunmerged title
1883 local pfx="${cur%.*}." cur_="${cur##*.}"
1884 __gitcomp "cmd path" "$pfx" "$cur_"
1888 local pfx="${cur%.*}." cur_="${cur##*.}"
1889 __gitcomp "cmd path" "$pfx" "$cur_"
1893 local pfx="${cur%.*}." cur_="${cur##*.}"
1894 __gitcomp "cmd path trustExitCode" "$pfx" "$cur_"
1898 local pfx="${cur%.*}." cur_="${cur#*.}"
1899 __git_compute_all_commands
1900 __gitcomp_nl "$__git_all_commands" "$pfx" "$cur_"
1904 local pfx="${cur%.*}." cur_="${cur##*.}"
1906 url proxy fetch push mirror skipDefaultUpdate
1907 receivepack uploadpack tagopt pushurl
1912 local pfx="${cur%.*}." cur_="${cur#*.}"
1913 __gitcomp_nl "$(__git_remotes)" "$pfx" "$cur_" "."
1914 __gitcomp_nl_append "pushdefault" "$pfx" "$cur_"
1918 local pfx="${cur%.*}." cur_="${cur##*.}"
1919 __gitcomp "insteadOf pushInsteadOf" "$pfx" "$cur_"
1925 advice.commitBeforeMerge
1927 advice.implicitIdentity
1928 advice.pushNonFastForward
1929 advice.resolveConflict
1933 apply.ignorewhitespace
1935 branch.autosetupmerge
1936 branch.autosetuprebase
1940 color.branch.current
1945 color.decorate.branch
1946 color.decorate.remoteBranch
1947 color.decorate.stash
1957 color.diff.whitespace
1962 color.grep.linenumber
1965 color.grep.separator
1967 color.interactive.error
1968 color.interactive.header
1969 color.interactive.help
1970 color.interactive.prompt
1975 color.status.changed
1977 color.status.nobranch
1978 color.status.untracked
1979 color.status.updated
1988 core.bigFileThreshold
1991 core.deltaBaseCacheLimit
1996 core.fsyncobjectfiles
2000 core.logAllRefUpdates
2001 core.loosecompression
2004 core.packedGitWindowSize
2006 core.preferSymlinkRefs
2009 core.repositoryFormatVersion
2011 core.sharedRepository
2015 core.warnAmbiguousRefs
2018 diff.autorefreshindex
2020 diff.ignoreSubmodules
2027 diff.suppressBlankEmpty
2033 fetch.recurseSubmodules
2043 format.subjectprefix
2054 gc.reflogexpireunreachable
2058 gitcvs.commitmsgannotation
2059 gitcvs.dbTableNamePrefix
2070 gui.copyblamethreshold
2074 gui.matchtrackingbranch
2075 gui.newbranchtemplate
2076 gui.pruneduringfetch
2077 gui.spellingdictionary
2092 http.sslCertPasswordProtected
2097 i18n.logOutputEncoding
2103 imap.preformattedHTML
2113 interactive.singlekey
2129 mergetool.keepBackup
2130 mergetool.keepTemporaries
2135 notes.rewrite.rebase
2139 pack.deltaCacheLimit
2155 receive.denyCurrentBranch
2156 receive.denyDeleteCurrent
2158 receive.denyNonFastForwards
2161 receive.updateserverinfo
2164 repack.usedeltabaseoffset
2168 sendemail.aliasesfile
2169 sendemail.aliasfiletype
2173 sendemail.chainreplyto
2175 sendemail.envelopesender
2179 sendemail.signedoffbycc
2180 sendemail.smtpdomain
2181 sendemail.smtpencryption
2183 sendemail.smtpserver
2184 sendemail.smtpserveroption
2185 sendemail.smtpserverport
2187 sendemail.suppresscc
2188 sendemail.suppressfrom
2193 status.relativePaths
2194 status.showUntrackedFiles
2195 status.submodulesummary
2198 transfer.unpackLimit
2210 local subcommands="add rename remove set-head set-branches set-url show prune update"
2211 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2212 if [ -z "$subcommand" ]; then
2213 __gitcomp "$subcommands"
2217 case "$subcommand" in
2218 rename|remove|set-url|show|prune)
2219 __gitcomp_nl "$(__git_remotes)"
2221 set-head|set-branches)
2222 __git_complete_remote_or_refspec
2225 local i c='' IFS=$'\n'
2226 for i in $(git --git-dir="$(__gitdir)" config --get-regexp "remotes\..*" 2>/dev/null); do
2239 __gitcomp_nl "$(__git_refs)"
2244 __git_has_doubledash && return
2248 __gitcomp "--merge --mixed --hard --soft --patch"
2252 __gitcomp_nl "$(__git_refs)"
2259 __gitcomp "--edit --mainline --no-edit --no-commit --signoff"
2263 __gitcomp_nl "$(__git_refs)"
2270 __gitcomp "--cached --dry-run --ignore-unmatch --quiet"
2275 __git_complete_index_file "--cached"
2280 __git_has_doubledash && return
2285 $__git_log_common_options
2286 $__git_log_shortlog_options
2287 --numbered --summary
2292 __git_complete_revlist
2297 __git_has_doubledash && return
2300 --pretty=*|--format=*)
2301 __gitcomp "$__git_log_pretty_formats $(__git_pretty_aliases)
2306 __gitcomp "$__git_diff_algorithms" "" "${cur##--diff-algorithm=}"
2310 __gitcomp "--pretty= --format= --abbrev-commit --oneline
2311 $__git_diff_common_options
2316 __git_complete_revlist_file
2324 --all --remotes --topo-order --current --more=
2325 --list --independent --merge-base --no-name
2327 --sha1-name --sparse --topics --reflog
2332 __git_complete_revlist
2337 local save_opts='--keep-index --no-keep-index --quiet --patch'
2338 local subcommands='save list show apply clear drop pop create branch'
2339 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2340 if [ -z "$subcommand" ]; then
2343 __gitcomp "$save_opts"
2346 if [ -z "$(__git_find_on_cmdline "$save_opts")" ]; then
2347 __gitcomp "$subcommands"
2352 case "$subcommand,$cur" in
2354 __gitcomp "$save_opts"
2357 __gitcomp "--index --quiet"
2359 show,--*|drop,--*|branch,--*)
2361 show,*|apply,*|drop,*|pop,*|branch,*)
2362 __gitcomp_nl "$(git --git-dir="$(__gitdir)" stash list \
2363 | sed -n -e 's/:.*//p')"
2373 __git_has_doubledash && return
2375 local subcommands="add status init deinit update summary foreach sync"
2376 if [ -z "$(__git_find_on_cmdline "$subcommands")" ]; then
2379 __gitcomp "--quiet --cached"
2382 __gitcomp "$subcommands"
2392 init fetch clone rebase dcommit log find-rev
2393 set-tree commit-diff info create-ignore propget
2394 proplist show-ignore show-externals branch tag blame
2395 migrate mkdirs reset gc
2397 local subcommand="$(__git_find_on_cmdline "$subcommands")"
2398 if [ -z "$subcommand" ]; then
2399 __gitcomp "$subcommands"
2401 local remote_opts="--username= --config-dir= --no-auth-cache"
2403 --follow-parent --authors-file= --repack=
2404 --no-metadata --use-svm-props --use-svnsync-props
2405 --log-window-size= --no-checkout --quiet
2406 --repack-flags --use-log-author --localtime
2407 --ignore-paths= --include-paths= $remote_opts
2410 --template= --shared= --trunk= --tags=
2411 --branches= --stdlayout --minimize-url
2412 --no-metadata --use-svm-props --use-svnsync-props
2413 --rewrite-root= --prefix= --use-log-author
2414 --add-author-from $remote_opts
2417 --edit --rmdir --find-copies-harder --copy-similarity=
2420 case "$subcommand,$cur" in
2422 __gitcomp "--revision= --fetch-all $fc_opts"
2425 __gitcomp "--revision= $fc_opts $init_opts"
2428 __gitcomp "$init_opts"
2432 --merge --strategy= --verbose --dry-run
2433 --fetch-all --no-rebase --commit-url
2434 --revision --interactive $cmt_opts $fc_opts
2438 __gitcomp "--stdin $cmt_opts $fc_opts"
2440 create-ignore,--*|propget,--*|proplist,--*|show-ignore,--*|\
2441 show-externals,--*|mkdirs,--*)
2442 __gitcomp "--revision="
2446 --limit= --revision= --verbose --incremental
2447 --oneline --show-commit --non-recursive
2448 --authors-file= --color
2453 --merge --verbose --strategy= --local
2454 --fetch-all --dry-run $fc_opts
2458 __gitcomp "--message= --file= --revision= $cmt_opts"
2464 __gitcomp "--dry-run --message --tag"
2467 __gitcomp "--dry-run --message"
2470 __gitcomp "--git-format"
2474 --config-dir= --ignore-paths= --minimize
2475 --no-auth-cache --username=
2479 __gitcomp "--revision= --parent"
2490 while [ $c -lt $cword ]; do
2494 __gitcomp_nl "$(__git_tags)"
2509 __gitcomp_nl "$(__git_tags)"
2513 __gitcomp_nl "$(__git_refs)"
2525 local i c=1 command __git_dir
2527 while [ $c -lt $cword ]; do
2530 --git-dir=*) __git_dir="${i#--git-dir=}" ;;
2531 --git-dir) ((c++)) ; __git_dir="${words[c]}" ;;
2532 --bare) __git_dir="." ;;
2533 --help) command="help"; break ;;
2534 -c|--work-tree|--namespace) ((c++)) ;;
2536 *) command="$i"; break ;;
2541 if [ -z "$command" ]; then
2556 --no-replace-objects
2560 *) __git_compute_porcelain_commands
2561 __gitcomp "$__git_porcelain_commands $(__git_aliases)" ;;
2566 local completion_func="_git_${command//-/_}"
2567 declare -f $completion_func >/dev/null && $completion_func && return
2569 local expansion=$(__git_aliased_command "$command")
2570 if [ -n "$expansion" ]; then
2572 completion_func="_git_${expansion//-/_}"
2573 declare -f $completion_func >/dev/null && $completion_func
2579 __git_has_doubledash && return
2581 local g="$(__gitdir)"
2583 if [ -f "$g/MERGE_HEAD" ]; then
2589 $__git_log_common_options
2590 $__git_log_gitk_options
2596 __git_complete_revlist
2599 if [[ -n ${ZSH_VERSION-} ]]; then
2600 echo "WARNING: this script is deprecated, please see git-completion.zsh" 1>&2
2602 autoload -U +X compinit && compinit
2608 local cur_="${3-$cur}"
2614 local c IFS=$' \t\n'
2622 array[${#array[@]}+1]="$c"
2625 compadd -Q -S '' -p "${2-}" -a -- array && _ret=0
2636 compadd -Q -S "${4- }" -p "${2-}" -- ${=1} && _ret=0
2645 compadd -Q -p "${2-}" -f -- ${=1} && _ret=0
2650 local _ret=1 cur cword prev
2651 cur=${words[CURRENT]}
2652 prev=${words[CURRENT-1]}
2654 emulate ksh -c __${service}_main
2655 let _ret && _default && _ret=0
2659 compdef _git git gitk
2665 local cur words cword prev
2666 _get_comp_words_by_ref -n =: cur words cword prev
2670 # Setup completion for certain functions defined above by setting common
2671 # variables and workarounds.
2672 # This is NOT a public function; use at your own risk.
2675 local wrapper="__git_wrap${2}"
2676 eval "$wrapper () { __git_func_wrap $2 ; }"
2677 complete -o bashdefault -o default -o nospace -F $wrapper $1 2>/dev/null \
2678 || complete -o default -o nospace -F $wrapper $1
2681 # wrapper for backwards compatibility
2684 __git_wrap__git_main
2687 # wrapper for backwards compatibility
2690 __git_wrap__gitk_main
2693 __git_complete git __git_main
2694 __git_complete gitk __gitk_main
2696 # The following are necessary only for Cygwin, and only are needed
2697 # when the user has tab-completed the executable name and consequently
2698 # included the '.exe' suffix.
2700 if [ Cygwin = "$(uname -o 2>/dev/null)" ]; then
2701 __git_complete git.exe __git_main