dotfiles/completions/_git

6165 lines
251 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#compdef git git-cvsserver git-receive-pack git-upload-archive git-upload-pack git-shell gitk tig
# Some parts of this completion's behaviour are configurable:
#
# Say you got your own git sub-commands (git will run a program `git-foo'
# when you run "git foo") and you want "git f<tab>" to complete that sub
# commands name for you. You can make that sub-command know to the completion
# via the user-command style:
#
# % zstyle ':completion:*:*:git:*' user-commands foo:'description for foo'
#
# `user-commands' is a list style, so you can add any number of programs there.
# The :description part is optional, so you could add all git-* programs from
# your $path like this:
#
# % zstyle ':completion:*:*:git:*' user-commands ${${(M)${(k)commands}:#git-*}/git-/}
#
# A better solution is to create a function _git-foo() to handle specific
# completion for that command. This also allows you to add command-specific
# completion as well. Place such a function inside an autoloaded #compdef file
# and you should be all set. You can add a description to such a function by
# adding a line matching
#
# #description DESCRIPTION
#
# as the second line in the file. See
# Completion/Debian/Command/_git-buildpackage in the Zsh sources for an
# example.
#
# As this solution is so much better than the user-commands zstyle method, the
# zstyle method is now DEPRECATED. It will most likely be removed in the next
# major release of Zsh (5.0).
#
# When _git does not know a given sub-command (say `bar'), it falls back to
# completing file names for all arguments to that sub command. I.e.:
#
# % git bar <tab>
#
# ...will complete file names. If you do *not* want that fallback to be used,
# use the `use-fallback' style like this:
#
# % zstyle ':completion:*:*:git*:*' use-fallback false
# TODO: There is still undocumented configurability in here.
# HIGH-LEVEL COMMANDS (PORCELAIN)
# Main Porcelain Commands
(( $+functions[_git-add] )) ||
_git-add () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
local ignore_missing=
if (( words[(I)-n|--dry-run] )); then
ignore_missing='--ignore-missing[check if files (even missing) are ignored in dry run]'
fi
_arguments -w -C -S -s \
'(-n --dry-run)'{-n,--dry-run}'[do not actually add files; only show which ones would be added]' \
'(-v --verbose)'{-v,--verbose}'[show files as they are added]' \
'(-f --force)'{-f,--force}'[allow adding otherwise ignored files]' \
'(-i --interactive : -)'{-i,--interactive}'[add contents interactively to index]' \
'(-p --patch)'{-p,--patch}'[like -i but go directly into patch mode for specified files]' \
'(-e --edit)'{-e,--edit}'[open diff against index in editor]' \
'(-u --update -A --all)'{-u,--update}'[update only files git already knows about]' \
'(-A --all -u --update)'{-A,--all}'[act as both add . and add -u]' \
'(-N --intent-to-add)'{-N,--intent-to-add}'[record only that path will be added later]' \
'--refresh[do not add files, but refresh their stat() info in index]' \
'--ignore-errors[continue adding if an error occurs]' \
$ignore_missing \
'*:: :->file' && return
case $state in
(file)
declare -a ignored_files_alternatives
if [[ -n ${opt_args[(I)-f|--force]} ]]; then
ignored_files_alternatives=(
'ignored-modified-files:ignored modified files:__git_ignore_line_inside_arguments __git_modified_files --ignored'
'ignored-other-files:ignored other files:__git_ignore_line_inside_arguments __git_other_files --ignored')
fi
_alternative \
'modified-files::__git_ignore_line_inside_arguments __git_modified_files' \
'other-files::__git_ignore_line_inside_arguments __git_other_files' \
$ignored_files_alternatives && ret=0
;;
esac
return ret
}
(( $+functions[_git-am] )) ||
_git-am () {
local -a apply_options
__git_setup_apply_options
# NOTE: --rebasing and --resolvemsg are only for internal use between git
# rebase and git am.
# TODO: --patch-format is undocumented.
# TODO: --rerere-autoupdate and --no-rerere-autoupdate are
# undocumented (and not implemented here).
_arguments -S \
'(-s --signoff)'{-s,--signoff}'[add Signed-off-by: line to the commit message]' \
'(-k --keep)'{-k,--keep}'[pass -k to git mailinfo]' \
'( --no-keep-cr)--keep-cr[pass --keep-cr to git mailsplit]' \
'(--keep-cr )--no-keep-cr[do not pass --keep-cr to git mailsplit]' \
'(-c --scissors --no-scissors)'{-c,--scissors}'[strip everything before a scissors line]' \
'(-c --scissors --no-scissors)--no-scissors[ignore scissors lines]' \
'(-q --quiet)'{-q,--quiet}'[only print error messages]' \
'(-u --utf8 --no-utf8)'{-u,--utf8}'[pass -u to git mailinfo]' \
'(-u --utf8 --no-utf8)--no-utf8[pass -n to git mailinfo]' \
'(-3 --3way)'{-3,--3way}'[use 3-way merge if patch does not apply cleanly]' \
$apply_options \
'(-i --interactive)'{-i,--interactive}'[apply patches interactively]' \
'--committer-date-is-author-date[use author date as committer date]' \
'--ignore-date[use committer date as author date]' \
'--skip[skip the current patch]' \
'(--continue -r --resolved)'{--continue,-r,--resolved}'[continue after resolving patch failure by hand]' \
'--abort[restore the original branch and abort the patching operation]' \
'--patch-format=-[specify format patches are in]:patch format:((mbox\:"mbox format"
stgit-series\:"StGit patch series"
stgit\:"stgit format"))' \
'*:mbox file:_files'
}
(( $+functions[_git-archive] )) ||
_git-archive () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
declare -a backend_args
if (( words[(I)--format=*] > 0 && words[(I)--format=*] < CURRENT )); then
case ${words[$words[(I)--format=*]]#--format=} in
(zip)
backend_args=(
'-0[do not deflate files]'
'-1[minimum compression]'
'-2[a little more compression]'
'-3[slightly more compression]'
'-4[a bit more compression]'
'-5[even more compression]'
'-6[slightly even more compression]'
'-7[getting there]'
'-8[close to maximum compression]'
'-9[maximum compression]')
;;
esac
fi
_arguments -w -C -S -s \
'--format=-[format of the resulting archive]:archive format:__git_archive_formats' \
'(- :)'{-l,--list}'[list available archive formats]' \
'(-v --verbose)'{-v,--verbose}'[report progress to stderr]' \
'--prefix=-[prepend the given path prefix to each filename]:path prefix:_directories -r ""' \
'--output=[write archive to argument instead of stdout]:archive:_files' \
'--worktree-attributes[look for attributes in .gitattributes in working directory too]' \
$backend_args \
'--remote=[archive remote repository]:remote repository:__git_any_repositories' \
'--exec=[path to git-receive-pack on remote]:remote path:_files' \
': :__git_tree_ishs' \
'*: :->file' && ret=0
case $state in
(file)
__git_tree_files ${PREFIX:-.} $line[1] && ret=0
;;
esac
return ret
}
(( $+functions[_git-applymbox] )) ||
_git-applymbox () {
_arguments -A '-*' \
'-k[do not modify "Subject:" header]' \
'-m[apply patches with "git-apply" and fail if patch is unclean]' \
'-q[apply patches interactively]' \
'-u[encode commit information in UTF-8]' \
'(1)-c[restart command after fixing an unclean patch]:patch:_files -g ".dotest/0*"' \
':mbox file:_files' \
'::signoff file:__git_signoff_file'
}
(( $+functions[_git-bisect] )) ||
_git-bisect () {
# TODO: next subcommand is undocumented. Git-bisect.sh mentions that the
# subcommand might be removed from the UI level.
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C \
'--help[display git-bisect manual page]' \
': :->command' \
'*:: :->option-or-argument' && ret=0
case $state in
(command)
declare -a commands
commands=(
help:'display a short usage description'
start:'reset bisection state and start a new bisection'
bad:'mark current or given revision as bad'
good:'mark current or given revision as good'
skip:'choose a nearby commit'
next:'find next bisection to test and check it out'
reset:'finish bisection search and return to the given branch (or master)'
visualize:'show the remaining revisions in gitk'
view:'show the remaining revisions in gitk'
replay:'replay a bisection log'
log:'show the log of the current bisection'
run:'run evaluation script')
_describe -t commands command commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*}-$line[1]:
case $line[1] in
(start)
_arguments -C \
':bad revision:__git_commits' \
'*: :->revision-or-path' && ret=0
case $state in
(revision-or-path)
if compset -N '--' || ! __git_is_committish $line[CURRENT-1]; then
__git_cached_files && ret=0
else
_alternative \
'revisions::__git_revisions' \
'files::__git_cached_files' && ret=0
fi
;;
esac
;;
(bad)
_arguments \
': :__git_commits' && ret=0
;;
(good|skip)
# TODO: skip can take revlists.
_arguments \
'*: :__git_commits' && ret=0
;;
(replay)
_arguments \
':log file:_files' && ret=0
;;
(reset)
_arguments \
': :__git_heads' && ret=0
;;
(run)
_arguments \
'*:: : _normal' && ret=0
;;
(view|visualize)
local -a log_options revision_options
__git_setup_log_options
__git_setup_revision_options
_arguments -w -C -s \
$log_options \
$revision_options && ret=0
(*)
_nothing
;;
esac
;;
esac
return ret
}
(( $+functions[_git-branch] )) ||
_git-branch () {
declare l c m d
l='--color --no-color -r -a -v --verbose --abbrev --no-abbrev'
c='-l -f --force -t --track --no-track --set-upstream --contains --merged --no-merged'
m='-m -M'
d='-d -D'
declare -a dependent_creation_args
if (( words[(I)-r] == 0 )); then
dependent_creation_args=(
"($l $m $d): :__git_branch_names"
"::start-point:__git_revisions")
fi
declare -a dependent_deletion_args
if (( words[(I)-d] || words[(I)-D] )); then
dependent_creation_args=
dependent_deletion_args=(
'-r[delete only remote-tracking branches]')
if (( words[(I)-r] )); then
dependent_deletion_args+='*: :__git_ignore_line_inside_arguments __git_remote_branch_names'
else
dependent_deletion_args+='*: :__git_ignore_line_inside_arguments __git_branch_names'
fi
fi
declare -a dependent_modification_args
if (( words[(I)-m] || words[(I)-M] )); then
dependent_creation_args=
dependent_modification_args=(
':old or new branch name:__git_branch_names'
'::new branch name:__git_branch_names')
fi
_arguments -w -S -s \
"($c $m $d --no-color :)--color=-[turn on branch coloring]:: :__git_color_whens" \
"($c $m $d : --color)--no-color[turn off branch coloring]" \
"($c $m -a)-r[list or delete only remote-tracking branches]" \
"($c $m $d : -r)-a[list both remote-tracking branches and local branches]" \
"($c $m $d : -v --verbose)"{-v,--verbose}'[show SHA1 and commit subject line for each head]' \
"($c $m $d :)--abbrev=[set minimum SHA1 display-length]: :__git_guard_number length" \
"($c $m $d :)--no-abbrev[do not abbreviate sha1s]" \
"($l $m $d)-l[create the branch's reflog]" \
"($l $m $d -f --force)"{-f,--force}"[force the creation of a new branch]" \
"($l $m $d -t --track)"{-t,--track}"[set up configuration so that pull merges from the start point]" \
"($l $m $d)--no-track[override the branch.autosetupmerge configuration variable]" \
"($l $m $d)--set-upstream[set up configuration so that pull merges]" \
"($l $m $d)--contains=[only list branches which contain the specified commit]: :__git_committishs" \
"($l $m $d)--merged=[only list branches which are fully contained by HEAD]: :__git_committishs" \
"($l $m $d)--no-merged=[do not list branches which are fully contained by HEAD]: :__git_committishs" \
$dependent_creation_args \
"($l $c $d -M)-m[rename a branch and the corresponding reflog]" \
"($l $c $d -m)-M[rename a branch even if the new branch-name already exists]" \
$dependent_modification_args \
"($l $c $m -D)-d[delete a fully merged branch]" \
"($l $c $m -d)-D[delete a branch]" \
$dependent_deletion_args
}
(( $+functions[_git-bundle] )) ||
_git-bundle () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C \
': :->command' \
'*:: :->option-or-argument' && ret=0
case $state in
(command)
declare -a commands
commands=(
'create:create a bundle'
'verify:check that a bundle is valid and will apply cleanly'
'list-heads:list references defined in bundle'
'unbundle:unbundle a bundle to repository')
_describe -t commands command commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*}-$line[1]:
case $line[1] in
(create)
if (( CURRENT == 2 )); then
_arguments \
':bundle:_files' && ret=0
else
local revision_options
__git_setup_revision_options
_arguments -w -S -s \
$revision_options \
': :_files' \
'*: :__git_commit_ranges2' && ret=0
fi
;;
(verify)
_arguments \
':bundle:_files' && ret=0
;;
(list-heads|unbundle)
_arguments \
'*: :__git_ref_specs' && ret=0
;;
esac
;;
esac
return ret
}
(( $+functions[_git-checkout] )) ||
_git-checkout () {
# TODO: __git_tree_ishs is just stupid. It should be giving us a list of tags
# and perhaps also allow all that just with ^{tree} and so on. Not quite sure
# how to do that, though.
local new_branch_reflog_opt
if (( words[(I)-b|-B] )); then
new_branch_reflog_opt="(--patch)-l[create the new branch's reflog]"
fi
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -w -C -s \
'(-q --quiet)'{-q,--quiet}'[suppress feedback messages]' \
'(-f --force -m --merge --conflict --patch)'{-f,--force}'[force branch switch/ignore unmerged entries]' \
'(-q --quiet --theirs --patch)--ours[check out stage #2 for unmerged paths]' \
'(-q --quiet --ours --patch)--theirs[check out stage #3 for unmerged paths]' \
'( -B --orphan --ours --theirs --conflict --patch)-b[create a new branch based at given commit]: :__git_branch_names' \
'(-b --orphan --ours --theirs --conflict --patch)-B[create or update branch based at given commit]: :__git_branch_names' \
'(-t --track --orphan --patch)'{-t,--track}'[set up configuration so pull merges from the base commit]' \
'(--patch)--no-track[override the branch.autosetupmerge configuration variable]' \
$new_branch_reflog_opt \
'(-b -B -t --track --patch)--orphan[create a new orphan branch based at given commit]: :__git_branch_names' \
'(-q --quiet -f --force -m --merge --conflict --patch)'{-m,--merge}'[3way merge current branch, working tree and new branch]' \
'(-q --quiet -f --force -m --merge --patch)--conflict[same as --merge, using given merge style]:style:(merge diff3)' \
'(-)'{-p,--patch}'[interactively select hunks in diff between given tree-ish and working tree]' \
'(-)--[start file arguments]' \
'*:: :->branch-or-tree-ish-or-file' && ret=0
case $state in
(branch-or-tree-ish-or-file)
# TODO: Something about *:: brings us here when we complete at “-”. I
# guess that this makes sense in a way, as we might want to treat it as
# an argument, but I cant find anything in the documentation about this
# behavior.
[[ $line[CURRENT] = -* ]] && return
if (( CURRENT == 1 )) && [[ -z $opt_args[(I)--] ]]; then
# TODO: Allow A...B
local branch_arg='branches::__git_revisions' \
tree_ish_arg='tree-ishs::__git_tree_ishs' \
file_arg='modified-files::__git_modified_files'
if [[ -n ${opt_args[(I)-b|-B|--orphan]} ]]; then
tree_ish_arg=
file_arg=
elif [[ -n $opt_args[(I)--track] ]]; then
branch_arg='remote-branches::__git_remote_branch_names'
tree_ish_arg=
file_arg=
elif [[ -n ${opt_args[(I)--ours|--theirs|-m|--conflict|--patch]} ]]; then
branch_arg=
fi
_alternative \
$branch_arg \
$tree_ish_arg \
$file_arg && ret=0
elif [[ -n ${opt_args[(I)-b|-B|-t|--track|--orphan]} ]]; then
_nothing
elif [[ -n $line[1] ]] && __git_is_treeish $line[1]; then
__git_ignore_line __git_tree_files ${PREFIX:-.} $line[1] && ret=0
else
__git_ignore_line __git_modified_files && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-cherry-pick] )) ||
_git-cherry-pick () {
_arguments \
'(-e --edit --ff)'{-e,--edit}'[edit commit before committing the revert]' \
'(--ff)-x[append information about what commit was cherry-picked]' \
'(-m --mainline)'{-m,--mainline}'[specify mainline when cherry-picking a merge commit]:parent number' \
'(-n --no-commit --ff)'{-n,--no-commit}'[do not make the actually commit]' \
'(-s --signoff --ff)'{-s,--signoff}'[add Signed-off-by line at the end of the commit message]' \
'(-e --edit -x -n --no-commit -s --signoff)--ff[fast forward, if possible]' \
': :__git_revisions'
}
(( $+functions[_git-citool] )) ||
_git-citool () {
_nothing
}
(( $+functions[_git-clean] )) ||
_git-clean () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -w -C -S -s \
'-d[also remove untracked directories]' \
'(-f --force)'{-f,--force}'[required when clean.requireForce is true (default)]' \
'(-n --dry-run)'{-n,--dry-run}'[only show what would and what would not be removed]' \
'(-q --quiet)'{-q,--quiet}'[only report errors]' \
'*'{-e,--exclude=}'[skip files matching specified pattern]:pattern' \
'(-X )-x[also remove ignored files]' \
'( -x)-X[remove only ignored files]' \
'*: :->file' && ret=0
case $state in
(file)
local exclusion ignored_other_files_alt other_files_alt
declare -a exclusions
for spec in $opt_args[-e] $opt_args[--exclude]; do
integer i
for (( i = 1; i <= $#spec; i++ )); do
case $spec[i] in
(\\)
if (( i + 1 <= $#spec )) && [[ $spec[i+1] == : ]]; then
(( i++ ))
exclusion+=:
else
exclusion+=$spec[i]
fi
;;
(:)
exclusions+=(-x $exclusion) exclusion=
;;
(*)
exclusion+=$spec[i]
;;
esac
done
done
[[ -n $exclusion ]] && exclusions+=(-x $exclusion)
if [[ -n ${opt_args[(I)-x|-X]} ]]; then
ignored_other_files_alt="ignored-untracked-files::__git_ignored_other_files $exclusions"
fi
if [[ -z ${opt_args[(I)-X]} ]]; then
other_files_alt="untracked-files::__git_other_files $exclusions"
fi
_alternative \
$ignored_other_files_alt \
$other_files_alt && ret=0
;;
esac
return ret
}
(( $+functions[_git-clone] )) ||
_git-clone () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
# TODO: Argument to -o should be a remote name.
# TODO: Argument to -b should complete branch names in the repository being
# cloned.
_arguments -w -C -S -s \
'(-l --local)'{-l,--local}'[clone locally, hardlink refs and objects if possible]' \
'--no-hardlinks[copy files instead of hardlinking when doing a local clone]' \
'(-s --shared)'{-s,--shared}'[share the objects with the source repository (warning: see man page)]' \
'--reference[reference repository]:repository:_directories' \
'(-q --quiet)'{-q,--quiet}'[operate quietly]' \
'(-v --verbose)'{-v,--verbose}'[always display the progressbar]' \
'--progress[output progress even if stderr is not a terminal]' \
'(-n --no-checkout)'{-n,--no-checkout}'[do not checkout HEAD after clone is complete]' \
'(-o --origin)--bare[make a bare GIT repository]' \
'(--bare)--mirror[clone refs into refs/* instead of refs/remotes/origin/*]' \
'(-o --origin --bare)'{-o,--origin}'[use given remote name instead of "origin"]: :__git_guard_branch-name' \
'(-b --branch)'{-b,--branch}'[point HEAD to the given branch]: :__git_guard_branch-name' \
'(-u --upload-pack)'{-u,--upload-pack=}'[specify path to git-upload-pack on remote side]:remote path' \
'--template=[directory to use as a template for the object database]: :_directories' \
'--depth[create a shallow clone, given number of revisions deep]: :__git_guard_number depth' \
'--recursive[initialize all contained submodules]' \
': :->repository' \
': :_directories' && ret=0
case $state in
(repository)
if [[ -n ${opt_args[(I)-l|--local|--no-hardlinks|-s|--shared|--reference]} ]]; then
__git_local_repositories && ret=0
else
__git_any_repositories && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-commit] )) ||
_git-commit () {
local amend_opt='--amend[amend the tip of the current branch]'
if __git_is_initial_commit || __git_is_in_middle_of_merge; then
amend_opt=
fi
local reset_author_opt=
if (( words[(I)-C|--reuse-message(=*|)|-c|--reedit-message(=*|)|--amend] )); then
reset_author_opt='(--author)--reset-author[make committer the author of the commit]'
fi
# TODO: --null is an undocumented alias.
# TODO: --interactive isnt explicitly listed in the documentation.
_arguments -w -S -s \
'(-a --all --interactive -o --only -i --include *)'{-a,--all}'[stage all modified and deleted paths]' \
$reset_author_opt \
'( --porcelain --dry-run)--short[output dry run in short format]' \
'(--short --dry-run)--porcelain[output dry run in porcelain-ready format]' \
'(--short --porcelain --dry-run -z --null)'{-z,--null}'[separate dry run entry output with NUL]' \
'(--reset-author)--author[override the author name used in the commit]:author name' \
'--date=[override the author date used in the commit]:date' \
'(-s --signoff)'{-s,--signoff}'[add Signed-off-by line at the end of the commit message]' \
'(-n --no-verify)'{-n,--no-verify}'[do not look for suspicious lines the commit introduces]' \
'--allow-empty[allow recording an empty commit]' \
'--allow-empty-message[allow recording a commit with an empty message]' \
'--cleanup=[specify how the commit message should be cleaned up]:mode:((verbatim\:"don'\''t change the commit message at all"
whitespace\:"remove leading and trailing whitespace lines"
strip\:"remove both whitespace and commentary lines"
default\:"act as '\''strip'\'' if the message is to be edited and as '\''whitespace'\'' otherwise"))' \
'(-e --edit)'{-e,--edit}'[edit the commit message before committing]' \
'(-a --all --interactive -o --only -i --include)'{-i,--include}'[update the given files and commit the whole index]' \
'(-a --all --interactive -o --only -i --include)'{-o,--only}'[commit only the given files]' \
'(-u --untracked-files)'{-u-,--untracked-files=}'[show files in untracked directories]::mode:((no\:"show no untracked files"
normal\:"show untracked files and directories"
all\:"show individual files in untracked directories"))' \
'(-q --quiet -v --verbose)'{-v,--verbose}'[show unified diff of all file changes]' \
'(-q --quiet -v --verbose)'{-q,--quiet}'[suppress commit summary message]' \
'--dry-run[only show list of paths that are to be commited or not, and any untracked]' \
'( --no-status)--status[include the output of git status in the commit message template]' \
'(--status )--no-status[do not include the output of git status in the commit message template]' \
'(-a --all --interactive -o --only -i --include *)--interactive[interactively update paths in the index file]' \
'*: :__git_ignore_line_inside_arguments __git_changed_files' \
- '(message)' \
{-C,--reuse-message=}'[use existing commit object with same log message]: :__git_commits' \
{-c,--reedit-message=}'[use existing commit object and edit log message]: :__git_commits' \
{-F,--file=}'[read commit message from given file]: :_files' \
{-m,--message=}'[use the given message as the commit message]:message' \
{-t,--template=}'[use file as a template commit message]:template:_files' \
$amend_opt
}
(( $+functions[_git-describe] )) ||
_git-describe () {
_arguments -w -S -s \
'(*)--dirty=-[describe HEAD, adding mark if dirty]::mark' \
'--all[use any ref found in "$GIT_DIR/refs/"]' \
'--tags[use any ref found in "$GIT_DIR/refs/tags"]' \
'(--tags)--contains[find the tag after the commit instead of before]' \
'(--long)--abbrev=[set minimum SHA1 display-length]: :__git_guard_number length' \
'( --exact-match)--candidates=[consider up to given number of candidates]: :__git_guard_number "number of candidates"' \
'(--candidates )--exact-match[only output exact matches, same as --candidates=0]' \
'--debug[display information about the searching strategy]' \
'(--abbrev)--long[always show full format, even for exact matches]' \
'--match=[only consider tags matching glob pattern]:pattern' \
'--always[show uniquely abbreviated commit object as fallback]' \
'*: :__git_committishs'
}
(( $+functions[_git-diff] )) ||
_git-diff () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
local -a diff_options
__git_setup_diff_options
_arguments -w -C -s \
$* \
$diff_options \
'(--cached --staged)'{--cached,--staged}'[show diff between index and named commit]' \
'(-)--[start file arguments]' \
'*:: :->from-to-file' && ret=0
case $state in
(from-to-file)
case $CURRENT in
(1)
if [[ -n ${opt_args[(I)--]} ]]; then
if [[ -n ${opt_args[(I)--cached|--staged]} ]]; then
__git_changed-in-index_files && ret=0
else
__git_changed-in-working-tree_files && ret=0
fi
else
local files_alt='files::__git_changed-in-working-tree_files'
if [[ -n ${opt_args[(I)--cached|--staged]} ]]; then
files_alt='files::__git_changed-in-index_files'
fi
_alternative \
'commit-ranges::__git_commit_ranges' \
'blobs-and-trees-in-treeish::__git_blobs_and_trees_in_treeish' \
$files_alt \
'blobs::__git_blobs ' && ret=0
fi
;;
(2)
if __git_is_committish_range $line[1]; then
__git_tree_files ${PREFIX:-.} $(__git_committish_range_last $line[1]) && ret=0
elif __git_is_committish $line[1] || __git_is_treeish $line[1]; then
if [[ -n ${opt_args[(I)--]} ]]; then
__git_changed-in-working-tree_files && ret=0
else
_alternative \
'commits::__git_commits' \
'blobs-and-trees-in-treeish::__git_blobs_and_trees_in_treeish' \
'files::__git_changed-in-working-tree_files' && ret=0
fi
elif __git_is_blob $line[1]; then
if [[ -n ${opt_args[(I)--]} ]]; then
__git_cached_files && ret=0
else
_alternative \
'files::__git_cached_files' \
'blobs::__git_blobs' && ret=0
fi
elif [[ -n ${opt_args[(I)--cached|--staged]} ]]; then
__git_changed-in-index_files && ret=0
else
__git_changed-in-working-tree_files && ret=0
fi
;;
(*)
if __git_is_committish_range $line[1]; then
__git_tree_files ${PREFIX:-.} $(__git_committish_range_last $line[1]) && ret=0
elif { __git_is_committish $line[1] && __git_is_committish $line[2] } ||
__git_is_treeish $line[2]; then
__git_tree_files ${PREFIX:-.} $line[2] && ret=0
elif __git_is_blob $line[1] && __git_is_blob $line[2]; then
_nothing
else
__git_changed-in-working-tree_files && ret=0
fi
;;
esac
;;
esac
return ret
}
(( $+functions[_git-fetch] )) ||
_git-fetch () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
local -a fetch_options
__git_setup_fetch_options
_arguments -w -C -S -s \
$fetch_options \
'--multiple[allow several repository arguments]' \
'*:: :->repository-or-group-or-refspec' && ret=0
case $state in
(repository-or-group-or-refspec)
if (( CURRENT > 1 )) && [[ -z ${opt_args[(I)--multiple]} ]]; then
__git_ref_specs && ret=0
else
_alternative \
'remotes::__git_remotes' \
'remotes-groups::__git_remotes_groups' \
'local-repositories::__git_local_repositories' \
'remote-repositories::__git_remote_repositories' && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-format-patch] )) ||
_git-format-patch () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
local -a diff_options
__git_setup_diff_options
# TODO: -- is wrong.
# TODO: Should filter out --name-only, --name-status, and --check from
# $diff_options.
_arguments -w -C -S -s \
$diff_options \
'--[limit the number of patches to prepare]: :__git_guard_number "number of patches to prepare"' \
'(-o --output-directory --stdout)'{-o,--output-directory}'[store resulting files in given directory]: :_directories' \
'(-n --numbered -N --no-numbered -k --keep-subject)'{-n,--numbered}'[name output in \[PATCH n/m\] format]' \
'(-n --numbered -N --no-numbered -k --keep-subject)'{-N,--no-numbered}'[name output in \[PATCH\] format]' \
'--start-number=[start numbering patches at given number]: :__git_guard_number "patch number"' \
'--numbered-files[use only number for file name]' \
'(-n --numbered -N --no-numbered -k --keep-subject --subject-prefix)'{-k,--keep-subject}'[do not strip/add \[PATCH\] from the first line of the commit message]' \
'(-s --signoff)'{-s,--signoff}'[add Signed-off-by: line to the commit message]' \
'(-o --output-directory)--stdout[output the generated mbox on standard output (implies --mbox)]' \
'( --no-attach --inline)--attach=-[create attachments instead of inlining patches]::boundary' \
'(--attach --inline)--no-attach[disable creation of attachments]' \
'(--attach --no-attach )--inline=-[inline patches]::boundary' \
'( --no-thread)--thread=-[make the second and subsequent mails refer to the first]::style:((shallow\:"all refer to the first"
deep\:"each refers to the previous"))' \
'(--thread )--no-thread[do not thread messages]' \
'--in-reply-to=[make the first mail a reply to the given message]:message id' \
'--ignore-if-in-upstream[do not include a patch that matches a commit in the given range]' \
'(-k --keep-subject)--subject-prefix=[use the given prefix instead of \[PATCH\]]:prefix' \
'*--to=[add To: header to email headers]: :_email_addresses' \
'*--cc=[add Cc: header to email headers]: :_email_addresses' \
'*--add-header=[add an arbitrary header to email headers]:header' \
'--cover-letter[generate a cover letter template]' \
'( --no-signature)--signature=[add a signature]:signature' \
'(--signature )--no-signature[do not add a signature]' \
'--suffix=[use the given suffix for filenames]:filename suffix' \
'--no-binary[do not output contents of changes in binary files, only note that they differ]' \
'--root[treat the revision argument as a range]' \
': :->commit-or-commit-range' && ret=0
case $state in
(commit-or-commit-range)
if [[ -n ${opt_args[(I)--root]} ]]; then
__git_commits && ret=0
else
__git_commit_ranges && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-gc] )) ||
_git-gc () {
_arguments -w -S -s \
'--aggressive[more aggressively optimize]' \
'--auto[check whether housekeeping is required]' \
'( --no-prune)--prune=[prune loose objects older than given date]: :__git_datetimes' \
'(--prune )--no-prune[do not prune any loose objects]' \
'--quiet[suppress all progress reports]'
}
(( $+functions[_git-grep] )) ||
_git-grep () {
local -a pattern_operators
# TODO: Need to deal with grouping with ( and )
if (( words[(I)-e] == CURRENT - 2 )); then
pattern_operators=(
'--and[both patterns must match]'
'--or[either pattern must match]'
'--not[the following pattern must not match]')
fi
local curcontext=$curcontext state line ret=1
declare -A opt_args
# TODO: Need to implement -<num> as a shorthand for -C<num>
_arguments -C -A '-*' \
'(-O --open-files-in-pager --no-index)--cached[search blobs registered in index file instead of working tree]' \
'(--cached)--no-index[search files in current directory, not just treacked files]' \
'(-a --text)'{-a,--text}'[process binary files as if they were text]' \
'(-i --ignore-case)'{-i,--ignore-case}'[ignore case when matching]' \
'-I[do not match pattern in binary files]' \
'--max-depth=[descend at most given levels of directories]:__git_guard_number depth' \
'(-w --word-regexp)'{-w,--word-regexp}'[match only whole words]' \
'(-v --invert-match)'{-v,--invert-match}'[select non-matching lines]' \
'( -H)-h[supress output of filenames]' \
'(-h )-H[show filenames]' \
'--full-name[output paths relative to the project top directory]' \
'(-E --extended-regexp -G --basic-regexp)'{-E,--extended-regexp}'[use POSIX extended regexes]' \
'(-E --extended-regexp -G --basic-regexp)'{-G,--basic-regexp}'[use POSIX basic regexes]' \
'(-F --fixed-strings)'{-F,--fixed-strings}'[do not interpret pattern as a regex]' \
'-n[prefix the line number to matching lines]' \
'(-l --files-with-matches -L --files-without-match --name-only)'{-l,--files-with-matches,--name-only}'[show only names of matching files]' \
'(-l --files-with-matches -L --files-without-match)'{-L,--files-without-match}'[show only names of non-matching files]' \
'(--cached -O --open-files-in-pager)'{-O,--open-files-in-pager}'=-[open matching files in pager]::_path_commands' \
'(-z --null)'{-z,--null}'[output \0 after filenames]' \
'(-c --count)'{-c,--count}'[show number of matching lines in files]' \
'( --no-color)--color=-[color matches]:: :__git_color_whens' \
'(--color )---no-color[do not color matches]' \
'-A[show trailing context]: :__git_guard_number lines' \
'-B[show leading context]: :__git_guard_number lines' \
'-C[show context]: :__git_guard_number lines' \
'(-p --show-function)'{-p,--show-function}'[show preceding line containing function name of match]' \
'(1)*-f[read patterns from given file]:pattern file:_files' \
'(1)*-e[use the given pattern for matching]:pattern' \
$pattern_operators \
'--all-match[all patterns must match]' \
':pattern' \
'*:: :->tree-or-file' && ret=0
# TODO: If --cached, --no-index, -O, or --open-files-in-pager was given,
# dont complete treeishs.
case $state in
(tree-or-file)
integer first_tree last_tree start end
(( start = words[(I)(-f|-e)] > 0 ? 1 : 2 ))
(( end = $#line - 1 ))
for (( i = start; i <= end; i++ )); do
[[ line[i] == '--' ]] && break
__git_is_treeish $line[i] || break
if (( first_tree == 0 )); then
(( first_tree = last_tree = i ))
else
(( last_tree = i ))
fi
done
# TODO: Need to respect --cached and --no-index here.
if (( last_tree == 0 || last_tree == end )); then
if (( first_tree == 0 )); then
_alternative \
'treeishs::__git_tree_ishs' \
'files::__git_cached_files' && ret=0
else
_alternative \
'treeishs::__git_trees' \
"files::__git_tree_files ${PREFIX:-.} $line[first_tree,last_tree]" && ret=0
fi
else
if (( first_tree == 0 )); then
__git_cached_files && ret=0
else
__git_tree_files ${PREFIX:-.} $line[first_tree,last_tree] && ret=0
fi
fi
;;
esac
return ret
}
(( $+functions[_git-gui] )) ||
_git-gui () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C \
'--version[display version information]' \
': :->command' \
'*:: :->arg' && ret=0
case $state in
(command)
local -a commands
commands=(
blame:'start a blame viewer'
browser:'start a tree browser'
citool:'arrange to make one commit'
version:'display version information')
_describe -t commands command commands && ret=0
;;
(arg)
curcontext=${curcontext%:*}-$line[1]:
case $line[1] in
(blame)
_git-blame && ret=0
;;
(browser)
_arguments -C \
':: :__git_revisions' \
'*:: :->file' && ret=0
case $state in
(file)
__git_is_treeish $line[1] && __git_tree_files ${PREFIX:-.} $line[1] && ret=0
;;
esac
;;
(citool)
_git-citool && ret=0
;;
(version)
_nothing
;;
(*)
_nothing
;;
esac
;;
esac
return ret
}
(( $+functions[_git-init] )) ||
_git-init () {
_arguments -w -S -s \
'(-q --quiet)'{-q,--quiet}'[do not print any results to stdout]' \
'--bare[create a bare repository]' \
'--template=[directory to use as a template for the object database]: :_directories' \
'--shared=[share repository amongst several users]:: :__git_repository_permissions' \
':: :_directories'
}
(( $+functions[_git-log] )) ||
_git-log () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
local -a log_options revision_options diff_options
__git_setup_log_options
__git_setup_revision_options
__git_setup_diff_options
_arguments -w -C -s \
$log_options \
$revision_options \
$diff_options \
'(-)--[start file arguments]' \
'*:: :->commit-range-or-file' && ret=0
case $state in
(commit-range-or-file)
case $CURRENT in
(1)
if [[ -n ${opt_args[(I)--]} ]]; then
__git_cached_files && ret=0
else
_alternative \
'commit-ranges::__git_commit_ranges' \
'cached-files::__git_cached_files' && ret=0
fi
;;
(*)
# TODO: Write a wrapper function that checks whether we have a
# committish range or comittish and calls __git_tree_files
# appropriately.
if __git_is_committish_range $line[1]; then
__git_tree_files ${PREFIX:-.} $(__git_committish_range_last $line[1]) && ret=0
elif __git_is_committish $line[1]; then
__git_tree_files ${PREFIX:-.} $line[1] && ret=0
else
__git_cached_files && ret=0
fi
;;
esac
esac
return ret
}
(( $+functions[_git-merge] )) ||
_git-merge () {
local -a merge_options
__git_setup_merge_options
_arguments -w -S -s \
$merge_options \
'-m[set the commit message to be used for the merge commit]:merge message' \
'( --no-rerere-autoupdate)--rerere-autoupdate[allow the rerere mechanism to update the index]' \
'(--rerere-autoupdate )--no-rerere-autoupdate[do not allow the rerere mechanism to update the index]' \
'*: :__git_commits'
}
(( $+functions[_git-mv] )) ||
_git-mv () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -w -C -S -s \
'(-f --force)'{-f,--force}'[rename/move even if targets exist]' \
'-k[skip rename/move that would lead to errors]' \
'(-n --dry-run)'{-n,--dry-run}'[only show what would happen]' \
':source:__git_cached_files' \
'*:: :->source-or-destination' && ret=0
case $state in
(source-or-destination)
_alternative \
'cached-files:source:__git_cached_files' \
'directories:destination directory:_directories' && ret=0
;;
esac
return ret
}
(( $+functions[_git-notes] )) ||
_git-notes () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C \
'--ref=[manipulate the notes tree in given ref]: :__git_notes_refs' \
': :->command' \
'*:: :->option-or-argument' && ret=0
case $state in
(command)
local -a commands
commands=(
list:'list notes object for given object'
add:'add notes for a given object'
copy:'copy notes from one object to another'
append:'append notes to a given object'
edit:'edit notes for a given object'
show:'show notes for a given object'
remove:'remove notes for a given object'
prune:'remove all notes for non-existing/unreachable objects')
_describe -t commands command commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*}-$line[1]:
case $line[1] in
(list|show|edit|remove)
_arguments \
': :__git_commits' && ret=0
;;
(add)
# TODO: Only complete commits that dont have notes already, unless
# -f or --force has been given.
_arguments -w -S -s \
'*'{-m,--message=}'[use given note message]:message' \
'*'{-F,--file=}'[take note message from given file]:note message file:_files' \
'(-C --reuse-message)'{-C,--reuse-message=}'[take note message from given blob object]: :__git_blobs' \
'(-c --reedit-message)'{-c,--reedit-message=}'[take note message from given blob object and edit it]: :__git_blobs' \
'(-f --force)'{-f,--force}'[overwrite existing note]' \
': :__git_commits' && ret=0
;;
(copy)
# TODO: --for-rewrite is undocumented.
_arguments -w -S -s \
'(-f --force)'{-f,--force}'[replace existing note]' \
'(:)--stdin[read objects from stdin]' \
'(:--stdin)--for-rewrite=[load rewriting config for given command]:command:(amend rebase)' \
': :__git_commits' \
': :__git_commits' && ret=0
;;
(append)
_arguments -w -S -s \
'*'{-m,--message=}'[use given note message]:message' \
'*'{-F,--file=}'[take note message from given file]:note message file:_files' \
'(-C --reuse-message)'{-C,--reuse-message=}'[take note message from given blob object]: :__git_blobs' \
'(-c --reedit-message)'{-c,--reedit-message=}'[take note message from given blob object and edit it]: :__git_blobs' \
': :__git_commits' && ret=0
;;
(*)
_nothing
;;
esac
;;
esac
return ret
}
(( $+functions[_git-pull] )) ||
_git-pull () {
local -a merge_options fetch_options
__git_setup_merge_options
__git_setup_fetch_options
_arguments \
$merge_options \
'( --no-rebase)--rebase[perform a rebase after fetching]' \
'(--rebase )--no-rebase[do not perform a rebase after fetching]' \
$fetch_options \
': :__git_any_repositories' \
'*: :__git_ref_specs'
}
(( $+functions[_git-push] )) ||
_git-push () {
# NOTE: For --receive-pack we use _files to complete, even though this will
# only complete files on the local end, not the remote end. Still, it may be
# helpful to get some sort of completion going, perhaps modifying the path
# later on to match the remote end.
_arguments -w -S -s \
'--all[push all refs under refs/heads/]' \
'--mirror[push all refs under refs/heads/ and refs/tags/ and delete non-existing refs]' \
'(-n --dry-run)'{-n,--dry-run}'[do everything except actually send the updates]' \
'--porcelain[produce machine-readable output]' \
'--delete[delete all listed refs from the remote repository]' \
'--tags[all tags under refs/tags are pushed]' \
'(--receive-pack --exec)'{--receive-pack=-,--exec=-}'[path to git-receive-pack on remote]:remote git-receive-pack:_files' \
'(-f --force)'{-f,--force}'[allow refs that are not ancestors to be updated]' \
'(:)--repo=[default repository to use]:repository:__git_any_repositories' \
'(-u --set-upstream)'{-u,--set-upstream}'[add upstream reference for each branch that is up to date or pushed]' \
'( --no-thin)--thin[try to minimize number of objects to be sent]' \
'(--thin )--no-thin[do not try to minimize number of objects to be sent]' \
'(-q --quiet -v --verbose --progress)'{-q,--quiet}'[suppress all output]' \
'(-q --quiet -v --verbose)'{-v,--verbose}'[output additional information]' \
'(-q --quiet)--progress[output progress information]' \
':: :__git_any_repositories' \
'*: :__git_ref_specs'
}
(( $+functions[_git-rebase] )) ||
_git-rebase () {
local -a autosquash_opts
if (( words[(I)--interactive] )); then
autosquash_opts=(
'( --no-autosquash)--autosquash[check for auto-squash boundaries]'
'(--autosquash )--no-autosquash[do not check for auto-squash boundaries]')
fi
_arguments -A '-*' \
'(- :)--continue[continue after resolving merge conflict]' \
'(- :)--abort[abort current rebase]' \
'(- :)--skip[skip the current patch]' \
'(-m --merge)'{-m,--merge}'[use merging strategies to rebase]' \
'*'{-s,--strategy=}'[use given merge strategy]:merge strategy:__git_merge_strategies' \
'*'{-X,--strategy-option=}'[pass merge-strategy-specific option to merge strategy]' \
'(-q --quiet -v --verbose --stat -n --no-stat)'{-q,--quiet}'[suppress all output]' \
'(-q --quiet -v --verbose --stat -n --no-stat)'{-v,--verbose}'[output additional information]' \
'--no-verify[bypass the pre-rebase hook]' \
'-C-[ensure that given lines of surrounding context match]: :__git_guard_number "lines of context"' \
'(-f --force-rebase)'{-f,--force-rebase}'[force rebase even if current branch descends from commit rebasing onto]' \
'(-i --interactive)--ignore-whitespace[ignore whitespace in context]' \
'(-i --interactive)--whitespace=-[detect a new or modified line that has whitespace errors]: :__git_apply_whitespace_strategies' \
'(-i --interactive)--committer-date-is-author-date[use author date as committer date]' \
'(-i --interactive --ignore-whitespace --whitespace --committer-date-is-author-date)'{-i,--interactive}'[make a list of commits to be rebased and open in $EDITOR]' \
'(-p --preserve-merges --interactive)'{-p,--preserve-merges}'[try to recreate merges instead of ignoring them]' \
'(1)--root[rebase all reachable commits]' \
$autosquash_opts \
'--no-ff[cherry-pick all rebased commits with --interactive, otherwise synonymous to --force-rebase]' \
'--onto[start new branch with HEAD equal to given revision]:newbase:__git_revisions' \
':upstream branch:__git_revisions' \
'::working branch:__git_branch_names'
}
(( $+functions[_git-reset] )) ||
_git-reset () {
local curcontext=$curcontext state line ret=1
typeset -A opt_args
_arguments -w -C -s \
'( --mixed --hard --merge --keep -p --patch -- *)--soft[do not touch the index file nor the working tree]' \
'(--soft --hard --merge --keep -p --patch -- *)--mixed[reset the index but not the working tree (default)]' \
'(--soft --mixed --merge --keep -p --patch -- *)--hard[match the working tree and index to the given tree]' \
'(--soft --mixed --hard --keep -p --patch -- *)--merge[reset out of a conflicted merge]' \
'(--soft --mixed --hard --merge -p --patch -- *)--keep[like --hard, but keep local working tree changes]' \
'(-p --patch)'{-p,--patch}'[select diff hunks to remove from the index]' \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'(- 1)--[start file arguments]' \
'(--soft --mixed --hard --merge --keep):: :__git_commits' \
'(--soft --mixed --hard --merge --keep)*:: :->file' && ret=0
case $state in
(file)
local commit=HEAD
if [[ -n $line[1] ]] && __git_is_committish $line[1]; then
commit=$line[1]
fi
__git_tree_files ${PREFIX:-.} $commit && ret=0
;;
esac
return ret
}
(( $+functions[_git-revert] )) ||
_git-revert () {
_arguments -w -S -s \
'(-e --edit --no-edit)'{-e,--edit}'[edit the commit before committing the revert]' \
'(-m --mainline)'{-m+,--mainline=}'[pick which parent is mainline]:parent number' \
'(-e --edit)--no-edit[do not edit the commit message]' \
'(-n --no-commit)'{-n,--no-commit}'[do not commit the reversion]' \
'(-s --signoff)'{-s,--signoff}'[add Signed-off-by line at the end of the commit message]' \
': :__git_commits'
}
(( $+functions[_git-rm] )) ||
_git-rm () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -w -C -S -s \
'(-f --force)'{-f,--force}'[override the up-to-date check]' \
'(-n --dry-run)'{-n,--dry-run}'[do not actually remove the files, just show if they exist in the index]' \
'-r[allow recursive removal when a leading directory-name is given]' \
'--cached[only remove files from the index]' \
'--ignore-unmatch[exit with 0 status even if no files matched]' \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'*:: :->file' && ret=0
case $state in
(file)
if [[ -n ${opt_args[(I)--cached]} ]]; then
__git_changed-in-index_files && ret=0
else
__git_cached_files && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-shortlog] )) ||
_git-shortlog () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
local -a revision_options
__git_setup_revision_options
# TODO: should take all arguments found in setup_revisions() (probably more
# or less what git-rev-list takes).
_arguments -w -C -S -s \
'(: -)'{-h,--help}'[print a short usage message and exit]' \
'(-n --numbered)'{-n,--numbered}'[sort according to number of commits]' \
'(-s --summary)'{-s,--summary}'[suppress commit description]' \
'(-e --email)'{-e,--email}'[show email addres of each author]' \
'-w-[linewrap the output]:: :->wrap' \
$revision_options \
'*: :__git_commits' && ret=0
case $state in
(wrap)
if [[ -prefix [[:digit:]]#,[[:digit:]]#,[[:digit:]]# ]]; then
compset -P '[[:digit:]]#,[[:digit:]]#,'
__git_guard_number 'indent of second and subsquent wrapped lines'
elif [[ -prefix [[:digit:]]#,[[:digit:]]# ]]; then
compset -P '[[:digit:]]#,'
compset -S ',[[:digit:]]#'
__git_guard_number 'indent of first wrapped line'
else
compset -S ',[[:digit:]]#,[[:digit:]]#'
__git_guard_number 'line width'
fi
;;
esac
return ret
}
(( $+functions[_git-show] )) ||
_git-show () {
local curcontext=$curcontext state line ret=1
typeset -A opt_args
local -a log_options revision_options
__git_setup_log_options
__git_setup_revision_options
_arguments -w -C -s \
$log_options \
$revision_options \
'*:: :->object' && ret=0
case $state in
(object)
_alternative \
'commits::__git_commits' \
'tags::__git_tags' \
'trees::__git_trees' \
'blobs::__git_blobs' && ret=0
;;
esac
return ret
}
(( $+functions[_git-stash] )) ||
_git-stash () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C \
': :->command' \
'*:: :->option-or-argument' && ret=0
case $state in
(command)
local -a commands
commands=(
save:'save your local modifications to a new stash'
list:'list the stashes that you currently have'
show:'show the changes recorded in the stash as a diff'
pop:'remove and apply a single stashed state from the stash list'
apply:'apply the changes recorded in the stash'
branch:'branch off at the commit at which the stash was originally created'
clear:'remove all the stashed states'
drop:'remove a single stashed state from the stash list'
create:'create a stash without storing it in the ref namespace')
_describe -t commands command commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*}-$line[1]:
case $line[1] in
(save)
_arguments -S \
'(--keep-index)--patch[interactively select hunks from diff between HEAD and working tree to stash]' \
'( --no-keep-index)--keep-index[all changes already added to the index are left intact]' \
'(--keep-index )--no-keep-index[all changes already added to the index are undone]' \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'::message' && ret=0
;;
(list)
local -a log_options revision_options
__git_setup_log_options
__git_setup_revision_options
_arguments -s -w \
$log_options \
$revision_options && ret=0
;;
(show)
local diff_options
__git_setup_diff_options
_arguments -S -s -w \
$diff_options \
':: :__git_stashes' && ret=0
;;
(pop|apply)
_arguments \
'--index[try to reinstate the changes added to the index as well]' \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
':: :__git_stashes' && ret=0
;;
(branch)
_arguments \
': :__git_guard_branch-name' \
':: :__git_stashes' && ret=0
;;
(clear)
_nothing
;;
(drop)
_arguments \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
':: :__git_stashes' && ret=0
;;
(create)
_nothing
;;
(*)
_nothing
;;
esac
;;
esac
return ret
}
(( $+functions[_git-status] )) ||
_git-status () {
local -a branch_opts
if (( $words[(I)-s|--short] )); then
branch_opts=('(-b --branch)'{-b,--branch}'[show branch and tracking info]')
fi
_arguments -w -S -s \
'(-s --short)'{-s,--short}'[output in short format]' \
$branch_opts \
'(-s --short)--porcelain[produce machine-readable output]' \
'(-u --untracked-files)'{-u-,--untracked-files=-}'[show untracked files]::mode:((no\:"show no untracked files" \
normal\:"show untracked files and directories" \
all\:"also show untracked files in untracked directories (default)"))' \
'--ignore-submodules[ignore changes to submodules]:: :__git_ignore_submodules_whens' \
'(--porcelain)-z[use NUL termination on output]' \
'*: :__git_ignore_line_inside_arguments _files'
}
(( $+functions[_git-submodule] )) ||
_git-submodule () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C -A '-*' \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
': :->command' \
'*:: :->option-or-argument' && ret=0
case $state in
(command)
declare -a commands
commands=(
add:'add given repository as a submodule'
status:'show the status of a submodule'
init:'initialize a submodule'
update:'update a submodule'
summary:'show commit summary between given commit and working tree/index'
foreach:'evaluate shell command in each checked-out submodule'
sync:'synchronize submodule settings')
_describe -t commands command commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*}-$line[1]:
case $line[1] in
(add)
# TODO: Second argument should only complete relative paths inside
# the current repository.
_arguments -S \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'(-b --branch)'{-b,--branch}'[branch of repository to add as submodule]' \
'(-f --force)'{-f,--force}'[allow adding an otherwise ignored submodule path]' \
'--reference=[remote repository to clone]: :__git_any_repositories' \
': :__git_any_repositories' \
':: :_directories' && ret=0
;;
(status)
_arguments -S \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'--cached[use commit stored in the index]' \
'--recursive[traverse submodules recursively]' \
'*: :__git_ignore_line_inside_arguments __git_submodules' && ret=0
;;
(init)
_arguments -S \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'*: :__git_ignore_line_inside_arguments __git_submodules' && ret=0
;;
(update)
# TODO: --init not properly documented.
_arguments -S \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'(-N --no-fetch)'{-N,--no-fetch}'[do not fetch new objects from repository]' \
'--merge[merge commit recorded in superproject into current branch of submodule]' \
'--rebase[rebase current branch onto commit recorded in superproject]' \
'--reference=[remote repository to clone]: :__git_any_repositories' \
'--recursive[traverse submodules recursively]' \
'--init[initialize uninitialized submodules]' \
'*: :__git_ignore_line_inside_arguments __git_submodules' && ret=0
;;
(summary)
_arguments -C -A '-*' \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'--cached[use commit stored in the index]' \
'--files[compare commit in index with submodule HEAD commit]' \
'(-n --summary-limit)'{-n,--summary-limit}'[limit summary size]: :__git_guard_number "limit"' \
'(-)--[start submodule arguments]' \
'*:: :->commit-or-submodule' && ret=0
case $state in
(commit-or-submodule)
if (( CURRENT == 1 )) && [[ -z ${opt_args[(I)--]} ]]; then
_alternative \
'commits::__git_commits' \
'submodules::__git_submodules' && ret=0
else
__git_ignore_line __git_submodules && ret=0
fi
;;
esac
;;
(foreach)
_arguments -S \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'--recursive[traverse submodules recursively]' \
'(-):command: _command_names -e' \
'*::arguments: _normal' && ret=0
;;
(sync)
_arguments -S \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'*: :__git_ignore_line_inside_arguments __git_submodules' && ret=0
;;
(*)
_nothing
;;
esac
;;
esac
return ret
}
(( $+functions[_git-tag] )) ||
_git-tag () {
local -a message_opts
if (( words[(I)-[asu]] )); then
message_opts=(
'( -F)-m+[specify tag message]:message'
'(-m )-F+[read tag message from given file]:message file:_files')
fi
_arguments -A '-*' \
- creation \
'( -s -u)-a[create an unsigned, annotated tag]' \
'(-a -u)-s[create an signed and annotated tag]' \
'(-a -s )-u[create a tag, annotated and signed with the given key]: :__git_gpg_secret_keys' \
'-f[replace existing tag]' \
$message_opts \
': :__git_tags' \
':: :__git_commits' \
- deletion \
'-d[delete tags]' \
'*:: :__git_ignore_line_inside_arguments __git_tags' \
- listing \
'-n+[limit line output of annotation]: :__git_guard_number "limit"' \
'-l[list tags matching pattern]' \
'--contains=[only list tags which contain the specified commit]: :__git_commits' \
'::pattern' \
- verification \
'-v[verifies gpg signutare of tags]' \
'*:: :__git_ignore_line_inside_arguments __git_tags'
}
(( $+functions[_gitk] )) ||
_gitk () {
_git-log
}
(( $+functions[_tig] )) ||
_tig () {
_git-log
}
# Ancillary Commands (Manipulators)
(( $+functions[_git-config] )) ||
_git-config () {
local name_arg value_arg
local curcontext=$curcontext state line ret=1
declare -A opt_args
if (( words[(I)--get-regexp] )); then
name_arg=':name regex'
elif (( words[(I)--get-colorbool] )); then
name_arg=':: :->is-a-tty'
elif (( words[(I)--get-color] )); then
name_arg='::default'
elif (( words[(I)--remove-section|--rename-section] )); then
name_arg=': :->section'
elif (( words[(I)--get|--get-all] )); then
name_arg=': :->gettable-option'
else
name_arg=': :->option'
fi
if (( words[(I)--rename-section] )); then
value_arg=': :->section'
else
value_arg=': :->value'
fi
# TODO --local is undocumented.
_arguments -w -C -S -s \
'( --system --local -f --file)--global[use user-global config file]' \
'(--global --local -f --file)--system[use system-wide config file]' \
'(--global --system -f --file)--local[use local config file]' \
'(--global --system -f --file)'{-f+,--file=}'[use given config file]:config file:_files' \
'( --int --bool-or-int --path)--bool[setting is a boolean]' \
'(--bool --bool-or-int --path)--int[setting is an integer]' \
'(--bool --int --path)--bool-or-int[setting is an integer]' \
'(--bool --int --bool-or-int )--path[setting is a path]' \
'(-z --null)'{-z,--null}'[end values with NUL and newline between key and value]' \
$name_arg \
$value_arg \
'::value regex' \
- '(actions)' \
'(-z --null)--replace-all[replace all values of the given key]' \
'(3 -z --null)--add[add new value without altering any existing ones]' \
'(2)--get[get the first matching value of the key]' \
'(2)--get-all[get all matching values of the key]' \
'(3 --bool --int --bool-or-int --path -z --null)--remove-section[remove the given section]' \
'(3 --bool --int --bool-or-int --path -z --null)--rename-section[rename the given section]' \
'(2 --bool --int --bool-or-int --path -z --null)--unset[remove the first matching value of the key]' \
'(2 --bool --int --bool-or-int --path -z --null)--unset-all[remove all matching values of the key]' \
'(: --bool --int --bool-or-int --path)'{-l,--list}'[list all variables set in config file]' \
'(2)--get-regexp[like "--get-all", but interpret "name" as a regular expression]' \
'(2 3 --bool --int --bool-or-int --path -z --null)--get-colorbool[check if color should be used]: :->gettable-colorbool-option' \
'(2 3 --bool --int --bool-or-int --path -z --null)--get-color[find color setting]: :->gettable-color-option' \
'(-e --edit --bool --int --bool-or-int --path -z --null)'{-e,--edit}'[open config file for editing]' && ret=0
# TODO: Most all _path_commands should be able to take arguments and so on.
# How do we deal with that and how do we quote the whole argument to git
# config?
# TODO: Add merge.*.(name|driver|recursive) and diff.*.(command|funcname)
# (see gitattributes(5)).
# TODO: .path options should take absolute paths.
declare -a git_options_static
git_options_static=(
advice.pushNonFastForward:'show advice when git push refuses non-fast-forward refs::->bool:true'
advice.statusHints:'show advice in output of git status::->bool:true'
advice.commitBeforeMerge:'show advice when git merge refuses to merge::->bool:true'
advice.resolveConflict:'show advice when conflict prevents operation from being performed::->bool:true'
advice.implicitIdentity:'show advice when identity is guessed from system settings::->bool:true'
advice.detachedHead:'show advice when entering detached-HEAD state::->bool:true'
blame.blankboundary:'show blank SHA-1 for boundary commits::->bool:false'
blame.showroot:'show root commits as normal commits::->bool:false'
blame.date:'date format to use in output::__git_date_formats:iso'
core.fileMode:'track changes to the executable bit of files::->bool:true'
core.ignoreCygwinFSTricks:'use Cygwin stat()/lstat()::->bool:true'
core.ignorecase:'use workarounds for non-case-sensitive filesystems::->bool:false'
core.trustctime:'trust inode change time::->bool:true'
core.quotepath:'escape characters in paths on output::->bool:false'
core.eol:'line ending type::->core.eol:native'
core.safecrlf:'verify that CRLF conversion is reversible::->core.safecrlf:false'
core.autocrlf:'convert CRLFs to and from system specific::->core.autocrlf:false'
core.symlinks:'create symbolic links for indexed symbolic links upon creation::->bool:true'
core.gitProxy:'command to execute to establish a connection to remote server:proxy command:_path_commands'
core.ignoreStat:'ignore modification times of files::->bool:false'
core.preferSymlinkRefs:'use symbolic links for symbolic-reference files::->bool:false'
core.bare:'use a repository without a working tree::->bool:false'
core.worktree:'path to the root of the work tree:work tree:_directories'
core.logAllRefUpdates:'log updates of references::->bool:true'
core.repositoryFormatVersion:'internal variable determining the repository version:version:->string'
core.sharedRepository:'what kind of sharing is done for this repository::->permission:false'
core.warnAmbiguousRefs:'warn if a ref name is ambiguous::->bool:true'
core.compression:'level of compression to apply to packs::->compression:-1'
core.loosecompression:'level of compression to apply to non-pack files::->compression:1'
core.packedGitWindowSize:'size of mappings of pack files:pack window size:->bytes'
core.packedGitLimit:'maximum number of bytes to map from pack files:maximum pack file map size:->bytes'
core.deltaBaseCacheLimit:'maximum size of cache for base objects:maximum base objects cache size:->bytes:16m'
core.bigFileThreshold:'maximum size of files to compress:maximum compress size:->bytes:512m'
core.excludesfile:'additional file to use for exclusion:excludes file:_files'
core.askpass:'program to use for asking for passwords:password command:_path_commands'
core.editor:'editor to use for editing messages:editor:_path_commands'
core.pager:'pager to use for paginating output:pager:_path_commands'
core.whitespace:'list of common whitespace problems to notice::->core.whitespace'
core.fsyncobjectfiles:'fsync() when writing object files::->bool:false'
core.preloadindex:'use parallel index preload for operations like git diff::->bool:false'
core.createObject:'take steps to prevent overwriting existing objects::->core.createObject:link'
core.notesRef:'show notes in given refs:refs:->string:refs/notes/commits'
core.sparseCheckout:'use sparse checkout::->bool:false'
add.ignore-errors:'ignore indexing errors when adding files::->bool:false'
am.keepcr:'keep CR characters when splitting mails::->bool:false'
apply.ignorewhitespace:'ignore whitespace changes::->apply.ignorewhitespace:no'
apply.whitespace:'default value for the --whitespace option::->apply.whitespace:error'
branch.autosetupmerge:'set up new branches for git pull::->bool:true'
branch.autosetuprebase:'rebase new branches of merge for autosetupmerge::->branch.autosetuprebase:never'
'branch.*.remote:what remote git fetch and git push should fetch form/push to::__git_remotes'
'branch.*.merge:default refspec to be marked for merging::__git_ref_specs'
'branch.*.mergeoptions:default options for merging::->branch.mergeoptions'
'branch.*.rebase:rebase on top of fetched branch::->bool:false'
'browser.*.cmd:browser command to use:browser:_path_commands'
'browser.*.path:path to use for the browser:absolute browser path:_files -g "*(*)"'
clean.requireForce:'require --force for git clean to actually do something::->bool:true'
color.branch:'color output of git branch::->color-bool'
color.branch.current:'color of the current branch::->color'
color.branch.local:'color of a local branch::->color'
color.branch.remote:'color of a remote branch::->color'
color.branch.plain:'color of other branches::->color'
color.diff:'color output of git diff::->color-bool'
color.diff.plain:'color of context text::->color'
color.diff.meta:'color of meta-information::->color'
color.diff.frag:'color of hunk headers::->color'
color.diff.func:'color of function in hunk header::->color'
color.diff.old:'color of removed lines::->color'
color.diff.new:'color of added lines::->color'
color.diff.commit:'color of commit headers::->color'
color.diff.whitespace:'color of whitespace errors::->color'
color.decorate.branch:'color of branches::->color'
color.decorate.remoteBranch:'color of remote branches::->color'
color.decorate.tag:'color of tags::->color'
color.decorate.stash:'color of stashes::->color'
color.decorate.HEAD:'color of HEAD::->color'
color.grep:'whether or not to color output of git grep::->color-bool'
color.grep.context:'color of non-matching text in context lines::->color'
color.grep.filename:'color of filename prefix::->color'
color.grep.function:'color of function name lines::->color'
color.grep.linenumber:'color of line number prefix::->color'
color.grep.match:'color of matching text::->color'
color.grep.selected:'color of non-matching text in selected lines::->color'
color.grep.separator:'color of separators between fields in a line::->color'
color.interactive:'whether or not to color in interactive mode::->color-bool'
color.interactive.prompt:'color of prompt::->color'
color.interactive.header:'color of header::->color'
color.interactive.help:'color of help::->color'
color.interactive.error:'color of error::->color'
color.pager:'feed colored output to pager::->bool:true'
color.showbranch:'color output of git show-branch::->color-bool'
color.status:'color output of git status::->color-bool'
color.status.header:'color of header text::->color'
color.status.added:'color of added, but not yet committed, files::->color'
color.status.updated:'color of updated, but not yet committed, files::->color'
color.status.changed:'color of changed, but not yet added in the index, files::->color'
color.status.untracked:'color of files not currently being tracked::->color'
color.status.nobranch:'color of no-branch warning::->color'
color.ui:'color output of capable git commands::->color-bool'
commit.status:'include status information in commit message template::->bool:true'
commit.template:'template file for commit messages:template:_files'
diff.autorefreshindex:'run git update-index --refresh before git diff::->bool:true'
diff.external:'command to generate diff with:diff command:_path_commands'
diff.mnemonicprefix:'use mnemonic source and destination prefixes::->bool:false'
diff.noprefix:'strip source and destination prefixes::->bool:false'
diff.renameLimit:'number of files to consider when detecting copy/renames:rename limit:->int'
diff.renames:'try to detect renames::->diff.renames:true'
diff.ignoreSubmodules:'ignore submodules::->bool:false'
diff.suppressBlankEmpty:'inbihit printing space before empty output lines::->bool:false'
diff.tool:'diff tool to use::__git_difftools'
'difftool.*.cmd:command to invoke for the diff tool::_path_commands'
'difftool.*.path:path to use for the diff tool:absolute diff tool path:_files -g "*(*)"'
difftool.prompt:'prompt before each invocation of the diff tool::->bool:true'
diff.wordRegex:'regex used to determine what a word is when performing word-by-word diff:regex:->string'
diff.guitool:'diff tool with gui to use::__git_difftools'
fetch.unpackLimit:'maximum number of objects to unpack when fetching:unpack limit:->int'
format.attach:'use multipart/mixed attachments::->bool:false'
format.numbered:'use sequence numbers in patch subjects::->format.numbered:auto'
format.headers:'additional email headers to include in email patches:headers:->string'
format.to:'additional email recipients of patches::->string'
format.cc:'additional carbon-copy email recipients of patches:recipients:->string'
format.subjectprefix:'prefix to use for subjects:prefix:->string'
format.signature:'signature to use:signature:->string'
format.suffix:'default suffix for output files from git-format-patch:suffix:->string'
format.pretty:'pretty format for log/show/whatchanged:format:->string'
format.thread:'threading style to use::->format.thread:false'
format.signoff:'enable --signoff by default::->bool:false'
'gc.*.reflogexpire:grace period for git reflog expire::->days:90'
'gc.*.reflogexpireunreachable:grace period for git reflog expire for unreachable entries::->days:30'
gc.aggressiveWindow:'window size used in delta compression algorithm:->int:250'
gc.auto:'minimum limit for packing loose objects with --auto::->int:6700'
gc.autopacklimit:'minimum limit for packing packs with --auto::->int:50'
gc.packrefs:'allow git gc to run git pack-refs::->gc.packrefs:true'
gc.pruneexpire:'grace period for pruning::->days+now'
gc.reflogexpire:'grace period for git reflog expire::->days:90'
gc.reflogexpireunreachable:'grace period for git reflog expire for unreachable entries::->days:30'
gc.rerereresolved:'number of days to keep records of resolved merges::->days:60'
gc.rerereunresolved:'number of days to keep records of unresolved merges::->days:15'
gitcvs.commitmsgannotation:'string to append to each commit message::->string'
gitcvs.enabled:'enable the cvs server interface::->bool:false'
gitcvs.logfile:'name of log file for cvs pserver:log file:_files'
gitcvs.dbname:'name of database to use:database name:->string'
gitcvs.dbdriver:'name of DBI driver to use::->gitcvs.dbdriver:SQLite'
gitcvs.dbuser:'username to connect to database as:database user:_users'
gitcvs.dbpass:'password to use when connecting to database:password:->string'
gitcvs.dbTableNamePrefix:'database table name prefix:prefix:->string'
'gitcvs.*.commitmsgannotation:string to append to each commit message:annotation:->string'
'gitcvs.*.enabled:enable the cvs server interface::->bool:false'
'gitcvs.*.logfile:name of log file for cvs pserver:log file:_files'
'gitcvs.*.dbname:name of database to use:database name:->string'
'gitcvs.*.dbdriver:name of DBI driver to use:DBI driver:->string'
'gitcvs.*.dbuser:username to connect to database as::_users'
'gitcvs.*.dbpass:password to use when connecting to database:password:->string'
'gitcvs.*.dbTableNamePrefix:database table name prefix:prefix:->string'
gitcvs.usecrlfattr:'use end-of-line conversion attributes::->bool:false'
gitcvs.allbinary:'treat all files from CVS as binary::->bool:false'
gui.commitmsgwidth:'width of commit message window:width:->int:75'
gui.diffcontext:'number of context lines used in diff window:context:->int:5'
gui.encoding:'encoding to use for displaying file contents::->encoding'
gui.matchtrackingbranch:'create branches that track remote branches::->bool:false'
gui.newbranchtemplate:'suggested name for new branches:template:->string'
gui.pruneduringfetch:'prune tracking branches when performing a fetch::->bool:false'
gui.trustmtime:'trust file modification timestamp::->bool:false'
gui.spellingdictionary:'dictionary to use for spell checking commit messages:dictionary:_files'
gui.fastcopyblame:'try harder during blame detection::->bool:false'
gui.copyblamethreshold:'threshold to use in blame location detection:threshold:->string'
gui.blamehistoryctx:'specify radius of history context in days for selected commit::->days'
guitool.cmd:'shell command line to execute::_path_commands'
guitool.needsfile:'require that a diff is selected for command to be available::->bool:false'
guitool.noconsole:'suppress command output::->bool:false'
guitool.norescan:'skip rescanning for changes to the working directory::->bool:false'
guitool.confirm:'show a confirmation dialog::->bool:false'
guitool.argprompt:'prompt for arguments:argument prompt:->string'
guitool.revprompt:'prompt for a single revision:revision prompt:->string'
guitool.revunmerged:'show only unmerged branches in revprompt::->bool:false'
guitool.title:'title of prompt dialog:prompt title:->string'
guitool.prompt:'prompt to display:prompt:->string'
help.browser:'browser used to display help in web format::__git_browsers'
help.format:'default help format used by git help::->help.format'
help.autocorrect:'execute corrected mistyped commands::->bool:false'
http.proxy:'HTTP proxy to use:proxy:_urls'
http.sslVerify:'verify the SSL certificate for HTTPS::->bool:true'
http.sslCert:'file containing SSL certificates for HTTPS:SSL certificate file:_files'
http.sslKey:'file containing the SSL private key for HTTPS:SSL private key file:_files'
http.sslCertPasswordProtected:'prompt for a password for the SSL certificate::->bool:false'
http.sslCAInfo:'file containing CA certificates to verify against for HTTPS:CA certificates file:_files'
http.sslCAPath:'directory containing files with CA certificates to verify against for HTTPS:CA certificates directory:_directories'
http.maxRequests:'how many HTTP requests to launch in parallel:maximum number of requests:->int:5'
http.minSessions:'number of curl sessions to keep across requests:mininmum number of sessions:->int:1'
http.postBuffer:'maximum size of buffer used by smart HTTP transport when POSTing:maximum POST buffer size:->bytes:1m'
http.lowSpeedLimit:'lower limit for HTTP transfer-speed:low transfer-speed limit:->int'
http.lowSpeedTime:'duration for http.lowSpeedLimit:time:->int'
http.noEPSV:'disable the use of the EPSV ftp-command::->bool:false'
http.useragent:'user agent presented to HTTP server:user agent string:->string'
http.getanyfile:'allow clients to read any file within repository::->bool:true'
http.uploadpack:'serve git fetch-pack and git ls-remote clients::->bool:true'
http.receivepack:'serve git send-pack clients::->bool:true'
i18n.commitEncoding:'character encoding commit messages are stored in::->encoding'
i18n.logOutputEncoding:'character encoding commit messages are output in::->encoding'
imap.folder:'IMAP folder to use with git imap-send:IMAP folder name::_mailboxes'
imap.tunnel:'tunneling command to use for git imap-send:tunnel command:_path_commands'
imap.host:'host git imap-send should connect to::_hosts'
# TODO: If imap.host is set, complete users on that system.
imap.user:'user git imap-send should log in as::_users'
imap.pass:'password git imap-send should use when logging in:password:->string'
imap.port:'port git imap-send should connect on::_ports'
imap.sslverify:'verify server certificate::->bool:true'
imap.preformattedHTML:'use HTML encoding when sending a patch::->bool:false'
imap.authMethod:'authentication method used::->imap.authMethod'
init.templatedir:'directory from which templates are copied:template directory:_directories'
instaweb.browser:'browser to use when browsing with gitweb::__git_browsers'
instaweb.httpd:'HTTP-daemon command-line to execute for instaweb:daemon:_path_commands'
instaweb.local:'bind to 127.0.0.1::->bool:false'
instaweb.modulepath:'module path for the Apache HTTP-daemon for instaweb:module directory:_directories'
instaweb.port:'port to bind HTTP daemon to for instaweb::_ports'
interactive.singlekey:'accept one-letter input without Enter::->bool:false'
log.date:'default date-time mode::__git_date_formats'
log.decorate:'type of ref names to show::__git_log_decorate_formats'
log.showroot:'show initial commit as a diff against an empty tree::->bool:true'
mailinfo.scissors:'remove everything in body before a scissors line::->bool:false'
mailmap.file:'augmenting mailmap file:mailmap file:_files'
man.viewer:'man viewer to use for help in man format::__git_man_viewers'
'man.*.cmd:the command to invoke the specified man viewer:man command:_path_commands'
'man.*.path:path to use for the man viewer:absolute man tool path:_files -g "*(*)"'
merge.conflictstyle:'style used for conflicted hunks::->merge.conflictstyle:merge'
merge.log:'include summaries of merged commits in new merge commit messsages::->bool:false'
merge.renameLimit:'number of files to consider when detecting copy/renames during merge:limit:->int'
merge.renormalize:'use canonical representation of files during merge::->bool:false'
merge.stat:'print the diffstat between ORIG_HEAD and merge at end of merge::->bool:true'
merge.tool:'tool used by git mergetool during merges::__git_mergetools'
merge.verbosity:'amount of output shown by recursive merge strategy::->merge.verbosity:2'
'merge.*.name:human-readable name for custom low-level merge driver:name:->string'
'merge.*.driver:command that implements a custom low-level merge driver:merge command:_path_commands'
'merge.*.recursive:low-level merge driver to use when performing internal merge between common ancestors::__git_builtin_merge_drivers'
'mergetool.*.path:path to use for the merge tool:absolute merge tool path:_files -g "*(*)"'
'mergetool.*.cmd:command to invoke for the merge tool:merge command:_path_commands'
'mergetool.*.trustExitCode:trust the exit code of the merge tool::->bool:false'
mergetool.keepBackup:'keep the original file with conflict markers::->bool:true'
mergetool.keepTemporaries:'keep temporary files::->bool:false'
mergetool.prompt:'prompt before each invocation of the merge tool::->bool:true'
notes.displayRef:'refname to show notes from::->refname'
notes.rewrite.amend:'copy notes from original to rewritten commit when running git amend::->bool:true'
notes.rewrite.rebase:'copy notes from original to rewritten commit when running git rebase::->bool:true'
notes.rewriteMode:'what to do when target commit already has a not when rewriting::->notes.rewriteMode'
notes.rewriteRef:'refname to use when rewriting::->refname'
pack.window:'size of window:window size:->int:10'
pack.depth:'maximum delta depth:maximum delta depth:->int:50'
pack.windowMemory:'window size limit:maximum window size:->bytes:0'
pack.compression:'compression level::->compression:-1'
pack.deltaCacheSize:'maximum amount of memory for caching deltas:maximum delta cache size:->bytes:256m'
pack.deltaCacheLimit:'maximum size of deltas:maximum delta size:->int:1000'
pack.threads:'number of threads to use for searching for best delta matches:number of threads:->int'
pack.indexVersion:'default pack index version:index version:->string'
pack.packSizeLimit:'maximum size of packs:maximum size of packs:->bytes'
pull.octopus:'default merge strategy to use when pulling multiple branches::__git_merge_strategies'
pull.twohead:'default merge strategy to use when pulling a single branch::__git_merge_strategies'
push.default:'action git push should take if no refspec is given::->push.default'
rebase.stat:'show a diffstat of what changed upstream since last rebase::->bool:false'
rebase.autosquash:'autosquash by default::->bool:false'
receive.autogc:'run git gc --auto after receiving data::->bool:true'
receive.fsckObjects:'check all received objects::->bool:true'
receive.unpackLimit:'maximum number of objects received for unpacking into loose objects:unpack limit:->int'
receive.denyDeletes:'deny a ref update that deletes a ref::->bool:false'
receive.denyDeleteCurrent:'deny a ref update that deletes currently checked out branch::->bool:false'
receive.denyCurrentBranch:'deny a ref update of currently checked out branch::->receive.denyCurrentBranch'
receive.denyNonFastForwards:'deny a ref update that is not a fast-forward::->bool:false'
receive.updateserverinfo:'run git update-server-info after receiving data::->bool:false'
'remote.*.url:URL of a remote repository::__git_any_repositories'
'remote.*.pushurl:push URL of a remote repository::__git_any_repositories'
'remote.*.proxy:URL of proxy to use for a remote repository::_urls'
'remote.*.fetch:default set of refspecs for git fetch::__git_ref_specs'
'remote.*.push:default set of refspecs for git push::__git_ref_specs'
'remote.*.mirror:push with --mirror::->bool:false'
'remote.*.skipDefaultUpdate:skip this remote by default::->bool:false'
'remote.*.skipFetchAll:skip this remote by default::->bool:false'
'remote.*.receivepack:default program to execute on remote when pushing:git receive-pack command:_path_commands'
'remote.*.uploadpack:default program to execute on remote when fetching:git upload-pack command:_path_commands'
'remote.*.tagopt:options for retrieving remote tags::->remote.tagopt'
'remote.*.vcs:interact with the remote through git-remote helper:remote VCS:->string'
repack.usedeltabaseoffset:'use delta-base offsets::->bool:true'
rerere.autoupdate:'update index after resolution::->bool:false'
rerere.enabled:'record resolved conflicts::->bool'
sendemail.smtpencryption:'encryption method to use::->sendemail.smtpencryption'
sendemail.aliasesfile:'file containing email aliases:email aliases file:_files'
sendemail.aliasfiletype:'format of aliasesfile::->sendemail.aliasfiletype'
sendemail.bcc:'value of Bcc\: header::_email_addresses'
sendemail.cc:'value of Cc\: header::_email_addresses'
sendemail.cccmd:'command to generate Cc\: header with:Cc\: command:_path_commands'
sendemail.chainreplyto:'send each email as a reply to the previous one::->bool:false'
sendemail.confirm:'type of confirmation required before sending::->sendemail.confirm:auto'
sendemail.envelopesender:'envelope sender to send emails as::_email_addresses'
sendemail.from:'sender email address::_email_addresses'
sendemail.multiedit:'edit all files at once::->bool:false'
sendemail.signedoffbycc:'add Signed-off-by\: or Cc\: lines to Cc\: header::->bool:true'
sendemail.smtppass:'password to use for SMTP-AUTH:password:->string'
sendemail.suppresscc:'rules for suppressing Cc\:::->sendemail.suppresscc'
sendemail.suppressfrom:'add From\: address to the Cc\: list::->bool:false'
sendemail.to:'value of To\: header::_email_addresses'
sendemail.smtpdomain:'FQDN to use for HELO/EHLO commands to SMTP server:smtp domain:_domains'
sendemail.smtpserver:'SMTP server to connect to:smtp host:_hosts'
sendemail.smtpserverport:'port to connect to SMTP server on:smtp port:_ports'
sendemail.smtpuser:'user to use for SMTP-AUTH:smtp user:_users'
sendemail.thread:'set In-Reply-To\: and References\: headers::->bool:true'
sendemail.validate:'perform sanity checks on patches::->bool:true'
'sendemail.*.aliasesfile:file containing email aliases::_files'
'sendemail.*.aliasfiletype:format of aliasesfile::->sendemail.aliasfiletype'
'sendemail.*.bcc:value of Bcc\: header::_email_addresses'
'sendemail.*.cc:value of Cc\: header::_email_addresses'
'sendemail.*.cccmd:command to generate Cc\: header with:Cc\: command:_path_commands'
'sendemail.*.chainreplyto:send each email as a reply to the previous one::->bool:false'
'sendemail.*.confirm:type of confirmation required before sending::->sendemail.confirm:auto'
'sendemail.*.envelopesender:envelope sender to send emails as::_email_addresses'
'sendemail.*.from:sender email address::_email_addresses'
'sendemail.*.multiedit:edit all files at once::->bool:false'
'sendemail.*.signedoffbycc:add Signed-off-by\: or Cc\: lines to Cc\: header::->bool:true'
'sendemail.*.smtppass:password to use for SMTP-AUTH:password:->string'
'sendemail.*.suppresscc:rules for suppressing Cc\:::->sendemail.suppresscc'
'sendemail.*.suppressfrom:rules for suppressing From\:::->sendemail.suppressfrom'
'sendemail.*.to:value of To\: header::_email_addresses'
'sendemail.*.smtpdomain:FQDN to use for HELO/EHLO commands to SMTP server:smtp domain:_domains'
'sendemail.*.smtpserver:SMTP server to connect to:smtp host:_hosts'
'sendemail.*.smtpserverport:port to connect to SMTP server on:smtp port:_ports'
'sendemail.*.smtpuser:user to use for SMTP-AUTH:smtp user:_users'
'sendemail.*.thread:set In-Reply-To\: and References\: headers::->bool:true'
'sendemail.*.validate:perform sanity checks on patches::->bool:true'
sendemail.assume8bitEncoding:'encoding to use for non-ASCII messages::__git_encodings'
showbranch.default:'default set of branches for git show-branch::->branch'
status.relativePaths:'show paths relative to current directory::->bool:false'
status.showUntrackedFiles:'show untracked files::->status.showUntrackedFiles:normal'
status.submodulesummary:'include submodule summary::->bool:false'
'submodule.*.path:path within project:submodule directory:_directories -qS \:'
'submodule.*.url:URL to update from::__git_any_repositories'
'submodule.*.update:update strategy to use::->submodule.update'
'submodule.*.ignore:ignore modifications to submodules with git status and git diff-*::->submodule.ignore'
svn.noMetadata:'disable git-svn-id: lines at end of commits::->bool:false'
svn.useSvmProps:'use remappings of URLs and UUIDs from mirrors::->bool:false'
svn.useSvnsyncProps:'use remappings of URLs and UUIDs for the svnsync command::->bool:false'
svn.ignore-paths:'regular expression of paths to not check out:regular expression:->string'
svn.brokenSymlinkWorkaround:'apply the broken-symlink check::->bool:true'
svn.pathnameencoding:'encoding to recode pathnames into::->encoding'
svn.followparent:'follow parent commit::->bool:true'
svn.authorsFile:'default authors file:authors file:_files'
svn.quiet:'produce less output::->bool:false'
'svn-remote.*.noMetadata:disable git-svn-id: lines at end of commits::->bool:false'
'svn-remote.*.useSvmProps:use remappings of URLs and UUIDs from mirrors::->bool:false'
'svn-remote.*.useSvnsyncProps:use remappings of URLs and UUIDs for the svnsync command::->bool:false'
'svn-remote.*.rewriteRoot:alternate root URL to use:root url:_urls'
'svn-remote.*.rewriteUUID:remap URLs and UUIDs for mirrors manually::->bool:false'
'svn-remote.*.ignore-paths:regular expression of paths to not check out:regular expression:->string'
'svn-remote.*.url:URL to connect to::_urls'
'svn-remote.*.fetch:fetch specification::__git_ref_specs'
'svn-remote.*.branches:branch mappings:branch mapping:->string'
'svn-remote.*.tags:tag mappings:tag mapping:->string'
tar.umask:'umask to apply::->umask'
transfer.unpackLimit:'default value for fetch.unpackLimit and receive.unpackLimit:unpack limit:->int:100'
'url.*.insteadOf:string to start URLs with:prefix:->string'
'url.*.pushInsteadOf:string to start URLs to push to with:prefix:->string'
user.email:'email address used for commits::_email_addresses'
user.name:'full name used for commits:name:->string'
user.signingkey:'default GPG key to use when creating signed tags::__git_gpg_secret_keys'
web.browser:'web browser to use::__git_browsers')
case $state in
(section)
__git_config_sections -b '(|)' '^' section-names 'section name' $* && ret=0
;;
(is-a-tty)
declare -a values
values=(
true
false
auto)
_describe -t values 'stdout is a tty' values && ret=0
;;
(option)
local label=option
declare -a sections sections_and_options options
[[ -prefix *. ]] && label="${line[1]%.*} option"
if compset -P '[^.]##.*.'; then
declare -a match mbegin mend
options+=(${${${${(M)git_options_static:#(#i)${IPREFIX}[^.:]##:*}#(#i)${IPREFIX}}/#(#b)([^:]##:)([^\\:]#(\\?[^\\:]#)#:[^\\:]#(\\?[^\\:]#)#:->bool)/$match[1]whether or not to $match[2]}/#(#b)([^:]##:([^\\:]#(\\?[^\\:]#)#))*/$match[1]})
options+=(${${${${(M)git_options_static:#(#i)${IPREFIX%%.*}.\*.[^.:]##:*}#(#i)${IPREFIX%%.*}.\*.}/#(#b)([^:]##:)([^\\:]#(\\?[^\\:]#)#:[^\\:]#(\\?[^\\:]#)#:->bool)/$match[1]whether or not to $match[2]}/#(#b)([^:]##:([^\\:]#(\\?[^\\:]#)#))*/$match[1]})
declare -a labels
labels=(
'branch.*.:${${line[1]#branch.}%.*} branch option'
'browser.*.:${${line[1]#browser.}%.*} browser option'
'color.branch.:branch-specific color option'
'color.diff.:diff-specific color option'
'color.decorate.:git-log---decorate-specific color option'
'color.grep.:git-grep-specific color option'
'color.interactive.:interaction-specific color option'
'color.status.:git-status-specific color option'
'difftool.*.:${${line[1]#difftool.}%.*}-specific option'
'gc.*.:${${line[1]#gc.}%.*}-specific gc option'
'gitcvs.*.:gitcvs ${${line[1]#gitcvs.}%.*}-specific option'
'guitool.*.:${${line[1]#gc.}%.*}-specific option'
'man.*.:${${line[1]#man.}%.*}-specific man option'
'merge.*.:${${line[1]#merge.}%.*}-specific merge option'
'mergetool.*.:${${line[1]#mergetool.}%.*}-specific option'
'sendemail.*.:${${line[1]#sendemail.}%.*}-specific sendemail option'
'submodule.*.:${${line[1]#submodule.}%.*}-submodule-specific option'
'url.*.:${${line[1]#url.}%.*}-specific option'
'svn-remote.*.:git-svn ${${line[1]#svn-remote.}%.*}-specific option')
local found
found=${${${(M)labels:#(${IPREFIX}|${IPREFIX%%.*}.\*.):*}[1]}#*:}
[[ -n $found ]] && label=${(Q)"$(eval "print -rn -- $found")"}
elif compset -P '[^.]##.'; then
local opt
declare -a match mbegin mend
for opt in ${${${${(M)git_options_static:#(#i)${IPREFIX}[^.:]##:*}#(#i)${IPREFIX}}/#(#b)([^:]##:)([^\\:]#(\\?[^\\:]#)#:[^\\:]#(\\?[^\\:]#)#:->bool)/$match[1]whether or not to $match[2]}/#(#b)([^:]##:([^\\:]#(\\?[^\\:]#)#))*/$match[1]}; do
if (( ${git_options_static[(I)${opt%%:*}.*]} )); then
sections_and_options+=$opt
else
options+=$opt
fi
done
declare -a subsections
subsections=(
'color.decorate:git log --decorate options'
'gitcvs.ext:ext-connection-method-specific options'
'gitcvs.pserver:pserver-connection-method-specific options'
'notes.rewrite:commands to copy notes from original for when rewriting commits')
sections+=(${${(M)subsections:#${IPREFIX}[^.:]##(.|):*}#${IPREFIX}})
# TODO: Is it fine to use functions like this before _describe below,
# or do we need a tag loop?
# TODO: It would be nice to output _message -e TYPE label when the
# following functions dont generate any output in the case of
# multi-level options.
case $IPREFIX in
(alias.)
__git_aliases && ret=0
;;
(branch.)
__git_branch_names -S . && ret=0
;;
(browser.)
__git_browsers -S . && ret=0
;;
(difftool.)
__git_difftools -S . && ret=0
;;
(gc.)
__git_config_sections '^gc\..+\.[^.]+$' refpatterns 'ref pattern' -S . && ret=0
;;
(guitool.)
__git_config_sections '^guitool\..+\.[^.]+$' guitools 'gui tool' -S . && ret=0
;;
(man.)
__git_man_viewers -S . && ret=0
;;
(merge.)
__git_merge_drivers -S . && ret=0
;;
(mergetool.)
__git_mergetools -S . && ret=0
;;
(pager.)
_git_commands && ret=0
;;
(pretty.)
__git_config_sections -a '(|)' '^pretty\..+\.[^.]+$' prettys 'pretty format string' && ret=0
;;
(remote.)
__git_remotes -S . && ret=0
;;
(remotes.)
__git_remote-groups && ret=0
;;
(sendemail.)
__git_sendemail_identities -S . && ret=0
;;
(submodule.)
__git_submodules -S . && ret=0
;;
(url.)
__git_config_sections '^url\..+\.[^.]+$' bases base -S . && ret=0
;;
(svn-remote.)
__git_svn-remotes -S . && ret=0
;;
esac
else
sections=(
advice:'options controlling advice'
core:'options controlling git core'
add:'git add options'
alias:'command aliases'
am:'git am options'
apply:'git apply options'
branch:'branch options'
browser:'browser options'
clean:'git clean options'
color:'color options'
commit:'git commit options'
diff:'diff options'
difftool:'difftools'
fetch:'git fetch options'
format:'format options'
gc:'git gc options'
gitcvs:'git-cvs options'
gui:'git gui options'
guitool:'git gui tool options'
help:'git help options'
http:'http options'
i18n:'internationalization options'
imap:'IMAP options'
init:'git init options'
instaweb:'git web options'
interactive:'options controlling interactivity'
log:'git log options'
mailmap:'mailmap options'
man:'man options'
merge:'git merge options'
mergetool:'mergetools'
notes:'git notes options'
pack:'options controlling packing'
pager:'pager options'
pretty:'pretty formats'
pull:'git pull options'
push:'git push options'
rebase:'git rebase options'
receive:'git receive options'
remote:'remotes'
remotes:'remotes groups'
repack:'repack options'
rerere:'git rerere options'
sendemail:'git send-email options'
showbranch:'showbranch options'
status:'git status options'
submodule:'git submodule options'
tar:'git tar-tree options'
transfer:'options controlling transfers'
url:'URL prefixes'
user:'options controlling user identity'
web:'web options'
svn:'git svn options'
svn-remote:'git svn remotes')
fi
# TODO: Add equivalent of -M 'r:|.=* r:|=*' here so that we can complete
# b.d.c to browser.dillo.cmd.
_describe -t option-names $label \
sections -M 'm:{[:lower:][:upper:]}={[:upper:][:lower:]}' -S . -- \
sections_and_options -M 'm:{[:lower:][:upper:]}={[:upper:][:lower:]}' -qS . -- \
options -M 'm:{[:lower:][:upper:]}={[:upper:][:lower:]}' && ret=0
;;
(gettable-option)
_describe -t git-options option \
${${${(0)"$(_call_program gettable-options git config -z --list)"}%%$'\n'*}//:/\\:} && ret=0
;;
(gettable-colorbool-option)
__git_config_sections -b '(|)' -a '(|)' '^color\.[^.]+$' gettable-colorbool-options option && ret=0
;;
(gettable-color-option)
__git_config_sections -b '(|)' -a '(|)' '^color\.[^.]+\..*$' gettable-color-options option && ret=0
;;
(value)
local current=${${(0)"$(_call_program current "git config $opt_args[(I)--system|--global|--local] ${(kv)opt_args[(I)-f|--file]} -z --get '$line[1]'")"}#*$'\n'}
case $line[1] in
(alias.*)
if [[ -n $current ]]; then
compadd - $current && ret=0
else
_message 'command'
fi
return
;;
(remotes.*)
# TODO: Use this strategy for all multi-item values.
compset -P '* '
local suffix
if [[ $words[CURRENT] == [\"\']* ]]; then
suffix=' '
else
suffix='\ '
fi
# TODO: Should really only complete unique remotes, that is, not the same
# remote more than once in the list.
__git_remotes -S $suffix -q && ret=0
return ret
;;
esac
local z=$'\0'
declare -a parts
parts=("${(S@0)${git_options_static[(r)(#i)${line[1]}:*]}//(#b)(*[^\\]|):/$match[1]$z}")
if (( $#parts < 2 )) && [[ $line[1] == [^.]##.*.[^.]## ]]; then
parts=("${(S@0)${git_options_static[(r)(#i)${line[1]%%.*}.\*.${line[1]##*.}:*]}//(#b)(*[^\\]|):/$match[1]$z}")
fi
(( $#parts > 0 )) || return ret
case $parts[4] in
('->'*)
case ${parts[4]#->} in
(apply.ignorewhitespace)
__git_config_values -- "$current" "$parts[5]" \
{no,false,never,none}':do not ignore whitespace' \
change:'ignore changes in whitespace' && ret=0
;;
(apply.whitespace)
__git_apply_whitespace_strategies && ret=0
;;
(bool)
__git_config_booleans "$current" "$parts[5]" "$parts[2]" && ret=0
;;
(branch)
__git_branch_names && ret=0
;;
(branch.autosetuprebase)
__git_config_values -- "$current" "$parts[5]" \
never:'never set branch.*.rebase to true' \
local:'set branch.*.rebase to true for tracked branches of local branches' \
remote:'set branch.*.rebase to true for tracked branches of remote branches' \
always:'set branch.*.rebase to true for all tracking branches' && ret=0
;;
(branch.mergeoptions)
# TODO: Complete options to git-merge(1).
_message 'git-merge options'
;;
(bytes)
__git_guard_bytes "$parts[2]" && ret=0
;;
(color)
compset -P '* '
case ($words[CURRENT]) in
(?*' '?*' '*)
if [[ $words[CURRENT] == *(bold|dim|ul|blink|reverse)* ]]; then
__git_colors && ret=0
else
__git_color_attributes && ret=0
fi
;;
(*)
local suffix q_flag
if [[ $words[CURRENT] == [\"\']* ]]; then
suffix=' '
q_flag=-q
else
suffix='\ '
fi
if [[ $words[CURRENT] == *(bold|dim|ul|blink|reverse)* ]]; then
__git_colors -S $suffix $q_flag && ret=0
else
_alternative \
'colors::__git_colors -S $suffix $q_flag' \
'attributes::__git_color_attributes -S $suffix $q_flag' && ret=0
fi
;;
esac
;;
(color-bool)
__git_config_values -t booleans -l boolean -- "$current" false \
{never,false,no,off}:"do not $parts[2]" \
always:"always $parts[2]" \
{auto,true,yes,on}:$parts[2] && ret=0
;;
(compression)
__git_compression_levels && ret=0
;;
(core.autocrlf)
__git_config_booleans "$current" "$parts[5]" "$parts[2]" \
input:'convert CRLFs on input only' && ret=0
;;
(core.createObject)
__git_config_values -- "$current" "$parts[5]" \
rename:'rename source objects' \
link:'hardlink, then delete source objects' && ret=0
;;
(core.safecrlf)
__git_config_booleans "$current" "$parts[5]" "$parts[2]" \
warn:'only warn about irreversible CRLF conversions' && ret=0
;;
(core.whitespace)
declare -a values
values=(
'blank-at-eol[treat whitespace at the end of the line as an error]'
'space-before-tab[treat space character before tab character in initial indent as an error]'
'indent-with-non-tab[treat lines indented with 8 or more space characters as an error]'
'tab-in-indent[treat lines indented with a tab character as an error]'
'blank-at-eof[treat blank lines at the end of the files as an error]'
'cr-at-eol[treat carriage-return at the end of the line as part of line terminator]')
_values -s , $parts[2] $values && ret=0
;;
(days)
if [[ -n $current ]]; then
compadd - $current && ret=0
elif [[ -n $parts[5] ]]; then
compadd - $parts[5] && ret=0
else
__git_guard_number 'number of days'
fi
;;
(days+now)
# TODO: This needs to be improved.
if [[ -n $current ]]; then
compadd - $current && ret=0
elif [[ -n $parts[5] ]]; then
compadd - $parts[5] && ret=0
else
__git_guard_number 'number of days'
fi
;;
(diff.renames)
__git_config_booleans "$current" "$parts[5]" "$parts[2]" \
{copies,copy}:'try to detect both renames and copies' && ret=0
;;
(encoding)
__git_encodings && ret=0
;;
(eol)
__git_config_values -- "$current" "$parts[5]" \
lf:'use LF' \
crlf:'use CR+LF' \
native:'use line ending of platform' && ret=0
;;
(format.numbered)
__git_config_booleans "$current" "$parts[5]" "$parts[2]" \
auto:'use sequence numbers if more than one patch' && ret=0
;;
(format.thread)
__git_config_booleans "$current" "$parts[5]" "$parts[2]" \
deep:'make every mail a reply to the previous one' \
shallow:'make every mail a reply to the first one' && ret=0
;;
(gc.packrefs)
__git_config_booleans "$current" "$parts[5]" "$parts[2]" \
notbare:'pack references if the repository has a working directory' && ret=0
;;
(gitcvs.dbdriver)
# TODO: Would be nice to only include those that are installed, but I
# couldnt figure out a good way of doing that when I wrote this code.
__git_config_values -t dbi-drivers -l 'DBI driver' -- "$current" "$part[5]" \
SQLite:'use the SQLite database driver' \
Pg:'use the Pg database driver' && ret=0
;;
(help.format)
__git_config_values -- "$current" "$parts[5]" \
man:'use man' \
info:'use info' \
{web,html}:'use HTML' && ret=0
;;
(imap.authMethod)
__git_config_values -- "$current" "$parts[5]" \
CRAM-MD5:'use CRAM-MD5' && ret=0
;;
(int)
if [[ -n $current ]]; then
compadd - $current && ret=0
elif [[ -n $parts[5] ]]; then
compadd - $parts[5] && ret=0
else
__git_guard_number 'integer'
fi
;;
(merge.conflictstyle)
__git_config_values -- "$current" "$parts[5]" \
merge:'use standard merge style' \
diff3:'use diff3 style' && ret=0
;;
(merge.verbosity)
__git_config_values -t verbosity-levels -l 'verbosity level' -- "$current" "$parts[5]" \
0:'only final error message if conflicts were detected'
1:'conflicts'
2:'conflicts and file changes'
5:'debugging information' && ret=0
;;
(notes.rewriteMode)
__git_config_values -- "$current" "$parts[5]" \
overwrite:'overwrite existing notes' \
concatenate:'add the note to the existing ones' \
ignore:'ignore the new note' && ret=0
;;
(permission)
__git_repository_permissions && ret=0
;;
(push.default)
__git_config_values -- "$current" "$parts[5]" \
nothing:'do not push anything' \
matching:'push all matching branches' \
tracking:'push current branch to its upstream branch' \
current:'push current branch to branch of same name' && ret=0
;;
(receive.denyCurrentBranch)
__git_config_values -- "$current" "$parts[5]" \
{refuse,true,yes,on}:'update ref to current branch of non-bare repository' \
{warn}:'warn about dangers of pushing, but perform it anyway' \
{false,no,off}:'do not update ref to current branch of non-bare repository' && ret=0
;;
(remote.tagopt)
__git_config_values -- "$current" "$parts[5]" \
--tags:'automatically follow tags' \
--no-tags:'do not automatically follow tags' && ret=0
;;
(sendemail.aliasfiletype)
__git_config_values -- "$current" "$parts[5]" \
elm:'elm(1)' \
gnus:'gnus(1)' \
mutt:'mutt(1)' \
mailrc:'mailrc(5)' \
pine:'pine(1)' && ret=0
;;
(sendemail.confirm)
__git_sendemail_confirm_values && ret=0
;;
(sendemail.smtpencryption)
__git_sendemail_smtpencryption_values && ret=0
;;
(sendemail.suppresscc)
__git_sendemail_suppresscc_values && ret=0
;;
(status.showUntrackedFiles)
__git_config_values -- "$current" "$parts[5]" \
no:'do not show untracked files' \
normal:'show untracked files and directories' \
all:'show all individual files in directories' && ret=0
;;
(refname|string)
# TODO: Something better?
if [[ -n $current ]]; then
compadd - $current && ret=0
elif [[ -n $parts[5] ]]; then
compadd - $parts[5] && ret=0
else
# _message 'refname'
_message "${parts[3]:-${parts[2]:-value}}"
fi
;;
(submodule.ignore)
__git_config_values -- "$current" "$parts[5]" \
all:'never consider submodules modified' \
dirty:'ignore all changes to submodule work tree, only take diff between HEAD and recorded commit' \
untracked:'show modified tracked files' \
none:'show modified tracked and untracked files' && ret=0
;;
(umask)
_alternative \
'values:value:(user)' \
'umasks::__git_guard_number umask' && ret=0
;;
esac
;;
(*)
# TODO: Do we need to set up a _requested/_next_label?
declare -a action
local expl
_description values expl "$parts[2]"
eval "action=($parts[4])"
"$action[1]" "$expl[@]" "${(@)action[2,-1]}" && ret=0
;;
esac
;;
esac
return ret
}
(( $+functions[_git-fast-export] )) ||
_git-fast-export () {
# TODO: * should be git-rev-arg and git-rev-list arguments.
_arguments -w -S -s \
'--progress=[insert progress statements]: :__git_guard_number interval' \
'--signed-tags=[specify how to handle signed tags]:action:((verbatim\:"silently export"
warn\:"export, but warn"
strip\:"export unsigned tags instead"
abort\:"abort on signed tags (default)"))' \
'--tag-of-filtered-object=[specify how to handle tags whose tagged object is filtered out]:action:((abort\:"abort on such tags"
drop\:"omit such tags"
rewrite\:"tag ancestor commit"))' \
'-M-[detect moving lines in the file as well]: : :__git_guard_number "number of characters"' \
'-C-[detect copies as well as renames with given scope]: :__git_guard_number size' \
'--export-marks=[dump internal marks table when complete]: :_files' \
'--import-marks=[load marks before processing input]: :_files' \
'--fake-missing-tagger=[fake a tagger when tags lack them]' \
'--no-data[do not output blocb objects, instead referring to them via their SHA-1 hash]' \
'--full-tree[output full tree for each commit]' \
'*: :__git_commit_ranges'
}
(( $+functions[_git-fast-import] )) ||
_git-fast-import () {
_arguments -S -A '-*' \
'--date-format=-[type of dates used in input]:format:((raw\:"native Git format"
rfc2822\:"standard email format from RFC 2822"
now\:"use current time and timezone"' \
'--force[force updating modified existing branches]' \
'--max-pack-size=-[maximum size of each packfile]: :__git_guard_bytes' \
'--big-file-threshold=-[maximum size of blob to create deltas for]: :__git_guard_bytes' \
'--depth=-[maximum delta depth for blob and tree deltification]: :__git_guard_number "maximum delta depth"' \
'--active-branches=-[maximum number of branches to maintain active at once]: :__git_guard_number "maximum number of branches"' \
'--export-marks=-[dump internal marks table when complete]: :_files' \
'--import-marks=-[load marks before processing input]: :_files' \
'*--relative-marks[paths for export/import are relative to internal directory in current repository]' \
'*--no-relative-marks[paths for export/import are not relative to internal directory in current repository]' \
'--export-pack-edges=-[list packfiles and last commit on branches in them in given file]: :_files' \
'--quiet[disable all non-fatal output]' \
'--stats[display statistics about object created]'
}
(( $+functions[_git-filter-branch] )) ||
_git-filter-branch () {
# TODO: --*-filter should take a whole command line.
# TODO: --original should take subdirectory under .git named refs/* or some
# such.
# TODO: * should be git-rev-arg and git-rev-list arguments.
_arguments -S -A '-*' \
'--env-filter[filter for modifying environment in which commit will be performed]: :_path_commands' \
'--tree-filter[filter for rewriting tree and its contents]: :_path_commands' \
'--index-filter[filter for rewriting index]: :_path_commands' \
'--parent-filter[filter for rewriting parent list of commit]: :_path_commands' \
'--msg-filter[filter for rewriting commit messages]: :_path_commands' \
'--commit-filter[filter for rewriting commit]: :_path_commands' \
'--tag-name-filter[filter for rewriting tag names]: :_path_commands' \
'--subdirectory-filter[only look at histor that touches given directory]: :_directories' \
'--prune-empty[ignore empty generated commits]' \
'--original[namespace where original commits will be stored]:namespace:_directories' \
'-d[temporary directory used for rewriting]: :_directories' \
'(-f --force)'{-f,--force}'[force operation]' \
'*: :__git_commit_ranges'
}
(( $+functions[_git-mergetool] )) ||
_git-mergetool () {
# TODO: Only complete files with merge conflicts.
_arguments -S -A '-*' \
'(-t --tool)'{-t,--tool=}'[merge resolution program to use]: :__git_mergetools' \
'(-y --no-prompt --prompt)'{-y,--no-prompt}'[do not prompt before invocation of merge resolution program]' \
'(-y --no-prompt)--prompt[prompt before invocation of merge resolution program]' \
'*:conflicted file:_files'
}
(( $+functions[_git-pack-refs] )) ||
_git-pack-refs () {
_arguments \
'( --no-all)--all[pack all refs]' \
'(--all )--no-all[do not pack all refs]' \
'( --no-prune)--prune[remove loose refs after packing them]' \
'(--prune )--no-prune[do not remove loose refs after packing them]'
}
(( $+functions[_git-prune] )) ||
_git-prune () {
_arguments -S \
'(-n --dry-run)'{-n,--dry-run}'[do not remove anything; just report what would be removed]' \
'(-v --verbose)'{-v,--verbose}'[report all removed objects]' \
'--expire[only expire loose objects older than given date]: :__git_datetimes' \
'*:: :__git_heads'
}
(( $+functions[_git-reflog] )) ||
_git-reflog () {
declare -a revision_options
__git_setup_revision_options
if [[ $words[2] == --* ]]; then
_arguments -S \
$revision_options \
':: :__git_references'
else
local curcontext=$curcontext state line ret=1
declare -A opt_args
# TODO: -h is undocumented.
_arguments -C -S \
'(- : *)-h[display usage]' \
$revision_options \
': :->command' \
'*:: :->option-or-argument' && ret=0
case $state in
(command)
declare -a commands
commands=(
'expire:prune old reflog entries'
'delete:delete entries from reflog'
'show:show log of ref')
_describe -t commands command commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*}-$line[1]:
case $line[1] in
(expire)
# TODO: -n, --dry-run is undocumented.
_arguments -S \
'(-n --dry-run)'{-n,--dry-run}'[undocumented]' \
'--stale-fix[TODO\: provide a decent description for this option]' \
'--expire=-[prune entries older than given time]: :__git_datetimes' \
'--expire-unreachable=-[prune entries older than given time and unreachable]: :__git_datetimes' \
'--all[prune all refs]' \
'--updateref[update ref with SHA-1 of top reflog entry after expiring or deleting]' \
'--rewrite[adjust reflog entries to ensure old SHA-1 points to new SHA-1 of previous entry after expring or deleting]' \
'--verbose[output additional information]' && ret=0
;;
(delete)
# TODO: -n, --dry-run is undocumented.
_arguments -C -S \
'(-n --dry-run)'{-n,--dry-run}'[undocumented]' \
'--updateref[update ref with SHA-1 of top reflog entry after expiring or deleting]' \
'--rewrite[adjust reflog entries to ensure old SHA-1 points to new SHA-1 of previous entry after expring or deleting]' \
'*:: :->reflog-entry' && ret=0
case $state in
(reflog-entry)
# TODO: __git_ignore_line doesnt work here for some reason.
__git_ignore_line __git_reflog_entries && ret=0
;;
esac
;;
(show|--*)
_arguments -S \
$revision_options \
':: :__git_references' && ret=0
;;
esac
esac
return ret
fi
}
(( $+functions[_git-relink] )) ||
_git-relink () {
# TODO: --help is undocumented.
_arguments \
'--safe[stop if two objects with the same hash exist but have different sizes]' \
'--help[display help]' \
': :_directories' \
': :_directories' \
'*: :_directories'
}
(( $+functions[_git-remote] )) ||
_git-remote () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C \
'(-v --verbose)'{-v,--verbose}'[show remote url after name]' \
': :->command' \
'*:: :->option-or-argument' && ret=0
case $state in
(command)
declare -a commands
commands=(
'add:add a new remote'
'rename:rename a remote and update all associated tracking branches'
'rm:remove a remote and all associated tracking branches'
'set-head:set or delete default branch for a remote'
'set-branches:change list of branches tracked by a remote'
'set-url:change URL for a remote'
'show:show information about a given remote'
'prune:delete all stale tracking branches for a remote'
'update:fetch updates for a set of remotes')
_describe -t commands command commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*}-$line[1]:
case $line[1] in
(add)
# TODO: -t and --track should really list branches at url.
_arguments -w -S -s \
'(-f --fetch)'{-f,--fetch}'[run git fetch on new remote after it has been created]' \
'( --no-tags)--tags[tell git fetch to import every tag from remote repository]' \
'(--tags )--no-tags[tell git fetch to not import every tag from remote repository]' \
'*'{-t,--track=}'[track given branch instead of default glob refspec]: :__git_branch_names' \
'(-m --master)'{-m,--master=}'[set HEAD of remote to point to given master branch]: :__git_branch_names' \
'--mirror[do not use separate remotes]' \
':name:__git_remotes' \
':url:_urls' && ret=0
;;
(rename)
_arguments \
':old name:__git_remotes' \
':new name:__git_remotes' && ret=0
;;
(rm)
_arguments \
': :__git_remotes' && ret=0
;;
(set-head)
# TODO: Second argument should be a branch at url for remote.
_arguments -w -S -s \
'(- 2)'{-d,--delete}'[delete default branch]' \
'(- 2)'{-a,--auto}'[determine default branch automatically]' \
': :__git_remotes' \
': :__git_branch_names' && ret=0
;;
(set-branches)
# TODO: Branches should be at url.
_arguments -w -S -s \
'--add[add branches to those already defined]' \
': :__git_remotes' \
'*: :__git_branch_names' && ret=0
;;
(set-url)
# TODO: Old URL should be one of those defined for the remote.
_arguments -w -S -s \
'(3)--push[manipulate push URLs instead of fetch URLs]' \
'--add[add URL to those already defined]' \
'(3)--delete[delete all matching URLs]' \
': :__git_remotes' \
':new url:_urls' \
':old url:_urls' && ret=0
;;
(show)
_arguments -w -S -s \
'-n[do not contact the remote for a list of branches]' \
'*: :__git_remotes' && ret=0
;;
(prune)
_arguments -w -S -s \
'(-n --dry-run)'{-n,--dry-run}'[do not actually prune, only list what would be done]' \
'*: :__git_remotes' && ret=0
;;
(update)
_arguments -w -S -s \
'(-p --prune)'{-p,--prune}'[prune all updated remotes]' \
': :__git_remote-groups' && ret=0
;;
esac
;;
esac
return ret
}
(( $+functions[_git-repack] )) ||
_git-repack () {
# TODO: --quiet is undocumented.
_arguments -w -S -s \
'(-A)-a[pack all objects into a single pack]' \
'(-a)-A[pack all objects into a single pack, but unreachable objects become loose]' \
'-d[remove redundant packs after packing]' \
'-l[pass --local option to git pack-objects]' \
'-f[pass --no-reuse-delta option to git pack-objects]' \
'-F[pass --no-reuse-object option to git pack-objects]' \
'(-q --quiet)'{-q,--quiet}'[pass -q option to git pack-objects]' \
'-n[do not update server information]' \
'--window=-[number of objects to consider when doing delta compression]: :__git_guard_number "number of objects"' \
'--depth=-[maximum delta depth]: :__git_guard_number "maximum delta depth"' \
'--window-memory=-[scale window size dynamically to not use more than N bytes of memory]: :__git_guard_bytes' \
'--max-pack-size=-[maximum size of each output packfile]:maximum pack size:__git_guard_bytes'
}
(( $+functions[_git-replace] )) ||
_git-replace () {
_arguments -w -S -s \
'(- *)-f[overwrite existing replace ref]' \
'(- 2)-d[delete existing replace refs]' \
'(- : *)-l[list replace refs]:pattern' \
': :__git_objects' \
':replacement:__git_objects' \
'*: :__git_objects'
}
# Ancillary Commands (Interrogators)
(( $+functions[_git-blame] )) ||
_git-blame () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
declare -a revision_options
__git_setup_revision_options
# TODO: Not sure about __git_cached_files.
_arguments -w -C -S -s \
'-b[show blank SHA-1 for boundary commits]' \
'--root[do not treat root commits as boundaries]' \
'--show-stats[include additional statistics at the end of blame output]' \
'-L[annotate only the given line range]: :->line-range' \
'-l[show long rev]' \
'-t[show raw timestamp]' \
'-S[use revs from revs-file]:revs-file:_files' \
'--reverse[walk histor forward instead of backward]' \
'(-p --porcelain)'{-p,--porcelain}'[show results designed for machine processing]' \
'--incremental[show results incrementally for machine processing]' \
'--contents[annotate against the given file if no rev is specified]: :_files' \
'(-h --help)'{-h,--help}'[show help message]' \
'-c[use same output format as git annotate]' \
'--score-debug[output debugging information relating to -C and -M line movement]' \
'(-f --show-name)'{-f,--show-name}'[show the filename of the original commit]' \
'(-n --show-number)'{-n,--show-number}'[show the line number in the original commit]' \
'-s[suppress author name and timestamp]' \
'-w[ignore whitespace when finding lines]' \
$revision_options \
': :__git_cached_files' \
':: :__git_revisions' && ret=0
case $state in
(line-range)
if compset -P '([[:digit:]]#|/[^/]#(\\?[^/]#)#/),'; then
_alternative \
'line-numbers::__git_guard_number "line number"' \
'regexes::_guard "(/[^/]#(\\?[^/]#)#(/|)|)" regex' \
'offsets::_guard "([+-][[:digit:]]#|)" "line offset"' && ret=0
else
_alternative \
'line-numbers::__git_guard_number "line number"' \
'regexes::_guard "(/[^/]#(\\?[^/]#)#(/|)|)" regex' && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-cherry] )) ||
_git-cherry () {
# TODO: --abbrev is undocumented.
_arguments \
'(-v --verbose)'{-v,--verbose}'[output additional information]' \
'--abbrev=[set minimum SHA1 display-length]: :__git_guard_number length' \
':upstream commit:__git_commits' \
'::head commit:__git_commits' \
'::limit commit:__git_commits'
}
(( $+functions[_git-count-objects] )) ||
_git-count-objects () {
_arguments \
'(-v --verbose)'{-v,--verbose}'[also report number of in-pack objects and objects that can be removed]'
}
(( $+functions[_git-difftool] )) ||
_git-difftool () {
# TODO: Is this fine, or do we need to modify the context or similar?
_git-diff \
'(-y --no-prompt --prompt)'{-y,--no-prompt}'[do not prompt before invocation of diff tool]' \
'(-y --no-prompt)--prompt[prompt before invocation of diff tool]' \
'(-t --tool -x --extcmd)'{-t,--tool=-}'[merge resolution program to use]: :__git_difftools' \
'(-t --tool -x --extcmd)'{-x,--extcmd=-}'[custom diff command to use]: :_path_commands' \
'(-g --gui)'{-g,--gui}'[use diff.guitool instead of diff.tool]'
}
(( $+functions[_git-fsck] )) ||
_git-fsck () {
# TODO: -v is undocumented.
_arguments -w -S -s \
'--unreachable[show objects that are unreferenced in the object database]' \
'--root[show root nodes]' \
'--tags[show tags]' \
'--cache[consider objects recorded in the index as head nodes for reachability traces]' \
'--no-reflogs[do not consider commits referenced only by reflog entries to be reachable]' \
'--full[check all object directories]' \
'--strict[do strict checking]' \
'(-v --verbose)'{-v,--verbose}'[output additional information]' \
'--lost-found[write dangling objects into .git/lost-found]' \
'*: :__git_objects'
}
(( $+functions[_git-get-tar-commit-id] )) ||
_git-get-tar-commit-id () {
_message 'no arguments allowed; accepts tar-file on standard input'
}
(( $+functions[_git-help] )) ||
_git-help () {
_arguments -w -S -s \
'( -i --info -m --man -w --web)'{-a,--all}'[show all available commands]' \
'(-a --all -m --man -w --web)'{-i,--info}'[show all available commands]' \
'(-a --all -i --info -w --web)'{-m,--man}'[show all available commands]' \
'(-a --all -i --info -m --man )'{-w,--web}'[show all available commands]' \
': :_git_commands'
}
(( $+functions[_git-instaweb] )) ||
_git-instaweb () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -w -C -S -s \
'(-l --local)'{-l,--local}'[bind the web server to 127.0.0.1]' \
'(-d --httpd)'{-d,--httpd=}'[HTTP-daemon command-line that will be executed]:command line' \
'(-m --module-path)'{-m,--module-path=}'[module path for the Apache HTTP-daemon]:module path:_directories' \
'(-p --port)'{-p,--port=}'[port to bind web server to]: :__git_guard_number port' \
'(-b --browser)'{-b,--browser=}'[web-browser command-line that will be executed]:command line' \
'(:)--start[start the HTTP-daemon and exit]' \
'(:)--stop[stop the HTTP-daemon and exit]' \
'(:)--restart[restart the HTTP-daemon and exit]' \
': :->command' && ret=0
case $state in
(command)
declare -a commands
commands=(
start:'start the HTTP-daemon and exit'
stop:'stop the HTTP-daemon and exit'
restart:'restart the HTTP-daemon and exit')
_describe -t commands command commands && ret=0
;;
esac
return ret
}
(( $+functions[_git-merge-tree] )) ||
_git-merge-tree () {
_arguments \
':base-tree:__git_tree_ishs' \
':branch 1:__git_tree_ishs' \
':branch 2:__git_tree_ishs'
}
(( $+functions[_git-rerere] )) ||
_git-rerere () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
# TODO: --rerere-autoupdate is undocumented.
_arguments -w -C -S -s \
'--rerere-autoupdate[register clean resolutions in index]' \
': :->command' && ret=0
case $state in
(command)
# TODO: This isnt optimal, as forget get confused.
_values command \
'clear[reset metadata used by rerere]' \
'forget[resets metadata used by rerere for specific conflict]: :__git_cached_files' \
'diff[output diffs for the current state of the resolution]' \
'status[like diff, but only output filesames]' \
'gc[prune old records of conflicted merges]' && ret=0
;;
esac
return ret
}
(( $+functions[_git-rev-parse] )) ||
_git-rev-parse () {
local parseopt_opt= sq_quote_opt= local_env_vars_opt= h_opt=
declare -a quiet_opts
if (( CURRENT == 2 )); then
parseopt_opt='--parseopt[use git rev-parse in option parsing mode]'
sq_quote_opt='--sq-quote[use git rev-parse in shell quoting mode]'
local_env_vars_opt='--local-env-vars[list git environment variables local to repository]'
h_opt='-h[display usage]'
fi
if (( words[(I)--verify] )); then
quiet_opts=({-q,--quiet}'[do not output error messages]')
fi
local ret=0
if (( words[(I)--parseopt] )); then
if (( words[(I)--] )); then
_message 'argument'
else
# TODO: Parse option specification?
_arguments -w -S -s \
'(- *)'{-h,--help}'[display usage]' \
'--keep-dashdash[do not skip first -- option]' \
'--stop-at-non-option[stop parsing options at first non-option argument]' \
'*:option specification' && ret=0
fi
elif (( words[(I)--sq-quote] )); then
_message 'argument'
elif (( words[(I)--local-env-vars|-h] )); then
_message 'no more arguments'
else
_arguments \
$parseopt_opt \
$sq_quote_opt \
$local_env_vars_opt \
$h_opt \
'( --no-revs --verify --short)--revs-only[do not output flags and parameters not meant for git rev-list]' \
'(--revs-only --verify --short)--no-revs[do not output flags and parameters meant for git rev-list]' \
'( --no-flags --verify --short)--flags[do not output non-flag parameters]' \
'(--flags --verify --short)--no-flags[do not output flag parameters]' \
'--default[use given argument if there is no parameter given]:argument' \
'(--revs-only --no-revs --flags --no-flags --short)--verify[verify parameter to be usable]' \
'(-q --quiet)'{-q,--quiet}'[suppress all output]' \
'--sq[output single shell-quoted line]' \
'--not[toggle ^ prefix of object names]' \
'( --symbolic-full-name)--symbolic[output in a format as true to input as possible]' \
'(--symbolic )--symbolic-full-name[same as --symbolic, but omit non-ref inputs]' \
'--abbrev-ref=-[a non-ambiguous short name of object]::mode:(strict loose)' \
'--all[show all refs found in refs/]' \
'--branches=-[show branch refs found in refs/heads/]::shell glob pattern' \
'--tags=-[show tag refs found in refs/tags/]::shell glob pattern' \
'--remotes=-[show tag refs found in refs/remotes/]::shell glob pattern' \
'--glob=-[show all matching refs]::shell glob pattern' \
'--show-toplevel[show absolute path of top-level directory]' \
'--show-prefix[show path of current directory relative to top-level directory]' \
'--show-cdup[show path of top-level directory relative to current directory]' \
'--git-dir[show $GIT_DIR if defined else show path to .git directory]' \
'--is-inside-git-dir[show whether or not current working directory is below repository directory]' \
'--is-inside-work-tree[show whether or not current working directory is inside work tree]' \
'--is-bare-repository[show whether or not repository is bare]' \
'(--revs-only --no-revs --flags --no-flags --verify)--short=-[show only shorter unique name]:: :__git_guard_number length' \
'(--since --after)'{--since=-,--after=-}'[show --max-age= parameter corresponding given date string]:datestring' \
'(--until --before)'{--until=-,--before=-}'[show --min-age= parameter corresponding given date string]:datestring' \
'*: :__git_objects' && ret=0
fi
return ret
}
(( $+functions[_git-show-branch] )) ||
_git-show-branch () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -w -C -S -s -A '-*' \
'(--more --merge-base --independent)--list[do not show any ancestry (--more=-1)]' \
- branches \
'(-r --remotes -a --all)'{-r,--remotes}'[show remote-tracking branches]' \
'(-r --remotes -a --all)'{-a,--all}'[show both remote-tracking branches and local branches]' \
'--current[include current branch to the list of revs]' \
'( --date-order)--topo-order[show commits in topological order]' \
'(--topo-order )--date-order[show commits in commit-date order]' \
'--sparse[output merges that are reachable from multiple tips being shown]' \
'( --list --merge-base --independent)--more=[go given number of commit beyond common ancestor (no ancestry if negative)]:: :_guard "(-|)[[\:digit\:]]#" limit' \
'(--more --list --independent)--merge-base[act like git merge-base -a, but with two heads]' \
'(--more --list --merge-base )--independent[show only the reference that can not be reached from any of the other]' \
'( --sha1-name)--no-name[do not show naming strings for each commit]' \
'(--no-name )--sha1-name[name commits with unique prefix of object names]' \
'--topics[show only commits that are NOT on the first branch given]' \
'( --no-color)--color[color status sign of commits]:: :__git_color_whens' \
'(--color )--no-color[do not color statis sign of commits]' \
'*: :__git_revisions' \
- reflogs \
'(-g --reflog)'{-g,--reflog=}'[show reflog entries for given ref]:: :->limit-and-base' \
': :__git_references' && ret=0
case $state in
(limit-and-base)
if compset -P '[[:digit:]]##,'; then
_alternative \
'counts::__git_guard_number count' \
'dates::__git_datetimes' && ret=0
else
__git_guard_number limit
fi
;;
esac
return ret
}
(( $+functions[_git-verify-tag] )) ||
_git-verify-tag () {
# TODO: -v and --verbose are undocumented.
_arguments -w -S -s \
'(-v --verbose)'{-v,--verbose}'[output additional information]' \
'*: :__git_tags'
}
(( $+functions[_git-whatchanged] )) ||
_git-whatchanged () {
local -a revision_options
__git_setup_revision_options
_arguments -S \
$revision_options \
'1:: :__git_commits' \
'*: :__git_cached_files'
}
# Interacting With Others
(( $+functions[_git-archimport] )) ||
_git-archimport () {
# TODO: archive/branch can perhaps use _arch_archives. It should also allow
# an optional colon followed by a __git_branches.
_arguments \
'-h[display usage]' \
'-v[verbose output]' \
'-T[create tag for every commit]' \
'-f[use fast patchset import strategy]' \
'-o[use old-style branch names]' \
'-D[attempt to import trees that have been merged from]: :__git_guard_number depth' \
'-a[auto-register archives at http://mirrors.sourcecontrol.net]' \
'-t[use given directory as temporary directory]: :_directories' \
'*:archive/branch'
}
(( $+functions[_git-cvsexportcommit] )) ||
_git-cvsexportcommit () {
# TODO: Could use _cvs_root from _cvs for completing argument to -d.
_arguments \
'-c[commit automatically if patch applied cleanly]' \
'-p[be pedantic (paranoid) when applying patches]' \
'-a[add authorship information]' \
'-d[set an alternative CVSROOT to use]:cvsroot' \
'-f[force the merge, even if files are not up to date]' \
'-P[force the parent commit, even if it is not a direct parent]' \
'-m[prepend the commit message with the provided prefix]:message prefix' \
'-u[update affected files from CVS repository before attempting export]' \
'-k[reverse CVS keyword expansion]' \
'-w[specify location of CVS checkout to use for export]' \
'-W[use current working directory for bot Git and CVS checkout]' \
'-v[verbose output]' \
'-h[display usage]' \
':: :__git_commits' \
': :__git_commits'
}
(( $+functions[_git-cvsimport] )) ||
_git-cvsimport () {
# TODO: _cvs_root for -d would be nice
_arguments \
'-v[verbose output]' \
'-d[specify the root of the CVS archive]:cvsroot' \
'-C[specify the git repository to import into]:directory:_directories' \
'-r[the git remote to import into]:remote' \
'-o[specify the branch into which you wish to import]: :__git_branch_names' \
'-i[do not perform a checkout after importing]' \
'-k[remove keywords from source files in the CVS archive]' \
'-u[convert underscores in tag and branch names to dots]' \
'-s[substitute the "/" character in branch names with given substitution]:substitute' \
'-p[specify additional options for cvsps]:cvsps-options' \
'-z[specify timestamp fuzz factor to cvsps]:fuzz-factor' \
'-P[read cvsps output file]:file:_files' \
'-m[attempt to detect merges based on the commit message]' \
'*-M[attempt to detect merges based on the commit message with custom pattern]:pattern' \
'-S[skip paths matching given regex]:regex' \
'-a[import all commits, including recent ones]' \
'-L[limit the number of commits imported]:limit' \
'-A[specify author-conversion file]:author-conversion file:_files' \
'-R[generate cvs-revisions file mapping CVS revision numbers to commit IDs]' \
'-h[display usage information]' \
':cvsmodule'
}
(( $+functions[_git-cvsserver] )) ||
_git-cvsserver () {
_arguments -w -S -s \
'--base-path[path to prepend to requested CVSROOT]: :_directories' \
'--strict-paths[do not allow recursing into subdirectories]' \
'--export-all[do not check for gitcvs.enabled]' \
'(- * -V --version)'{-V,--version}'[display version information]' \
'(- * -h --help)'{-h,-H,--help}'[display usage information]' \
'::type:(pserver server)' \
'*: :_directories'
}
(( $+functions[_git-imap-send] )) ||
_git-imap-send () {
_message 'no arguments allowed; accepts mailbox file on standard input'
}
(( $+functions[_git-quiltimport] )) ||
_git-quiltimport () {
_arguments -S \
'(-n --dry-run)'{-n,--dry-run}'[check patches and warn if they cannot be imported]' \
'--author[default author name and email address to use for patches]: :_email_addresses' \
'--patches[set directory containing patches]:patch directory:_directories'
}
(( $+functions[_git-request-pull] )) ||
_git-request-pull () {
_arguments -S \
'-p[display patch text]' \
':start commit:__git_commits' \
': :_urls' \
'::end commit:__git_commits'
}
(( $+functions[_git-send-email] )) ||
_git-send-email () {
_arguments -S \
'--annotate[review and edit each patch before sending it]' \
'--bcc=[Bcc: value for each email]: :_email_addresses' \
'--cc=[starting Cc: value for each email]: :_email_addresses' \
'--compose[edit introductory message for patch series]' \
'--from=[specify sender]:email address:_email_addresses' \
'--in-reply-to=[specify contents of first In-Reply-To header]:message-id' \
'--subject=[specify the initial subject of the email thread]:subject' \
'--to=[specify the primary recipient of the emails]: :_email_addresses' \
'--8bit-encoding=[encoding to use for non-ASCII messages]: :__git_encodings' \
'--envelope-sender[specify the envelope sender used to send the emails]: :_email_addresses' \
'--smtp-encryption=[specify encryption method to use]: :__git_sendemail_smtpencryption_values' \
'--smtp-domain=[specify FQDN used in HELO/EHLO]: :_domains' \
'--smtp-pass=[specify password to use for SMTP-AUTH]::password' \
'--smtp-server=[specify SMTP server to connect to]:smtp server:_hosts' \
'--smtp-server-port=[specify port to connect to SMTP server on]:smtp port:_ports' \
'--smtp-user=[specify user to use for SMTP-AUTH]:smtp user:_users' \
'--cc-cmd=[specify command to generate Cc\: header with]:Cc\: command:_path_commands' \
'( --no-chain-reply-to)--chain-reply-to[send each email as a reply to previous one]' \
'(--chain-reply-to )--no-chain-reply-to[send all emails after first as replies to first one]' \
'--identity=[specify configuration identity]: :__git_sendemail_identities' \
'( --no-signed-off-by-cc)--signed-off-by-cc[add emails found in Signed-off-by: lines to the Cc: list]' \
'(--signed-off-by-cc )--no-signed-off-by-cc[do not add emails found in Signed-off-by: lines to the Cc: list]' \
'--suppress-cc=[specify rules for suppressing Cc:]: :__git_sendemail_suppresscc_values' \
'( --no-suppress-from)--suppress-from[do not add the From: address to the Cc: list]' \
'(--suppress-from )--no-suppress-from[add the From: address to the Cc: list]' \
'( --no-thread)--thread[set In-Reply-To: and References: headers]' \
'(--thread )--no-thread[do not set In-Reply-To: and References: headers]' \
'--confirm[specify type of confirmation required before sending]: :__git_sendemail_confirm' \
'--dry-run[do everything except actually sending the emails]' \
'( --no-format-patch)--format-patch[interpret ambiguous arguments as format-patch arguments]' \
'(--format-patch )--no-format-patch[interpret ambiguous arguments file-name arguments]' \
'--quiet[be less verbose]' \
'( --no-validate)--validate[perform sanity checks on patches]' \
'(--validate )--validate[do not perform sanity checks on patches]' \
'--force[send emails even if safetiy checks would prevent it]' \
'*: :_files'
}
(( $+functions[_git-svn] )) ||
_git-svn () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C \
'(- :)'{-V,--version}'[display version information]' \
'(- :)'{-h,-H,--help}'[display usage information]' \
': :->command' \
'*:: :->option-or-argument' && ret=0
case $state in
(command)
declare -a commands
commands=(
init:'initialize an empty git repository with additional svn data'
fetch:'fetch revisions from the SVN remote'
clone:'same as init, followed by fetch'
rebase:'fetch revs from SVN parent of HEAD and rebase current work on it'
dcommit:'commit diffs from given head onto SVN repository'
branch:'create a branch in the SVN repository'
tag:'create a tag in the SVN repository'
log:'output SVN log-messages'
blame:'show what revision and author last modified each line of a file'
find-rev:'output git commit corresponding to the given SVN revision'\''s hash'
set-tree:'commit given commit or tree to SVN repository'
create-ignore:'recursively finds the svn:ignore property and creates .gitignore files'
show-ignore:'output corresponding toplevel .gitignore file of svn:ignore'
mkdirs:'recreate empty directories that Git cannot track'
commit-diff:'commit diff of two tree-ishs'
info:'show information about a file or directory'
proplist:'list the SVN properties stored for a file or directory'
propget:'get a given SVN property for a file'
show-externals:'show the subversion externals'
gc:'compress git-svn-related information'
reset:'undo effect of fetch back to specific revision')
_describe -t commands command commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*}-$line[1]:
declare -a remote_opts fc_opts init_opts cmt_opts opts
# TODO: --no-auth-cache is undocumented.
# TODO: --config-dir is undocumented.
remote_opts=(
'--username=[username to use for SVN transport]: :_users'
'--ignore-paths[regular expression of paths to not check out]:pattern'
'--no-auth-cache[undocumented]'
'--config-dir=[undocumented]:configuration directory:_directories')
# TODO: --repack-flags can be improved by actually completing the legal
# flags to git-repack.
# TODO: --noMetadata is undocumented.
# TODO: --useSvmProps is undocumented.
# TODO: --useSvnsyncProps is undocumented.
# TODO: --log-window-size is undocumented.
# TODO: --no-checkout is undocumented.
fc_opts=(
'--localtime[store Git commit times in local timezone]'
'--use-log-author[use author from the first From: or Signed-Off-By: line, when fetching into git]'
'--add-author-from[when committing to svn, append a From: line based on the git commit'\''s author string]'
'( --no-follow-parent)--follow-parent[follow parent commit]'
'(--follow-parent )--no-follow-parent[do not follow parent commit]'
'(-A --authors-file)'{-A,--authors-file}'[specify author-conversion file]:author-conversion file:_files'
'--authors-prog=[program used to generate authors]: :_path_commands'
'(-q --quiet)'{-q,--quiet}'[make git-svn less verbose]'
'--repack=[repack files (for given number of revisions)]:: :__git_guard_number "revision limit"'
'(--repack-flags --repack-args --repack-opts)'{--repack-flags=,--repack-args=,--repack-opts=}'[flags to pass to git-repack]:git-repack flags'
'--noMetadata[undocumented]'
'--useSvmProps[undocumented]'
'--useSvnsyncProps[undocumented]'
'--log-window-size=[undocumented]'
'--no-checkout[undocumented]'
$remote_opts)
init_opts=(
'(-T --trunk)'{-T-,--trunk=}'[set trunk sub-directory]:trunk sub-directory:->subdirectory'
'(-t --tags)*'{-t-,--tags=}'[add tags sub-directory]:tags sub-directory:->subdirectory'
'(-b --branches)*'{-b-,--branches=}'[add branches sub-directory]:branches sub-directory:->subdirectory'
'(-s --stdlayout)'{-s,--stdlayout}'[shorthand for setting trunk, tags, branches as relative paths, the SVN default]'
'--no-metadata[set svn-remote.*.noMetadata]'
'--use-svm-props[set svn-remote.*.useSvmProps]'
'--use-svnsync-props[set svn-remote.*.useSvnsyncProps]'
'--rewrite-root=[set svn-remote.*.rewriteRoot]:new root:_urls'
'--rewrite-uuid=[set svn-remote.*.rewriteUUID]:uuid'
'--prefix=[prefix to use for names of remotes]:path prefix:_directories -r ""'
'( --no-minimize-url)--minimize-url[minimize URLs]'
'(--minimize-url )--no-minimize-url[do not minimize URLs]'
'--shared=[share repository amongst several users]:: :__git_repository_permissions'
'--template=[directory to use as a template for the object database]: :_directories'
$remote_opts)
# TODO: -C and --copy-similarity are undocumented.
cmt_opts=(
'--rmdir[remove empty directories from SVN tree after commit]'
'(-e --edit)'{-e,--edit}'[edit commit message before committing]'
'-l-[limit number of rename/copy targets to run]: :__git_guard_number'
'--find-copies-harder[try harder to find copies]'
'(-C --copy-similarity)'{-C-,--copy-similarity=}'[undocumented]: :_guard "[[\:digit:\]]#" number')
if [[ $line[1] == (fetch|clone) ]]; then
arguments+=(
'(-r --revision)'{-r,--revision}'[only fetch given revision or revision range]: :__git_svn_revisions'
':: :__git_svn-remotes')
fi
if [[ $line[1] == (fetch|rebase|dcommit) ]]; then
# TODO: --fetch-all and --all are undocumented.
opts+=(
'(--fetch-all --all)'{--fetch-all,--all}'[undocumented]')
fi
if [[ $line[1] == (rebase|dcommit) ]]; then
opts+=(
'(-m --merge)'{-m,--merge}'[use merging strategies, if necessary]'
'*'{-s,--strategy=-}'[use given merge strategy]:merge strategy:__git_merge_strategies')
fi
if [[ $line[1] == (rebase|dcommit|branch) ]]; then
opts+=(
'(-n --dry-run)'{-n,--dry-run}'[only display what would be done]')
fi
if [[ $line[1] == (rebase|dcommit|log) ]]; then
opts+=(
'(-v --verbose)'{-v,--verbose}'[display extra information]')
fi
case $line[1] in
(init)
opts+=(
$init_opts)
;;
(fetch)
opts+=(
'--parent[fetch only from SVN parent of current HEAD]'
$fc_opts)
;;
(clone)
opts+=(
$init_opts
$fc_opts
':url:_urls'
'::directory:_directories')
;;
(rebase)
opts+=(
'--local[do not fetch remotely, rebase against the last fetched commit from SVN]'
$fc_opts)
;;
(dcommit)
arguments+=(
'--no-rebase[do not rebase or reset after committing]'
'--commit-url[commit to a different SVN url]:SVN URL:_url'
$fc_opts
$cmt_opts)
;;
(branch|tag)
# TODO: -d/--destination should complete output of
# git config --get-all svn-remote.*.branches
# git config --get-all svn-remote.*.tags
# TODO: --username should probably use something from _svn.
# TODO: --commit-url should complete output of
# git config --get-all svn-remote.*.commiturl
opts+=(
'(-m --message)'{-m,--message}'[specify the commit message]:message'
'(-d --destination)'{-d,--destination}'[location of branch or tag to create in SVN repository]: :_directories'
'--username[specify SVN username to perform commit as]: :_users'
'--commit-url[specify URL to connect to destination SVN repository]: :_urls')
if [[ $line[1] != tag ]]; then
opts+=(
'(-t --tag)'{-t,--tag}'[create a tag]')
fi
;;
(log)
declare -a revision_options
__git_setup_revision_options
# TODO: --color is undocumented.
# TODO: --pager is undocumented.
# TODO: --non-recursive is undocumented.
opts+=(
$revision_options
'(-r --revision)'{-r-,--revision=}'[revisions to output log information for]: :__git_svn_revision_numbers'
'--limit=[like --max-count, but not counting merged/excluded commits]: :__git_guard_number limit'
'--incremental[give output suitable for concatenation]'
'--show-commit[output git commit SHA-1, as well]'
'--color[undocumented]'
'--pager[undocumented]:pager:_path_commands'
'--non-recursive[undocumented]')
;;
(blame)
opts+=(
'--git-format[produce output in git-blame format, with SVN revision numbers instead of git commit hashes]')
;;
(set-tree)
opts+=(
'--stdin[read list of commits to commit from stdin]')
;;
(create-ignore|show-ignore|mkdirs|proplist|propget|show-externals)
# TODO: -r and --revision is undocumented for show-ignore and mkdirs.
opts+=(
'(-r --revision)'{-r,--revision}'[specify SVN revision]: :__git_svn_revisions')
;;
(commit-diff)
# TODO: -m and --message is undocumented.
# TODO: -F and --file is undocumented.
# TODO: -r and --revision is undocumented.
opts+=(
'(-m --message)'{-m-,--message=}'[undocumented]:message'
'(-F --file)'{-F-,--file=}'[undocumented]: :_files'
'(-r --revision)'{-r-,--revision=}'[undocumented]: :__git_svn_revisions')
;;
(info)
opts+=(
'--url[output only value of URL field]')
;;
(reset)
opts+=(
'(-r --revision)'{-r,--revision}'[specify most recent SVN revision to keep]: :__git_svn_revisions'
'(-p --parent)'{-p,--parent}'[discard specified revision as well, keeping nearest parent instead]')
;;
esac
_arguments -w -C -S -s \
'(-h -H --help)'{-h,-H,--help}'[display usage information]' \
'(-V --version)'{-V,--version}'[display version information]' \
'--minimize-connections[undocumented]' \
'(-R --svn-remote --remote)'{-R,--svn-remote,--remote}'[svn remote to use]:svn remote:__git_svn-remotes' \
'(-i --id)'{-i,--id}'[set GIT_SVN_ID]:GIT_SVN_ID' \
$opts && ret=0
case $state in
(subdirectory)
_alternative \
'sub-directories:sub-directory:_directories' \
'urls: :_urls' && ret=0
;;
esac
;;
esac
return ret
}
# LOW-LEVEL COMMANDS (PLUMBING)
# Manipulation commands
(( $+functions[_git-apply] )) ||
_git-apply () {
local -a apply_options
__git_setup_apply_options
_arguments -w -S -s \
$apply_options \
'--stat[output diffstat for input (turns off "apply")]' \
'--numstat[same as --stat but in decimal notation and complete pathnames (turns off "apply")]' \
'--summary[output summary of git-diff extended headers (turns off "apply")]' \
'--check[check if patches are applicable (turns off "apply")]' \
'( --cached)--index[make sure that patch is applicable to index]' \
'(--index )--cached[apply patches without touching working tree]' \
'--build-face-ancestor[build temporary index for blobs with ambiguous origin]:index:_files' \
'(-R --reverse)'{-R,--reverse}'[apply patches in reverse]' \
'-z[use NUL termination on output]' \
'--unidiff-zero[disable unified-diff-context check]' \
'--apply[apply patches that would otherwise not be applied]' \
'--no-add[ignore additions made by the patch]' \
'*--exclude=[skip files matching specified pattern]:pattern' \
'*--include=[include files matching specified pattern]:pattern' \
'--inaccurate-eof[work around missing-new-line-at-EOF bugs]' \
'(-v --verbose)'{-v,--verbose}'[display progress on stderr]' \
'--recount[do not trust line counts in hunk headers]' \
'*:patch:_files'
}
(( $+functions[_git-checkout-index] )) ||
_git-checkout-index () {
local z_opt=
if (( words[(I)--stdin] )); then
z_opt='-z[paths are separated with NUL character when reading from standard input]'
fi
_arguments -w -S -s \
'(-u --index)'{-u,--index}'[update stat information in index]' \
'(-q --quiet)'{-q,--quiet}'[do not complain about existing files or missing files]' \
'(-f --force)'{-f,--force}'[force overwrite of existing files]' \
'(-a --all --stdin *)'{-a,--all}'[check out all files in index]' \
'(-n --no-create)'{-n,--no-create}'[do not checkout new files]' \
'--prefix=-[prefix to use when creating files]:directory:_directories' \
'--stage=-[check out files from named stage]:stage:(1 2 3 all)' \
'--temp[write content to temporary files]' \
'(-a --all *)--stdin[read list of paths from the standard input]' \
$z_opt \
'*: :__git_cached_files'
}
(( $+functions[_git-commit-tree] )) ||
_git-commit-tree () {
if (( CURRENT == 2 )); then
_arguments \
'-h[display usage]' \
': :__git_trees'
elif [[ $words[CURRENT-1] == -p ]]; then
local expl
_description commits expl 'parent commit'
__git_objects $expl
else
compadd - '-p'
fi
}
(( $+functions[_git-hash-object] )) ||
_git-hash-object () {
_arguments -S \
'-t[type of object to create]:object type:((blob\:"a blob of data"
commit\:"a tree with parent commits"
tag\:"a symbolic name for another object"
tree\:"a recursive tree of blobs"))' \
'-w[write object to object database]' \
'(: --stdin-paths)--stdin[read object from standard input]' \
'(: --stdin --path)--stdin-paths[read file names from standard input instead of from command line]' \
'( --no-filters)--path=[hash object as if it were located at given path]: :_files' \
'(--path )--no-filters[hash contents as is, ignoring any input filters]' \
'(--stdin --stdin-paths):file:_files'
}
(( $+functions[_git-index-pack] )) ||
_git-index-pack () {
local -a stdin_opts
if (( words[(I)--stdin] )); then
stdin_opts=(
'--fix-thin[record deltified objects, based on objects not included]'
'--keep=-[create .keep file]::reason')
fi
# NOTE: --index-version is only used by the Git test suite.
# TODO: --pack_header is undocumented.
_arguments \
'-v[display progress on stderr]' \
'-o[write generated pack index into specified file]: :_files' \
'--stdin[read pack from stdin and instead write to specified file]' \
$stdin_opts \
'--strict[die if the pack contains broken objects or links]' \
':pack file:_files -g "*.pack(-.)"'
}
(( $+functions[_git-merge-file] )) ||
_git-merge-file () {
integer n_labels=${#${(M)words[1,CURRENT-1]:#-L}}
local label_opt=
if (( n_labels < 3 )) || [[ $words[CURRENT-1] == -L ]]; then
local -a ordinals
ordinals=(first second third)
label_opt="*-L[label to use for the $ordinals[n_labels+1] file]:label"
fi
# TODO: --marker-size in undocumented.
# TODO: --diff3 is undocumented.
_arguments \
$label_opt \
'(-p --stdout)'{-p,--stdout}'[send merged file to standard output instead of overwriting first file]' \
'(-q --quiet)'{-q,--quiet}'[do not warn about conflicts]' \
'( --theirs --union)--ours[resolve conflicts favoring our side of the lines]' \
'(--ours --union)--theirs[resolve conflicts favoring their side of the lines]' \
'(--ours --theirs )--union[resolve conflicts favoring both sides of the lines]' \
'--marker-size[specify length of conflict markers]: :__git_guard_number "marker length"' \
'--diff3[undocumented]' \
':current file:_files' \
':base file:_files' \
':other file:_files'
}
(( $+functions[_git-merge-index] )) ||
_git-merge-index () {
if (( CURRENT > 2 )) && [[ $words[CURRENT-1] != -[oq] ]]; then
_arguments -S \
'(:)-a[run merge against all files in index that need merging]' \
'*: :__git_cached_files'
else
declare -a arguments
(( CURRENT == 2 )) && arguments+='-o[skip failed merges]'
(( CURRENT == 2 || CURRENT == 3 )) && arguments+='(-o)-q[do not complain about failed merges]'
(( 2 <= CURRENT && CURRENT <= 4 )) && arguments+='*:merge program:_files -g "*(*)"'
_arguments -S $arguments
fi
}
(( $+functions[_git-mktag] )) ||
_git-mktag () {
_message 'no arguments allowed; only accepts tags on standard input'
}
(( $+functions[_git-mktree] )) ||
_git-mktree () {
_arguments -w -S -s \
'-z[read NUL-terminated ls-tree -z output]' \
'--missing[allow missing objects]' \
'--batch[allow creation of more than one tree]'
}
(( $+functions[_git-pack-objects] )) ||
_git-pack-objects () {
local thin_opt=
if (( words[(I)--stdout] )); then
thin_opt='--thin[create a thin pack]'
fi
# NOTE: --index-version is only used by the Git test suite.
# TODO: --reflog is undocumented.
# TODO: --keep-unreachable is undocumented.
# TODO: --unpack-unreachable is undocumented.
_arguments -A '-*' \
'(: --max-pack-size)--stdout[write pack contents to standard output]' \
'--revs[read revision arguments from standard input]' \
'(--revs)--unpacked[limit objects to pack to those not already packed]' \
'(--revs)--all[include all refs as well as revisions already specified]' \
'--include-tag[include unasked-for annotated tags if object they reference is included]' \
'--window=-[number of objects to use per delta compression]: :__git_guard_number "window size"' \
'--depth=-[maximum delta depth]: :__git_guard_number "maximum delta depth"' \
'--window-memory=-[window size in memory]:window size:__git_guard_bytes' \
'(--stdout)--max-pack-size=[maximum size of each output packfile]:maximum pack size:__git_guard_bytes' \
'--honor-pack-keep[ignore objects in local pack with .keep file]' \
'( --local)--incremental[ignore objects that have already been packed]' \
'(--incremental )--local[similar to --incremental, but only ignore unpacked non-local objects]' \
'--non-empty[only create a package if it contains at least one object]' \
'( --all-progress)--progress[display progress on standard error]' \
'(--progress --all-progress-implied)--all-progress[display progress output on standard error, even during write-out phase]' \
'(--all-progress)--all-progress-implied[like --all-progress, but only if --progress was also passed]' \
'-q[do not report progress]' \
'--no-reuse-delta[do not reuse existing deltas, but compute them from scratch]' \
'--no-reuse-object[do not reuse existing object data]' \
'--compression=-[specify compression level]: :__git_compression_levels' \
$thin_opt \
'--delta-base-offset[use delta-base-offset packing]' \
'--threads=-[specify number of threads for searching for best delta matches]: :__git_guard_number "number of threads"' \
'--keep-true-parents[pack parents hidden by grafts]' \
'( --unpack-unreachable)--keep-unreachable[undocumented]' \
'(--keep-unreachable )--unpack-unreachable[undocumented]' \
':base-name:_files'
}
(( $+functions[_git-prune-packed] )) ||
_git-prune-packed () {
_arguments -w -S -s \
'(-n --dry-run)'{-n,--dry-run}'[only list objects that would be removed]' \
'(-q --quiet)'{-q,--quiet}'[do not display progress on standard error]'
}
(( $+functions[_git-read-tree] )) ||
_git-read-tree () {
local trivial_opt= aggressive_opt=
if (( words[(I)-m] )); then
trivial_opt='--trivial[restrict three-way merge to only happen if no file-level merging is required]'
aggressive_opt='--aggressive[try harder to resolve merge conflicts]'
fi
local -a ui_opts
if (( words[(I)(-m|--reset|--prefix)] )); then
ui_opts=(
'( -i)-u[update the work tree after successful merge]'
'(-u )-i[update only the index; ignore changes in work tree]')
fi
local exclude_per_directory_opt
if (( words[(I)-u] )); then
exclude_per_directory_opt='--exclude-per-directory=-[specify .gitignore file]:.gitignore file:_files'
fi
_arguments -w -S -s \
'( --reset --prefix)-m[perform a merge, not just a read]' \
'(-m --prefix)--reset[perform a merge, not just a read, ignoring unmerged entries]' \
'(-m --reset 2 3)--prefix=-[read the contents of specified tree-ish under specified directory]:prefix:_directories -r ""' \
$ui_opts \
'-v[display progress on standard error]' \
$trivial_opt \
$aggressive_opt \
$exclude_per_directory_opt \
'--index-output=[write index in the named file instead of $GIT_INDEX_FILE]: :_files' \
'--no-sparse-checkout[display sparse checkout support]' \
'1:first tree-ish to be read/merged:__git_tree_ishs' \
'2::second tree-ish to be read/merged:__git_tree_ishs' \
'3::third tree-ish to be read/merged:__git_tree_ishs'
}
(( $+functions[_git-symbolic-ref] )) ||
_git-symbolic-ref () {
_arguments -w -S -s \
'(-q --quiet)'{-q,--quiet}'[do not issue error if specified name is not a symbolic ref]' \
'-m[update reflog for specified name with specied reason]:reason for update' \
':symbolic reference:__git_heads' \
':: :__git_references'
}
(( $+functions[_git-unpack-objects] )) ||
_git-unpack-objects () {
_arguments \
'-n[only list the objects that would be unpacked]' \
'-q[run quietly]' \
'-r[try recovering objects from corrupt packs]' \
'--strict[do not write objects with broken content or links]'
}
(( $+functions[_git-update-index] )) ||
_git-update-index () {
local z_opt
if (( words[(I)--stdin|--index-info] )); then
z_opt='-z[paths are separated with NUL character when reading from stdin]'
fi
_arguments -S \
$refreshables \
'(-)'{-h,--help}'[display usage information]' \
'--add[add files not already in index]' \
'( --force-remove)--remove[remove files that are in the index but are missing from the work tree]' \
'(--remove )--force-remove[remove files from both work tree and index]' \
'(-q --unmerged --ignore-missing --really-refresh)--refresh[refresh index]' \
'-q[run quietly]' \
'--ignore-submodules[do not try to update submodules]' \
'--unmerged[if unmerged changes exists, ignore them instead of exiting]' \
'--ignore-missing[ignore missing files when refreshing the index]' \
'*--cacheinfo[insert information directly into the cache]: :_guard "[0-7]#" "octal file mode": :_guard "[[\:xdigit\:]]#" "object id": :_files' \
'(: -)--index-info[read index information from stdin]' \
'--chmod=-[set execute permissions on updated files]:permission:((-x\:executable +x\:"not executable"))' \
'( --no-assume-unchanged)--assume-unchanged[set "assume unchanged" bit for given paths]' \
'(--assume-unchanged )--no-assume-unchanged[unset "assume unchanged" bit for given paths]' \
'(-q --unmerged --ignore-missing --refresh)--really-refresh[refresh index, unconditionally checking stat information]' \
'( --no-skip-worktree)--skip-worktree[set "skip-worktree" bit for given paths]' \
'(--skip-worktree )--no-skip-worktree[unset "skip-worktree" bit for given paths]' \
'(-)'{-g,--again}'[run git-update-index on differing index entries]' \
'(-)--unresolve[restore "unmerged" or "needs updating" state of files]' \
'--info-only[only insert files object-IDs into index]' \
'(--remove)--force-remove[remove file from index even when working directory has no such file]' \
'--replace[replace files already in index, if necessary]' \
'(: -)--stdin[read list of paths from standard input]' \
'--verbose[report what is being added and removed from the index]' \
$z_opt \
'*:: :_files'
}
(( $+functions[_git-update-ref] )) ||
_git-update-ref () {
_arguments -w -S -s \
'-m[update reflog for specified name with specied reason]:reason for update' \
'(:)-d[delete given reference after verifying its value]:symbolic reference:__git_revisions:old reference:__git_revisions' \
'--no-deref[overwrite ref itself, not what it points to]' \
':symbolic reference:__git_revisions' \
':new reference:__git_revisions' \
'::old reference:__git_revisions'
}
(( $+functions[_git-write-tree] )) ||
_git-write-tree () {
# NOTE: --ignore-cache-tree is only used for debugging.
_arguments -w -S -s \
'--missing-ok[ignore objects in index that are missing in object database]' \
'--prefix=[write tree representing given sub-directory]:sub-directory:_directories -r ""'
}
# Interrogation commands
(( $+functions[_git-cat-file] )) ||
_git-cat-file () {
_arguments -w -S -s \
'(- 1)-t[show type of given object]' \
'(- 1)-s[show size of given object]' \
'(- 1)-e[exit with zero status if object exists]' \
'(- 1)-p[pretty-print given object]' \
'(- 1)--textconv[show content as transformed by a textconv filter]' \
'(- :)--batch[print SHA1, type, size, and contents of each object provided on stdin]' \
'(- :)--batch-check[print SHA1, type, and size of each object provided on stdin]' \
'(-):object type:(blob commit tag tree)' \
': :__git_objects'
}
(( $+functions[_git-diff-files] )) ||
_git-diff-files () {
declare -a revision_options
__git_setup_revision_options
_arguments -w -S -s \
$revision_options \
': :__git_changed-in-working-tree_files' \
': :__git_changed-in-working-tree_files' \
'*: :__git_changed-in-working-tree_files'
}
(( $+functions[_git-diff-index] )) ||
_git-diff-index () {
local -a revision_options
__git_setup_revision_options
# TODO: Description of -m doesnt match that for git-rev-list. Whats going
# on here?
# TODO: With --cached, shouldnt we only list files changed in index compared
# to given tree-ish? This should be done for git-diff as well, in that case.
_arguments -S \
$revision_options \
'--cached[do not consider the work tree at all]' \
'-m[flag non-checked-out files as up-to-date]' \
': :__git_tree_ishs' \
'*: :__git_cached_files'
}
(( $+functions[_git-diff-tree] )) ||
_git-diff-tree () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
declare -a revision_options
__git_setup_revision_options
# NOTE: -r, -t, --root are actually parsed for all
# __git_setup_revision_options, but only used by this command, so only have
# them here.
_arguments -w -C -S -s \
$revision_options \
'-r[recurse into subdirectories]' \
'(-r )-t[disply tree objects in diff output]' \
'--root[display root diff]' \
'-m[do not ignore merges]' \
'-s[do not show differences]' \
'(--pretty --header)-v[display commit message before differences]' \
'--no-commit-id[do not display commit IDs]' \
'(-c --cc)-c[show differences from each of parents to merge result]' \
'(-c --cc)--cc[how differences from each of parents and omit differences from only one parent]' \
'--always[always show commit itself and commit log message]' \
': :__git_tree_ishs' \
'*:: :->files' && ret=0
case $state in
(files)
if (( $#line > 2 )); then
# TODO: It would be better to output something like
#
# common files:
# ...
# original tree:
# ...
# new tree:
# ...
_alternative \
"original-tree-files:original tree:__git_tree_files ${PREFIX:-.} $line[1]" \
"new-tree-files:new tree:__git_tree_files ${PREFIX:-.} $line[2]" && ret=0
else
_alternative \
'tree-ishs::__git_tree_ishs' \
"tree-files::__git_tree_files ${PREFIX:-.} $line[1]" && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-for-each-ref] )) ||
_git-for-each-ref () {
# TODO: Better completion for --format: should complete %(field) stuff, that
# is, %(refname), %(objecttype), %(objectsize), %(objectname) with optional *
# in front.
_arguments -w -S -s \
'--count=[maximum number of refs to iterate over]: :__git_guard_number "maximum number of refs"' \
'--sort=[key to sort refs by]: :__git_ref_sort_keys' \
'--format=-[output format of ref information]:format' \
'(-s --shell -p --perl --python --tcl)'{-s,--shell}'[use string literals suitable for sh]' \
'(-s --shell -p --perl --python --tcl)'{-p,--perl}'[use string literals suitable for Perl]' \
'(-s --shell -p --perl --tcl)'--python'[use string literals suitable for Python]' \
'(-s --shell -p --perl --python )'--tcl'[use string literals suitable for Tcl]' \
':: :_guard "([^-]?#|)" pattern'
}
(( $+functions[_git-ls-files] )) ||
_git-ls-files () {
local no_empty_directory_opt=
if (( words[(I)--directory] )); then
no_empty_directory_opt='--no-empty-directory[do not list empty directories]'
fi
# TODO: --resolve-undo is undocumented.
# TODO: Replace _files with something more intelligent based on seen options.
# TODO: Apply excludes like we do for git-clean.
_arguments -w -S -s \
'(-c --cached)'{-c,--cached}'[show cached files in output]' \
'(-d --deleted)'{-d,--deleted}'[show deleted files in output]' \
'(-m --modified)'{-m,--modified}'[show modified files in output]' \
'(-o --others)'{-o,--others}'[show other files in output]' \
'(-i --ignored)'{-i,--ignored}'[show ignored files in output]' \
'(-s --stage --with-tree)'{-s,--stage}'[show stage files in output]' \
'--directory[if a whole directory is classified as "other", show just its name]' \
$no_empty_directory_opt \
'(-s --stage -u --unmerged --with-tree)'{-u,--unmerged}'[show unmerged files in output]' \
'(-k --killed)'{-k,--killed}'[show killed files in output]' \
'-z[use NUL termination on output]' \
'*'{-x,--exclude=-}'[skip files matching given pattern]:file pattern' \
'*'{-X,--exclude-from=-}'[skip files matching patterns in given file]: :_files' \
'*--exclude-per-directory=-[skip directories matching patterns in given file]: :_files' \
'--exclude-standard[skip files in standard Git exclusion lists]' \
'--error-unmatch[if any file does not appear in index, treat this as an error]' \
'(-s --stage -u --unmerged)--with-tree=[treat paths removed since given tree-ish as still present]: :__git_tree_ishs' \
'-v[identify each files status (hmrck?)]' \
'--full-name[force paths to be output relative to the project top directory]' \
'--abbrev=[set minimum SHA1 display-length]: :__git_guard_number length' \
'*:: :_files'
}
(( $+functions[_git-ls-remote] )) ||
_git-ls-remote () {
# TODO: repository needs fixing
_arguments -A '-*' \
'(-h --heads)'{-h,--heads}'[show only refs under refs/heads]' \
'(-t --tags)'{-t,--tags}'[show only refs under refs/tags]' \
'(-u --upload-pack)'{-u,--upload-pack=-}'[specify path to git-upload-pack on remote side]:remote path' \
': :__git_any_repositories' \
'*: :__git_references'
}
(( $+functions[_git-ls-tree] )) ||
_git-ls-tree () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -w -C -S -s \
'(-t)-d[do not show children of given tree (implies -t)]' \
'-r[recurse into subdirectories]' \
'-t[show tree entries even when going to recurse them]' \
'(-l --long)'{-l,--long}'[show object size of blob entries]' \
'-z[use NUL termination on output]' \
'(--name-only --name-status)'{--name-only,--name-status}'[list only filenames, one per line]' \
'--abbrev=[set minimum SHA1 display-length]: :__git_guard_number length' \
'--full-name[output full path-names]' \
'(--full-name)--full-tree[do not limit listing to current working-directory]' \
': :__git_tree_ishs' \
'*:: :->file' && ret=0
case $state in
(file)
__git_ignore_line __git_tree_files ${PREFIX:-.} $line[1] && ret=0
;;
esac
return ret
}
(( $+functions[_git-merge-base] )) ||
_git-merge-base () {
_arguments -w -S -s \
'(-a --all)'{-a,--all}'[display all common ancestors]' \
'--octopus[compute best common ancestors of all supplied commits]' \
'(-)--independent[display minimal subset of supplied commits with same ancestors]' \
': :__git_commits' \
'*: :__git_commits'
}
(( $+functions[_git-name-rev] )) ||
_git-name-rev () {
_arguments -S \
'--tags[only use tags to name commits]' \
'--refs=[only use refs matching given pattern]: :_guard "?#" "shell pattern"' \
'(--stdin :)--all[list all commits reachable from all refs]' \
'(--all :)--stdin[read from stdin and append revision-name]' \
'--name-only[display only name of commits]' \
'--no-undefined[die with non-zero return when a reference is undefined]' \
'--always[show uniquely abbreviated commit object as fallback]' \
'(--stdin --all)*: :__git_commits'
}
(( $+functions[_git-pack-redundant] )) ||
_git-pack-redundant () {
_arguments -S -A '-*' \
'(:)--all[process all packs]' \
'--alt-odb[do not require objects to be present in local packs]' \
'--verbose[output some statistics to standard error]' \
'(--all)*::packs:_files -g "*.pack(-.)"'
}
(( $+functions[_git-rev-list] )) ||
_git-rev-list () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
declare -a revision_options
__git_setup_revision_options
_arguments -C -S \
$revision_options \
'(--pretty)--header[display contents of commit in raw-format]' \
'--timestamp[print raw commit timestamp]' \
'( --bisect-vars --bisect-all)--bisect[show only middlemost commit object]' \
'(--bisect)--bisect-vars[same as --bisect, displaying shell-evalable code]' \
'(--bisect)--bisect-all[display all commit objects beteen included and excluded commits]' \
'*:: :->commit-or-path' && ret=0
case $state in
(commit-or-path)
# TODO: What paths should we be completing here?
if [[ -n ${opt_args[(I)--]} ]]; then
__git_cached_files && ret=0
else
_alternative \
'commit-ranges::__git_commit_ranges' \
'cached-files::__git_cached_files' && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-show-index] )) ||
_git-show-index () {
_message 'no arguments allowed; accepts index file on standard input'
}
(( $+functions[_git-show-ref] )) ||
_git-show-ref () {
_arguments -S \
- list \
'(-h --head)'{-h,--head}'[show HEAD reference]' \
'--tags[show only refs/tags]' \
'--heads[show only refs/heads]' \
'(-d --dereference)'{-d,--dereference}'[dereference tags into object IDs as well]' \
'(-s --hash)'{-s+,--hash=-}'[only show the SHA-1 hash, not the reference name]:: :__git_guard_number length' \
'--verify[enable stricter reference checking]' \
'--abbrev=[set minimum SHA1 display-length]: :__git_guard_number length' \
'(-q --quiet)'{-q,--quiet}'[do not print any results]' \
'*: :_guard "([^-]?#|)" pattern' \
- exclude \
'--exclude-existing=-[filter out existing refs from stdin]:: :_guard "([^-]?#|)" pattern'
}
(( $+functions[_git-unpack-file] )) ||
_git-unpack-file () {
_arguments -A '-*' \
'(:)-h[display usage information]' \
'(-): :__git_blobs'
}
(( $+functions[_git-var] )) ||
_git-var () {
_arguments \
'(:)-l[show logical variables]' \
'(-):variable:((GIT_AUTHOR_IDENT\:"name and email of author" \
GIT_COMMITTER_IDENT\:"name and email of committer" \
GIT_EDITOR\:"text editor used by git commands" \
GIT_PAGER\:"text viewer used by git commands"))'
}
(( $+functions[_git-verify-pack] )) ||
_git-verify-pack () {
_arguments -w -S -s \
'(-v --verbose)'{-v,--verbose}'[show objects contained in pack]' \
'(-s --stat-only)'{-s,--stat-only}'[do not verify pack contents; only display histogram of delta chain length]' \
'*:index file:_files -g "*.idx"'
}
# Synching Repositories
(( $+functions[_git-daemon] )) ||
_git-daemon () {
# TODO: do better than _directories? The directory needs to be a git-repository,
# so one could check for a required file in the given directory.
# TODO: --interpolated-path should complete %H, %CH, %IP, %P, and %D.
_arguments -S \
'--strict-paths[match paths exactly]' \
'--base-path=-[remap all the path requests as relative to the given path]:path:_directories' \
'--base-path-relaxed[allow lookup of base path witout prefix]' \
'--interpolated-path=-[dynamically construct alternate paths]:path:_directories' \
'--export-all[allow pulling from all repositories without verification]' \
'(--port --listen --user --group)--inetd[run server as an inetd service]' \
'(--inetd)--listen=-[listen on a specific IP address or hostname]: :_hosts' \
'(--inetd)--port=-[specify port to listen to]: :_ports' \
'--init-timeout=-[specify timeout between connection and request]: :__git_guard_number timeout' \
'--timeout=-[specify timeout for sub-requests]: :__git_guard_number timeout' \
'--max-connections=-[specify maximum number of concurrent clients]: :__git_guard_number "connection limit"' \
'--syslog[log to syslog instead of standard error]' \
'--user-path=-[allow ~user notation to be used in requests]::path:_directories' \
'--verbose[log details about incoming connections and requested files]' \
'--reuseaddr[reuse addresses when already bound]' \
'(--syslog)--detach[detach from the shell]' \
'--pid-file=-[save the process id in given file]:pid file:_files' \
'--user=-[set uid of daemon]: :_users' \
'--group=-[set gid of daemon]: :_groups' \
'--enable=-[enable site-wide service]: :__git_daemon_service' \
'--disable=-[disable site-wide service]: :__git_daemon_service' \
'--allow-override[allow overriding site-wide service]: :__git_daemon_service' \
'--forbid-override[forbid overriding site-wide service]: :__git_daemon_service' \
'*:repository:_directories'
}
(( $+functions[_git-fetch-pack] )) ||
_git-fetch-pack () {
# TODO: Limit * to __git_head_references?
_arguments -A '-*' \
'--all[fetch all remote refs]' \
'(-q --quiet)'{-q,--quiet}'[make output less verbose]' \
'(-k --keep)'{-k,--keep}'[do not invoke git-unpack-objects on received data]' \
'--thin[fetch a thin pack]' \
'--include-tag[download referenced annotated tags]' \
'(--upload-pack --exec)'{--upload-pack=-,--exec=-}'[specify path to git-upload-pack on remote side]:remote path' \
'--depth=-[limit fetching to ancestor-chains not longer than given number]: :__git_guard_number "maximum ancestor-chain length"' \
'--no-progress[do not display progress]' \
'-v[produce verbose output]' \
': :__git_any_repositories' \
'*: :__git_references'
}
(( $+functions[_git-http-backend] )) ||
_git-http-backend () {
_nothing
}
(( $+functions[_git-send-pack] )) ||
_git-send-pack () {
# TODO: --mirror is undocumented.
# TODO: --stateless-rpc is undocumented.
# TODO: --helper-status is undocumented.
_arguments -A '-*' \
'(--receive-pack --exec)'{--receive-pack=-,--exec=-}'[specify path to git-receive-pack on remote side]:remote path' \
'--all[update all refs that exist locally]' \
'--dry-run[do everything except actually sending the updates]' \
'--force[update remote orphaned refs]' \
'-v[produce verbose output]' \
'--thin[send a thin pack]' \
'--mirror[undocumented]' \
'--stateless-rpc[undocumented]' \
'--helper-status[undocumented]' \
': :__git_any_repositories' \
'*: :__git_remote_references'
}
(( $+functions[_git-update-server-info] )) ||
_git-update-server-info () {
_arguments -w -S -s \
'(-f --force)'{-f,--force}'[update the info files from scratch]'
}
(( $+functions[_git-http-fetch] )) ||
_git-http-fetch () {
_arguments \
'-c[fetch commit objects]' \
'-t[fetch trees associated with commit objects]' \
'-a[fetch all objects]' \
'-v[report what is downloaded]' \
'-w[write commit-id into the filename under "$GIT_DIR/refs/<filename>"]:filename' \
'--recover[recover from a failed fetch]' \
'(1)--stdin[read commit ids and refs from standard input]' \
': :__git_commits' \
': :_urls'
}
(( $+functions[_git-http-push] )) ||
_git-http-push () {
_arguments \
'--all[verify that all objects in local ref history exist remotely]' \
'--force[allow refs that are not ancestors to be updated]' \
'--dry-run[do everything except actually sending the updates]' \
'--verbose[report the list of objects being walked locally and sent to remote]' \
'( -D)-d[remove refs from remote repository]' \
'(-d )-D[forcefully remove refs from remote repository]' \
': :_urls' \
'*: :__git_remote_references'
}
# NOTE: git-parse-remote isnt a user command.
(( $+functions[_git-receive-pack] )) ||
_git-receive-pack () {
# TODO: --advertise-refs is undocumented.
# TODO: --stateless-rpc is undocumented.
_arguments -A '-*' \
'--advertise-refs[undocumented]' \
'--stateless-rpc[undocumented]' \
':directory to sync into:_directories'
}
(( $+functions[_git-shell] )) ||
_git-shell () {
local curcontext=$curcontext state line ret=1
declare -A opt_args
_arguments -C \
'-c[command to execute]: :->command' \
': :->argument' && ret=0
case $state in
(command)
declare -a commands
commands=(
git-receive-pack
git-upload-pack
git-upload-archive
cvs)
_describe -t commands command commands && ret=0
;;
(argument)
case $line[1] in
(git-receive-pack)
local expl
_description directories expl 'directory to sync into'
_directories $expl && ret=0
;;
(git-upload-pack|git-upload-archive)
local expl
_description directories expl 'directory to sync from'
_directories $expl && ret=0
;;
(cvs)
compadd - server && ret=0
esac
;;
esac
return ret
}
(( $+functions[_git-upload-archive] )) ||
_git-upload-archive () {
_arguments \
':directory to get tar archive from:_directories'
}
(( $+functions[_git-upload-pack] )) ||
_git-upload-pack () {
# TODO: --advertise-refs is undocumented.
# TODO: --stateless-rpc is undocumented.
_arguments -S -A '-*' \
'--strict[do not try <directory>/.git/ if <directory> is not a git directory' \
'--timeout=-[interrupt transfer after given number of seconds of inactivity]: :__git_guard_number "inactivity timeout"' \
'--advertise-refs[undocumented]' \
'--stateless-rpc[undocumented]' \
': :_directories'
}
# Internal Helper Commands
(( $+functions[_git-check-attr] )) ||
_git-check-attr () {
local z_opt=
local curcontext=$curcontext state line ret=1
declare -A opt_args
if (( words[(I)--stdin] )); then
z_opt='-z[paths are separated with NUL character when reading from stdin]'
fi
_arguments -C \
'--stdin[read file names from stdin instead of from command line]' \
$z_opt \
'(-)--[interpret preceding arguments as attributes and following arguments as path names]' \
'*:: :->attribute-or-file' && ret=0
case $state in
(attribute-or-file)
local -a attributes
attributes=(crlf ident filter diff merge)
local only_attributes=1
for (( i = 2; i < $#words; i++ )); do
if (( attributes[(I)$words[i]] == 0 )); then
only_attributes=0
break
fi
done
if (( !only_attributes )) || [[ -n ${opt_args[(I)--]} ]]; then
__git_cached_files && ret=0
else
_alternative \
'attributes::__git_attributes' \
'files::__git_cached_files' && ret=0
fi
;;
esac
return ret
}
(( $+functions[_git-check-ref-format] )) ||
_git-check-ref-format () {
_arguments \
'-h[display usage information]' \
'--print[display canonicalized name of hypothetical reference of given name]' \
'--branch[expand previous branch syntax]' \
': :__git_references'
}
(( $+functions[_git-fmt-merge-msg] )) ||
_git-fmt-merge-msg () {
_arguments -w -S -s \
'( --no-log)--log[display one-line descriptions from actual commits being merged]' \
'(--log )--no-log[do not display one-line descriptions from actual commits being merged]' \
'(-m --message)'{-m+,--message=}'[use given message instead of branch names for first line in log message]:message' \
'(-F --file)'{-F,--file}'[specify list of merged objects from file]: :_files'
}
(( $+functions[_git-mailinfo] )) ||
_git-mailinfo () {
# TODO: --no-inbody-headers is undocumented.
_arguments -A '-*' \
'-k[do not strip/add \[PATCH\] from first line of commit message]' \
'(-u --encoding)-u[encode commit information in UTF-8]' \
'(-u --encoding)--encoding=-[encode commit information in given encoding]: :__git_encodings' \
'-n[disable all charset re-coding of metadata]' \
'( --no-scissors)--scissors[remove everything in body before a scissors line]' \
'(--scissors )--no-scissors[do not remove everything in body before a scissors line]' \
'--no-inbody-headers[undocumented]' \
':message file:_files' \
':patch file:_files'
}
(( $+functions[_git-mailsplit] )) ||
_git-mailsplit () {
_arguments -S -A '-*' \
'-o-[directory in which to place individual messages]:directory:_directories' \
'-b[if file does not begin with "From " line, assume it is a single mail message]' \
'-d-[specify number of leading zeros]: :__git_guard_number precision' \
'-f-[skip the first N numbers]: :__git_guard_number' \
'--keep-cr[do not remove CR from lines ending with CR+LF]' \
'*::mbox file:_files'
}
(( $+functions[_git-merge-one-file] )) ||
_git-merge-one-file () {
_message 'you probably should not be issuing this command'
}
(( $+functions[_git-patch-id] )) ||
_git-patch-id () {
_message 'no arguments allowed; accepts patch on standard input'
}
# NOTE: git-sh-setup isnt a user command.
(( $+functions[_git-stripspace] )) ||
_git-stripspace () {
_arguments \
'(-s --strip-comments)'{-s,--strip-comments}'[also strip lines starting with #]'
}
# INTERNAL GIT COMPLETION FUNCTIONS
# Generic Helpers
(( $+functions[__git_command_successful] )) ||
__git_command_successful () {
if (( ${#*:#0} > 0 )); then
_message 'not a git repository'
return 1
fi
return 0
}
(( $+functions[__git_committish_range_first] )) ||
__git_committish_range_first () {
print -r -- ${1%..(.|)*}
}
(( $+functions[__git_committish_range_last] )) ||
__git_committish_range_last () {
print -r -- ${1##*..(.|)}
}
(( $+functions[__git_pattern_escape] )) ||
__git_pattern_escape () {
print -r -n ${1//(#m)[\[\]()\\*?#<>~\^]/\\$MATCH}
}
(( $+functions[__git_is_type] )) ||
__git_is_type () {
git rev-parse -q --verify "$2^{$1}" 2>/dev/null >/dev/null
}
(( $+functions[__git_is_blob] )) ||
__git_is_blob () {
__git_is_type blob $1
}
(( $+functions[__git_is_committish] )) ||
__git_is_committish () {
__git_is_type commit $1
}
(( $+functions[__git_is_treeish] )) ||
__git_is_treeish () {
__git_is_type tree $1
}
(( $+functions[__git_is_committish_range] )) ||
__git_is_committish_range () {
# TODO: This isnt quite right. We would like to do parts=${(~s:..(.|))},
# but that doesnt work. (This would allow us to make sure that parts only
# contains two elements and then apply __git_is_committish on them.
[[ $1 == *..(.|)* ]] &&
__git_is_committish $(__git_committish_range_first $1) &&
__git_is_committish $(__git_committish_range_last $1)
}
(( $+functions[__git_is_initial_commit] )) ||
__git_is_initial_commit () {
git rev-parse -q --verify HEAD >/dev/null 2>/dev/null
(( $? == 1 ))
}
(( $+functions[__git_is_in_middle_of_merge] )) ||
__git_is_in_middle_of_merge () {
local gitdir
gitdir=$(_call_program gitdir git rev-parse --git-dir 2>/dev/null)
__git_command_successful $pipestatus || return
[[ -f $gitdir/MERGE_HEAD ]]
}
# Completion Wrappers
(( $+functions[__git_ignore_line] )) ||
__git_ignore_line () {
declare -a ignored
ignored=()
((CURRENT > 1)) &&
ignored+=(${line[1,CURRENT-1]//(#m)[\[\]()\\*?#<>~\^]/\\$MATCH})
((CURRENT < $#line)) &&
ignored+=(${line[CURRENT+1,-1]//(#m)[\[\]()\\*?#<>~\^]/\\$MATCH})
$* -F ignored
}
(( $+functions[__git_ignore_line_inside_arguments] )) ||
__git_ignore_line_inside_arguments () {
declare -a compadd_opts
zparseopts -D -E -a compadd_opts V: J: 1 2 n f X: M: P: S: r: R: q F:
__git_ignore_line $* $compadd_opts
}
# Common Argument Types
(( $+functions[_git_commands] )) ||
_git_commands () {
local -a main_porcelain_commands
main_porcelain_commands=(
add:'add file contents to index'
am:'apply patches from a mailbox'
archive:'create archive of files from named tree'
bisect:'find, by binary search, change that introduced a bug'
branch:'list, create, or delete branches'
bundle:'move objects and refs by archive'
checkout:'checkout branch or paths to working tree'
cherry-pick:'apply changes introduced by some existing commits'
citool:'graphical alternative to git commit'
clean:'remove untracked files from working tree'
clone:'clone repository into new directory'
commit:'record changes to repository'
describe:'show most recent tag that is reachable from a commit'
diff:'show changes between commits, commit and working tree, etc.'
fetch:'download objects and refs from another repository'
format-patch:'prepare patches for e-mail submission'
gc:'cleanup unnecessary files and optimize local repository'
grep:'print lines matching a pattern'
gui:'run portable graphical interface to git'
init:'create empty git repository or re-initialize an existing one'
log:'show commit logs'
merge:'join two or more development histories together'
mv:'move or rename file, directory, or symlink'
notes:'add or inspect object notes'
pull:'fetch from and merge with another repository or local branch'
push:'update remote refs along with associated objects'
rebase:'fasforward-port local commits to the updated upstream head'
reset:'reset current HEAD to specified state'
revert:'revert existing commits'
rm:'remove files from the working tree and from the index'
shortlog:'summarize git log output'
show:'show various types of objects'
stash:'stash away changes to dirty working directory'
status:'show working-tree status'
submodule:'initialize, update, or inspect submodules'
tag:'create, list, delete or verify tag object signed with GPG')
local -a ancillary_manipulator_commands
ancillary_manipulator_commands=(
config:'get and set repository or global options'
fast-export:'data exporter'
fast-import:'import information into git directly'
filter-branch:'rewrite branchers'
mergetool:'run merge conflict resolution tools to resolve merge conflicts'
pack-refs:'pack heads and tags for efficient repository access'
prune:'prune all unreachable objects from the object database'
reflog:'manage reflog information'
relink:'hardlink common objects in local repositories'
remote:'manage set of tracked repositories'
repack:'pack unpacked objects in a repository'
replace:'create, list, delete refs to replace objects')
local -a ancillary_interrogator_commands
ancillary_interrogator_commands=(
blame:'show what revision and author last modified each line of a file'
cherry:'find commits not merged upstream'
count-objects:'count unpacked objects and display their disk consumption'
difftool:'show changes using common diff tools'
fsck:'verify connectivity and validity of objects in database'
get-tar-commit-id:'extract commit ID from an archive created using git archive'
help:'display help information about git'
instaweb:'instantly browse your working repository in gitweb'
merge-tree:'show three-way merge without touching index'
rerere:'reuse recorded resolution of conflicted merges'
rev-parse:'pick out and massage parameters for other git commands'
show-branch:'show branches and their commits'
verify-tag:'check GPG signature of tags'
whatchanged:'show commit-logs and differences they introduce')
local -a interaction_commands
interaction_commands=(
archimport:'import an Arch repository into git'
cvsexportcommit:'export a single commit to a CVS checkout'
cvsimport:'import a CVS "repository" into a git repository'
cvsserver:'run a CVS server emulator for git'
imap-send:'send a collection of patches to an IMAP folder'
quiltimport:'apply a quilt patchset'
request-pull:'generate summary of pending changes'
send-email:'send collection of patches as emails'
svn:'bidirectional operation between a Subversion repository and git')
local -a plumbing_manipulator_commands
plumbing_manipulator_commands=(
apply:'apply patch to files and/or to index'
checkout-index:'copy files from index to working directory'
commit-tree:'create new commit object'
hash-object:'compute object ID and optionally create a blob from a file'
index-pack:'build pack index file for an existing packed archive'
merge-file:'run a three-way file merge'
merge-index:'run merge for files needing merging'
mktag:'create tag object'
mktree:'build tree-object from git ls-tree formatted text'
pack-objects:'create packed archive of objects'
prune-packed:'remove extra objects that are already in pack files'
read-tree:'read tree information into directory index'
symbolic-ref:'read and modify symbolic references'
unpack-objects:'unpack objects from packed archive'
update-index:'register file contents in the working directory to the index'
update-ref:'update object name stored in a reference safely'
write-tree:'create tree from the current index')
local -a plumbing_interrogator_commands
plumbing_interrogator_commands=(
cat-file:'provide content or type information for repository objects'
diff-files:'compare files in working tree and index'
diff-index:'compare content and mode of blobs between index and repository'
diff-tree:'compare content and mode of blobs found via two tree objects'
for-each-ref:'output information on each ref'
ls-files:'information about files in index/working directory'
ls-remote:'show references in a remote repository'
ls-tree:'list contents of a tree object'
merge-base:'find as good a common ancestor as possible for a merge'
name-rev:'find symbolic names for given revisions'
pack-redundant:'find redundant pack files'
rev-list:'list commit object in reverse chronological order'
show-index:'show packed archive index'
show-ref:'list references in a local repository'
unpack-file:'create temporary file with blob'\''s contents'
var:'show git logical variable'
verify-pack:'validate packed git archive files')
local -a plumbing_sync_commands
plumbing_sync_commands=(
daemon:'run a really simple server for git repositories'
fetch-pack:'receive missing objects from another repository'
http-backend:'run a server side implementation of Git over HTTP'
send-pack:'push objects over git protocol to another repository'
update-server-info:'update auxiliary information file to help dumb servers')
local -a plumbing_sync_helper_commands
plumbing_sync_helper_commands=(
http-fetch:'download from remote git repository via HTTP'
http-push:'push objects over HTTP/DAV to another repository'
parse-remote:'routines to help parsing remote repository access parameters'
receive-pack:'receive what is pushed into repository'
shell:'restricted login shell for GIT-only SSH access'
upload-archive:'send archive back to git-archive'
upload-pack:'send objects packed back to git fetch-pack')
local -a plumbing_internal_helper_commands
plumbing_internal_helper_commands=(
check-attr:'display gitattributes information'
check-ref-format:'ensure that a reference name is well formed'
fmt-merge-msg:'produce merge commit message'
mailinfo:'extract patch and authorship from a single email message'
mailsplit:'split mbox file into a list of files'
merge-one-file:'standard helper-program to use with git merge-index'
patch-id:'compute unique ID for a patch'
stripspace:'filter out empty lines')
local -a user_commands
zstyle -a :completion:$curcontext: user-commands user_commands
local -a third_party_commands
local command
for command in $_git_third_party_commands; do
(( $+commands[git-${command%%:*}] )) && third_party_commands+=$command
done
local -a aliases unique_aliases
__git_extract_aliases
local alias
for alias in $aliases; do
local name=${alias%%:*}
(( main_porcelain_commands[(I)$name:*] ||
user_commands[(I)$name:*] ||
third_party_commands[(I)$name:*] ||
ancillary_manipulator_commands[(I)$name:*] ||
ancillary_interrogator_commands[(I)$name:*] ||
interaction_commands[(I)$name:*] ||
plumbing_manipulator_commands[(I)$name:*] ||
plumbing_interrogator_commands[(I)$name:*] ||
plumbing_sync_commands[(I)$name:*] ||
plumbing_sync_helper_commands[(I)$name:*] ||
plumbing_internal_helper_commands[(I)$name:*] )) || unique_aliases+=$alias
done
integer ret=1
# TODO: Is this the correct way of doing it? Should we be using _alternative
# and separate functions for each set of commands instead?
_describe -t aliases alias unique_aliases && ret=0
_describe -t main-porcelain-commands 'main porcelain command' main_porcelain_commands && ret=0
_describe -t user-commands 'user command' user_commands && ret=0
_describe -t third-party-commands 'third-party command' third_party_commands && ret=0
_describe -t ancillary-manipulator-commands 'ancillary manipulator command' ancillary_manipulator_commands && ret=0
_describe -t ancillary-interrogator-commands 'ancillary interrogator command' ancillary_interrogator_commands && ret=0
_describe -t interaction-commands 'interaction command' interaction_commands && ret=0
_describe -t plumbing-manipulator-commands 'plumbing manipulator command' plumbing_manipulator_commands && ret=0
_describe -t plumbing-interrogator-commands 'plumbing interrogator command' plumbing_interrogator_commands && ret=0
_describe -t plumbing-sync-commands 'plumbing sync command' plumbing_sync_commands && ret=0
_describe -t plumbing-sync-helper-commands 'plumbing sync helper command' plumbing_sync_helper_commands && ret=0
_describe -t plumbing-internal-helper-commands 'plumbing internal helper command' plumbing_internal_helper_commands && ret=0
return ret
}
(( $+functions[__git_aliases] )) ||
__git_aliases () {
local -a aliases
__git_extract_aliases
_describe -t aliases alias aliases $*
}
(( $+functions[__git_extract_aliases] )) ||
__git_extract_aliases () {
aliases=(${^${${(0)"$(_call_program aliases "git config -z --get-regexp '^alias.'")"}#alias.}/$'\n'/:alias for \'}\')
}
(( $+functions[__git_date_formats] )) ||
__git_date_formats () {
declare -a date_formats
date_formats=(
relative:'show dates relative to the current time'
local:'show timestamps in local timezone'
iso:'show timestamps in ISO 8601 format'
rfc:'show timestamps in RFC 2822 format'
short:'show only date but not time'
raw:'show date in internal raw git format (%s %z)'
default:'show timestamp in the original timezone')
_describe -t date-formats 'date format' date_formats $*
}
(( $+functions[__git_gpg_secret_keys] )) ||
__git_gpg_secret_keys () {
local expl
_wanted secret-keys expl 'secret key' compadd \
${${(Mo)$(_call_program secret-keys gpg --list-secret-keys 2>/dev/null):%<*>}//(<|>)/}
}
(( $+functions[__git_merge_strategies] )) ||
__git_merge_strategies () {
local expl
local -a merge_strategies
merge_strategies=(${=${${(M)${(f)"$(_call_program merge-strategies "git merge -s '' 2>&1")"}:#[Aa]vailable (custom )#strategies are: *}#[Aa]vailable (custom )#strategies are: }%.})
__git_command_successful $pipestatus || return 1
_wanted merge-strategies expl 'merge strategy' compadd $* - $merge_strategies
}
(( $+functions[__git_encodings] )) ||
__git_encodings () {
# TODO: Use better algorithm, as shown in iconv completer (separate it to a
# new Type).
local expl
_wanted encodings expl 'encoding' compadd "$@" \
-M 'm:{a-zA-Z}={A-Za-z} r:|-=* r:|=*' \
${${${(f)"$(_call_program encodings iconv --list)"}## #}%//}
}
(( $+functions[__git_apply_whitespace_strategies] )) ||
__git_apply_whitespace_strategies () {
declare -a strategies
strategies=(
'nowarn:turn off the trailing-whitespace warning'
'warn:output trailing-whitespace warning, but apply patch'
'fix:output trailing-whitespace warning and strip trailing whitespace'
'error:output trailing-whitespace warning and refuse to apply patch'
'error-all:same as "error", but output warnings for all files')
_describe -t strategies 'trailing-whitespace resolution strategy' strategies $*
}
(( $+functions[__git_remotes] )) ||
__git_remotes () {
local remotes expl
remotes=(${(f)"$(_call_program remotes git remote 2>/dev/null)"})
_wanted remotes expl remote compadd $* - $remotes
}
(( $+functions[__git_ref_specs] )) ||
__git_ref_specs () {
# TODO: This needs to deal with a lot more types of things.
if compset -P '*:'; then
__git_heads
else
compset -P '+'
if compset -S ':*'; then
__git_heads
else
_alternative \
'commit-tags::__git_commit_tags' \
'heads::__git_heads -qS :'
fi
fi
}
(( $+functions[__git_color_whens] )) ||
__git_color_whens () {
local -a whens
whens=(
'always:always use colors'
'never:never use colors'
'auto:use colors if output is to a terminal')
_describe -t whens when whens $*
}
(( $+functions[__git_ignore_submodules_whens] )) ||
__git_ignore_submodules_whens () {
local -a whens
whens=(
none:'submodule is dirty when it contains untracked or modified files'
untracked:'submodule is dirty when it contains untracket files'
dirty:'ignore all changes to submodules, showing only changes to commits stored in superproject'
all:'ignore all changes to submodules (default)')
_describe -t whens when whens $*
}
# (Currently) Command-specific Argument Types
(( $+functions[__git_archive_formats] )) ||
__git_archive_formats () {
local expl
_wanted archive-formats expl 'archive format' \
compadd $* - ${${(f)"$(_call_program archive-formats git archive --list)"}}
}
(( $+functions[__git_compression_levels] )) ||
__git_compression_levels () {
__git_config_values -t compression-levels -l 'compression level' -- "$current" "$parts[5]" \
'-1:default level of compression' \
'0:do not deflate files' \
'1:minimum compression' \
'2:a little more compression' \
'3:slightly more compression' \
'4:a bit more compression' \
'5:even more compression' \
'6:slightly even more compression' \
'7:getting there' \
'8:close to maximum compression' \
'9:maximum compression'
}
(( $+functions[__git_attributes] )) ||
__git_attributes () {
local -a attributes
attributes=(
'crlf:line-ending convention'
'ident:ident substitution'
'filter:filters'
'diff:textual diff'
'merge:merging strategy')
_describe -t attributes attribute attributes $*
}
(( $+functions[__git_daemon_service] )) ||
__git_daemon_service () {
local -a services
services=(
'upload-pack:serve git fetch-pack and git ls-remote clients'
'upload-archive:serve git archive --remote clients')
_describe -t services service services $*
}
(( $+functions[__git_log_decorate_formats] )) ||
__git_log_decorate_formats () {
declare -a log_decorate_formats
log_decorate_formats=(
short:'do not show ref name prefixes'
full:'show ref name prefixes'
no:'do not show ref names')
_describe -t log-decorate-formats 'log decorate format' log_decorate_formats $*
}
(( $+functions[__git_repository_permissions] )) ||
__git_repository_permissions () {
if [[ -prefix [0-7] ]]; then
_message -e number 'numeric mode'
else
declare -a permissions
permissions=(
{umask,false,no,off}':use permissions reported by umask()'
{group,true,yes,on}':files and objects are group-writable'
{all,world,everybody}':files and objects are readable by all users and group-shareable')
_describe -t permissions permission permissions $*
fi
}
(( $+functions[__git_reflog_entries] )) ||
__git_reflog_entries () {
local expl
declare -a reflog_entries
reflog_entries=(${${${(f)"$(_call_program reflog-entries git reflog 2>/dev/null)"}#* }%%:*})
__git_command_successful $pipestatus || return 1
if compset -P '*@'; then
reflog_entries=(${${(M)reflog_entries:#$IPREFIX*}#$IPREFIX})
_wanted reflog-entries expl 'reflog entry' compadd $* - $reflog_entries
else
reflog_entries=(${reflog_entries%@*})
_wanted reflog-entries expl 'reflog entry' compadd -qS @ $* - $reflog_entries
fi
}
(( $+functions[__git_ref_sort_keys] )) ||
__git_ref_sort_keys () {
compset -P '-'
local -a sort_keys
# TODO: numparent is undocumented.
sort_keys=(
'refname:the name of the ref'
'objecttype:the type of the object'
'objectsize:the size of the object'
'objectname:the object name (SHA-1)'
'tree:the tree header-field'
'parent:the parent header-field'
'numparent:undocumented'
'object:the object header-field'
'type:the type header-field'
'tag:the tag header-field'
'author:the author header-field'
'authorname:the name component of the author header-field'
'authoremail:the email component of the author header-field'
'authordate:the date component of the author header-field'
'committername:the name component of the committer header-field'
'committeremail:the email component of the committer header-field'
'committerdate:the date component of the committer header-field'
'taggername:the name component of the tagger header-field'
'taggeremail:the email component of the tagger header-field'
'taggerdate:the date component of the tagger header-field'
'creatorname:the name component of the creator header-field'
'creatordate:the date component of the creator header-field'
'subject:the subject of the message'
'body:the body of the message'
'body:the contents of the message (subject and body)')
_describe -t sort-keys 'sort key' sort_keys $*
}
(( $+functions[__git_signoff_file] )) ||
__git_signoff_file () {
_alternative \
'signoffs:signoff:(yes true me please)' \
'files:signoff file:_files'
}
(( $+functions[__git_stashes] )) ||
__git_stashes () {
local expl
declare -a stashes
stashes=(${${(f)"$(_call_program stashes git stash list 2>/dev/null)"}/: */})
__git_command_successful $pipestatus || return 1
_wanted stashes expl stash compadd $* - $stashes
}
(( $+functions[__git_svn_revisions] )) ||
__git_svn_revisions () {
if [[ -prefix *: ]]; then
compset -P '*:'
_alternative \
'revision-numbers::__git_svn_revision_numbers' \
'symbolic-revisions:symbolic revision:((HEAD:"the topmost revision of the SVN repository"))'
else
_alternative \
'revision-numbers::__git_svn_revision_numbers' \
'symbolic-revisions:symbolic revision:__git_svn_base_revisions'
fi
}
(( $+functions[__git_svn_base_revisions] )) ||
__git_svn_base_revisions () {
declare -a symbolic_revisions
symbolic_revisions=(
'BASE:the bottommost revision of the SVN repository')
# TODO: How do we deal with $*?
_describe -t symbolic-revisions 'symbolic revision' symbolic_revisions -S ':' -r ': '
}
# Object Type Argument Types
(( $+functions[__git_branch_names] )) ||
__git_branch_names () {
local expl
declare -a branch_names
branch_names=(${${(f)"$(_call_program branchrefs git for-each-ref --format='"%(refname)"' refs/heads 2>/dev/null)"}#refs/heads/})
__git_command_successful $pipestatus || return 1
_wanted branch-names expl branch-name compadd $* - $branch_names
}
(( $+functions[__git_remote_branch_names] )) ||
__git_remote_branch_names () {
local expl
declare -a branch_names
branch_names=(${${(f)"$(_call_program remote-branch-refs git for-each-ref --format='"%(refname)"' refs/remotes 2>/dev/null)"}#refs/remotes/})
__git_command_successful $pipestatus || return 1
_wanted remote-branch-names expl 'remote branch name' compadd $* - $branch_names
}
(( $+functions[__git_commits] )) ||
__git_commits () {
# TODO: deal with things that __git_heads and __git_tags has in common (i.e.,
# if both exists, they need to be completed to heads/x and tags/x.
_alternative \
'heads::__git_heads' \
'commit-tags::__git_commit_tags' \
'commit-objects::__git_commit_objects'
}
(( $+functions[__git_heads] )) ||
__git_heads () {
local gitdir expl start
declare -a heads
heads=(${${(f)"$(_call_program headrefs git for-each-ref --format='"%(refname)"' refs/heads refs/remotes 2>/dev/null)"}#refs/(heads|remotes)/})
gitdir=$(_call_program gitdir git rev-parse --git-dir 2>/dev/null)
if __git_command_successful $pipestatus; then
for f in HEAD FETCH_HEAD ORIG_HEAD MERGE_HEAD; do
[[ -f $gitdir/$f ]] && heads+=$f
done
fi
_wanted heads expl head compadd $* - $heads
}
(( $+functions[__git_commit_objects] )) ||
__git_commit_objects () {
_guard '[[:xdigit:]](#c,40)' 'commit object name'
}
(( $+functions[__git_blob_objects] )) ||
__git_blob_objects () {
_guard '[[:xdigit:]](#c,40)' 'blob object name'
}
(( $+functions[__git_blobs] )) ||
__git_blobs () {
_alternative \
'blob-tags::__git_blob_tags' \
'blob-objects::__git_blob_objects'
}
(( $+functions[__git_blobs_and_trees_in_treeish] )) ||
__git_blobs_and_trees_in_treeish () {
compset -P '*:'
[[ -n ${IPREFIX} ]] || return 1
if [[ -n ${IPREFIX%:} ]]; then
__git_is_treeish ${IPREFIX%:} && __git_tree_files ${PREFIX:-.} ${IPREFIX%:}
else
__git_changed-in-index_files
fi
}
(( $+functions[__git_committishs] )) ||
__git_committishs () {
__git_commits
}
(( $+functions[__git_revisions] )) ||
__git_revisions () {
# TODO: deal with prefixes and suffixes listed in git-rev-parse
__git_commits $*
}
(( $+functions[__git_commits2] )) ||
__git_commits2 () {
compset -P '\\\^'
__git_commits
}
(( $+functions[__git_commit_ranges] )) ||
__git_commit_ranges () {
if compset -P '*..(.|)'; then
__git_commits $*
else
__git_commits $* -qS ..
fi
}
(( $+functions[__git_commit_ranges2] )) ||
__git_commit_ranges2 () {
_alternative \
'commits::__git_commits2' \
'ranges::__git_commit_ranges'
}
(( $+functions[__git_trees] )) ||
__git_trees () {
__git_objects
}
(( $+functions[__git_tree_ishs] )) ||
__git_tree_ishs () {
__git_commits
}
(( $+functions[__git_objects] )) ||
__git_objects () {
compset -P '*:'
if [[ -n $IPREFIX ]]; then
__git_tree_files "$PREFIX" "${IPREFIX%:}"
else
_alternative \
'revisions::__git_revisions' \
'files::__git_cached_files'
fi
}
(( $+functions[__git_submodules] )) ||
__git_submodules () {
local expl
declare -a submodules
submodules=(${${(f)"$(_call_program submodules git submodule 2>/dev/null)"}#* })
__git_command_successful $pipestatus || return 1
_wanted submodules expl submodule compadd $* - $submodules
}
# Tag Argument Types
(( $+functions[__git_tags] )) ||
__git_tags () {
local expl
declare -a tags
tags=(${${(f)"$(_call_program tagrefs git for-each-ref --format='"%(refname)"' refs/tags 2>/dev/null)"}#refs/tags/})
__git_command_successful $pipestatus || return 1
_wanted tags expl tag compadd $* - $tags
}
(( $+functions[__git_commit_tags] )) ||
__git_commit_tags () {
__git_tags_of_type commit $*
}
(( $+functions[__git_blob_tags] )) ||
__git_blob_tags () {
__git_tags_of_type blob $*
}
(( $+functions[__git_tags_of_type] )) ||
__git_tags_of_type () {
local type expl
declare -a tags
type=$1; shift
tags=(${${(M)${(f)"$(_call_program $type-tag-refs "git for-each-ref --format='%(*objecttype)%(objecttype) %(refname)' refs/tags 2>/dev/null")"}:#$type(tag|) *}#$type(tag|) refs/tags/})
__git_command_successful $pipestatus || return 1
_wanted $type-tags expl "$type tag" compadd $* - $tags
}
# Reference Argument Types
(( $+functions[__git_references] )) ||
__git_references () {
local expl
# TODO: depending on what options are on the command-line already, complete
# only tags or heads
# TODO: perhaps caching is unnecessary. usually wont contain that much data
# TODO: perhaps provide alternative here for both heads and tags (and use
# __git_heads and __git_tags)
# TODO: instead of "./.", we should be looking in the repository specified as
# an argument to the command (but default to "./." I suppose (why not "."?))
# TODO: deal with GIT_DIR
if [[ $_git_refs_cache_pwd != $PWD ]]; then
_git_refs_cache=(${${${(f)"$(_call_program references git ls-remote ./. 2>/dev/null)"}#*$'\t'}#refs/(heads|tags)/})
__git_command_successful $pipestatus || return 1
_git_refs_cache_pwd=$PWD
fi
_wanted references expl 'references' compadd - $_git_refs_cache
}
(( $+functions[__git_local_references] )) ||
__git_local_references () {
local expl
if [[ $_git_local_refs_cache_pwd != $PWD ]]; then
_git_local_refs_cache=(${${${(f)"$(_call_program references git ls-remote ./. 2>/dev/null)"}#*$'\t'}#refs/})
__git_command_successful $pipestatus || return 1
_git_local_refs_cache_pwd=$PWD
fi
_wanted references expl 'references' compadd - $_git_local_refs_cache
}
(( $+functions[__git_remote_references] )) ||
__git_remote_references () {
__git_references
}
(( $+functions[__git_note_references] )) ||
__git_local_references () {
local references expl
references=(${${(M)${${(f)"$(_call_program references git ls-remote ./. 2>/dev/null)"}#*$'\t'}:#refs/notes/*}#refs/notes/})
__git_command_successful $pipestatus || return 1
_wanted references expl reference compadd - $references
}
(( $+functions[__git_notes_refs] )) ||
__git_notes_refs () {
local expl
declare -a notes_refs
notes_refs=(${${(f)"$(_call_program notes-refs git for-each-ref --format='"%(refname)"' refs/notes 2>/dev/null)"}#$type refs/notes/})
__git_command_successful $pipestatus || return 1
_wanted notes-refs expl 'notes ref' compadd $* - $notes_refs
}
# File Argument Types
(( $+functions[__git_files_relative] )) ||
__git_files_relative () {
local files file f_parts prefix p_parts tmp
prefix=$(_call_program gitprefix git rev-parse --show-prefix 2>/dev/null)
__git_command_successful $pipestatus || return 1
if (( $#prefix == 0 )); then
print $1
return
fi
files=()
# Collapse “//” and “/./” into “/”. Strip any remaining “/.” and “/”.
for file in ${${${${${(0)1}//\/\///}//\/.\///}%/.}%/}; do
integer i n
(( n = $#file > $#prefix ? $#file : $#prefix ))
for (( i = 1; i <= n; i++ )); do
if [[ $file[i] != $prefix[i] ]]; then
while (( i > 0 )) && [[ $file[i-1] != / ]]; do
(( i-- ))
done
break
fi
done
files+=${(l@${#prefix[i,-1]//[^\/]}*3@@../@)}${file[i,-1]}
done
print ${(pj:\0:)files}
}
(( $+functions[__git_files] )) ||
__git_files () {
local compadd_opts opts tag description gitcdup gitprefix files expl
zparseopts -D -E -a compadd_opts V: J: 1 2 n f X: M: P: S: r: R: q F:
zparseopts -D -E -a opts -- -cached -deleted -modified -others -ignored -unmerged -killed x+: --exclude+:
tag=$1 description=$2; shift 2
gitcdup=$(_call_program gitcdup git rev-parse --show-cdup 2>/dev/null)
__git_command_successful $pipestatus || return 1
gitprefix=$(_call_program gitprefix git rev-parse --show-prefix 2>/dev/null)
__git_command_successful $pipestatus || return 1
# TODO: --directory should probably be added to $opts when --others is given.
local pref=$gitcdup$gitprefix$PREFIX
files=(${(0)"$(_call_program files git ls-files -z --exclude-standard $opts -- ${pref:+$pref\*} 2>/dev/null)"})
__git_command_successful $pipestatus || return
# _wanted $tag expl $description _files -g '{'${(j:,:)files}'}' $compadd_opts -
_wanted $tag expl $description _multi_parts -f $compadd_opts - / files
}
(( $+functions[__git_cached_files] )) ||
__git_cached_files () {
__git_files --cached cached-files 'cached file' $*
}
(( $+functions[__git_deleted_files] )) ||
__git_deleted_files () {
__git_files --deleted deleted-files 'deleted file' $*
}
(( $+functions[__git_modified_files] )) ||
__git_modified_files () {
__git_files --modified modified-files 'modified file' $*
}
(( $+functions[__git_other_files] )) ||
__git_other_files () {
__git_files --others untracked-files 'untracked file' $*
}
(( $+functions[__git_ignored_cached_files] )) ||
__git_ignored_cached_files () {
__git_files --ignored --cached ignored-cached-files 'ignored cached file' $*
}
(( $+functions[__git_ignored_other_files] )) ||
__git_ignored_other_files () {
__git_files --ignored --others ignored-untracked-files 'ignored untracked file' $*
}
(( $+functions[__git_unmerged_files] )) ||
__git_unmerged_files () {
__git_files --unmerged unmerged-files 'unmerged file' $*
}
(( $+functions[__git_killed_files] )) ||
__git_killed_files () {
__git_files --killed killed-files 'killed file' $*
}
(( $+functions[__git_changed-in-index_files] )) ||
__git_changed-in-index_files () {
local files expl
files=$(_call_program files git diff-index -z --name-only --no-color --cached HEAD 2>/dev/null)
__git_command_successful $pipestatus || return 1
files=(${(0)"$(__git_files_relative $files)"})
__git_command_successful $pipestatus || return 1
_wanted changed-in-index-files expl 'changed in index file' _multi_parts $@ - / files
}
(( $+functions[__git_changed-in-working-tree_files] )) ||
__git_changed-in-working-tree_files () {
local files expl
files=$(_call_program changed-in-working-tree-files git diff -z --name-only --no-color 2>/dev/null)
__git_command_successful $pipestatus || return 1
files=(${(0)"$(__git_files_relative $files)"})
__git_command_successful $pipestatus || return 1
_wanted changed-in-working-tree-files expl 'changed in working tree file' _multi_parts $@ -f - / files
}
(( $+functions[__git_changed_files] )) ||
__git_changed_files () {
_alternative \
'changed-in-index-files::__git_changed-in-index_files' \
'changed-in-working-tree-files::__git_changed-in-working-tree_files'
}
(( $+functions[__git_tree_files] )) ||
__git_tree_files () {
local multi_parts_opts
local tree Path
integer at_least_one_tree_added
local -a tree_files compadd_opts
zparseopts -D -E -a compadd_opts V: J: 1 2 n f X: M: P: S: r: R: q F:
[[ "$1" == */ ]] && Path="$1" || Path="${1:h}/"
shift
(( at_least_one_tree_added = 0 ))
for tree in $*; do
tree_files+=(${(ps:\0:)"$(_call_program tree-files git ls-tree --name-only -z $tree $Path 2>/dev/null)"})
__git_command_successful $pipestatus && (( at_least_one_tree_added = 1 ))
done
if (( !at_least_one_tree_added )); then
return 1
fi
local expl
_wanted files expl 'tree file' _multi_parts -f $compadd_opts -- / tree_files
}
# Repository Argument Types
(( $+functions[__git_remote_repositories] )) ||
__git_remote_repositories () {
local service
service= _ssh
if compset -P '*:'; then
_remote_files -/ -- ssh
else
_ssh_hosts -S:
fi
}
(( $+functions[__git_repositories] )) ||
__git_repositories () {
_alternative \
'local-repositories::__git_local_repositories' \
'remote-repositories::__git_remote_repositories'
}
(( $+functions[__git_local_repositories] )) ||
__git_local_repositories () {
local expl
_wanted local-repositories expl 'local repositories' _directories
}
(( $+functions[__git_any_repositories] )) ||
__git_any_repositories () {
# TODO: should also be $GIT_DIR/remotes/origin
_alternative \
'local-repositories::__git_local_repositories' \
'remotes: :__git_remotes' \
'remote-repositories::__git_remote_repositories'
}
# Common Guards
(( $+functions[__git_guard] )) ||
__git_guard () {
declare -A opts
zparseopts -K -D -A opts M: J: V: 1 2 n F: X:
[[ "$PREFIX$SUFFIX" != $~1 ]] && return 1
if (( $+opts[-X] )); then
_message -r $opts[-X]
else
_message -e $2
fi
[[ -n "$PREFIX$SUFFIX" ]]
}
__git_guard_branch-name () {
if [[ -n $PREFIX$SUFFIX ]]; then
_call_program check-ref-format git check-ref-format "refs/heads/$PREFIX$SUFFIX" &>/dev/null
(( ${#pipestatus:#0} > 0 )) && return 1
fi
_message -e 'branch name'
[[ -n $PREFIX$SUFFIX ]]
}
__git_guard_diff-stat-width () {
if [[ $PREFIX == *,* ]]; then
compset -P '*,'
__git_guard_number 'filename width'
else
compset -S ',*'
__git_guard_number width
fi
}
(( $+functions[__git_guard_number] )) ||
__git_guard_number () {
declare -A opts
zparseopts -K -D -A opts M: J: V: 1 2 n F: X:
_guard '[[:digit:]]#' ${1:-number}
}
(( $+functions[__git_guard_bytes] )) ||
__git_guard_bytes () {
_guard '[[:digit:]]#([kKmMgG]|)' $*
}
(( $+functions[__git_datetimes] )) ||
__git_datetimes () {
# TODO: Use this in more places.
_guard '*' 'time specification'
}
(( $+functions[__git_stages] )) ||
__git_stages () {
__git_guard $* '[[:digit:]]#' 'stage'
}
(( $+functions[__git_svn_revision_numbers] )) ||
__git_svn_revision_numbers () {
__git_guard_number 'revision number'
}
# _arguments Helpers
(( $+functions[__git_setup_log_options] )) ||
__git_setup_log_options () {
# TODO: Need to implement -<n> for limiting the number of commits to show.
log_options=(
'(- *)-h[display help]'
'( --no-decorate)--decorate=-[print out ref names of any commits that are shown]: :__git_log_decorate_formats'
'(--decorate )--no-decorate[do not print out ref names of any commits that are shown]'
'--source[show which ref each commit is reached from]')
}
(( $+functions[__git_setup_diff_options] )) ||
__git_setup_diff_options () {
local diff_types='(-p -u --patch -U --unified --raw --patch-with-raw --stat --numstat --shortstat --dirstat --dirstat-by-file --summary --patch-with-stat --name-only --name-status --cumulative)'
diff_options=(
$diff_types{-p,-u,--patch}'[generate diff in patch format]'
$diff_types{-U,--unified=}'[generate diff with given lines of context]: :__git_guard_number lines'
$diff_types'--raw[generate default raw diff output]'
$diff_types'--patch-with-raw[generate patch but also keep the default raw diff output]'
'--patience[generate diffs with patience algorithm]'
$diff_types'--stat=-[generate diffstat instead of patch]:: :__git_guard_diff-stat-width'
$diff_types'--numstat[generate more machine-friendly diffstat]'
$diff_types'--shortstat[generate summary diffstat]'
$diff_types'--dirstat=-[generate dirstat by amount of changes]:: :__git_guard_number limit'
$diff_types'--dirstat-by-file=-[generate dirstat by number of files]:: :__git_guard_number limit'
$diff_types'--summary[generate condensed summary of extended header information]'
$diff_types'--patch-with-stat[generate patch and prepend its diffstat]'
'-z[use NUL termination on output]'
$diff_types'--name-only[show only names of changed files]'
$diff_types'--name-status[show only names and status of changed files]'
'--submodule=-[select output format for submodule differences]::format:((short\:"show pairs of commit names"
log\:"list commits like git submodule does (default)"))'
'( --no-color --color-words)--color=-[show colored diff]:: :__git_color_whens'
'(--color --color-words)--no-color[turn off colored diff]'
'--word-diff=-[show word diff]::mode:((color\:"highlight changed words using color"
plain\:"wrap deletions and insertions with markers"
porcelain\:"use special line-based format for scripts"
none\:"disable word diff"))'
'--word-diff-regex=-[specify what constitutes a word]:word regex'
'(--color --no-color )--color-words=-[show colored-word diff]::word regex'
'--no-renames[turn off rename detection]'
'--check[warn if changes introduce trailing whitespace or space/tab indents]'
'--full-index[show full object name of pre- and post-image blob]'
'(--full-index)--binary[in addition to --full-index, output binary diffs for git-apply]'
'--abbrev=[set minimum SHA1 display-length]: :__git_guard_number length'
# TODO: --break-rewrites is undocumented.
'(-B --break-rewrites)'{-B-,--break-rewrites=-}'[break complete rewrite changes into pairs of given size]:: :__git_guard_number size'
# TODO: --detect-renames is undocumented.
'(-M --detect-renames)'{-M-,--detect-renames=-}'[detect renames with given scope]:: :__git_guard_number size'
# TODO: --detect-copies is undocumented.
'(-C --detect-copies)'{-C-,--detect-copies=-}'[detect copies as well as renames with given scope]:: :__git_guard_number size'
'--find-copies-harder[try harder to find copies]'
'-l-[limit number of rename/copy targets to run]: :__git_guard_number'
'--diff-filter=-[select certain kinds of files for diff]: :_guard "[ACDMRTUXB*]#" kinds'
'-S-[look for differences that contain the given string]:string'
'--pickaxe-all[when -S finds a change, show all changes in that changeset]'
'--pickaxe-regex[treat argument of -S as regular expression]'
'-O-[output patch in the order of glob-pattern lines in given file]: :_files'
'-R[do a reverse diff]'
'--relative=-[exclude changes outside and output relative to given directory]:: :_directories'
'(-a --text)'{-a,--text}'[treat all files as text]'
'--ignore-space-at-eol[ignore changes in whitespace at end of line]'
'(-b --ignore-space-change -w --ignore-all-space)'{-b,--ignore-space-change}'[ignore changes in amount of white space]'
'(-b --ignore-space-change -w --ignore-all-space)'{-w,--ignore-all-space}'[ignore white space when comparing lines]'
'--inter-hunk-context=[combine hunks closer than n lines]:n'
'--exit-code[report exit code 1 if differences, 0 otherwise]'
'(--exit-code)--quiet[disable all output]'
'( --no-ext-diff)--ext-diff[allow external diff helper to be executed]'
'(--ext-diff )--no-ext-diff[disallow external diff helper to be executed]'
'--ignore-submodules[ignore changes to submodules]:: :__git_ignore_submodules_whens'
'(--no-prefix)--src-prefix=[use given prefix for source]:prefix'
'(--no-prefix)--dst-prefix=[use given prefix for destination]:prefix'
'(--src-prefix --dst-prefix)--no-prefix[do not show any source or destination prefix]'
'(-0 -1 -2 -3 --base --ours --theirs -c --cc --no-index)'{-1,--base}'[diff against "base" version]'
'(-0 -1 -2 -3 --base --ours --theirs -c --cc --no-index)'{-2,--ours}'[diff against "our branch" version]'
'(-0 -1 -2 -3 --base --ours --theirs -c --cc --no-index)'{-3,--theirs}'[diff against "their branch" version]'
'(-0 -1 -2 -3 --base --ours --theirs -c --cc --no-index)-0[omit diff output for unmerged entries]'
'(-0 -1 -2 -3 --base --ours --theirs -c --cc --no-index)'{-c,--cc}'[compare "our branch", "their branch" and working tree files]'
'-q[remain silent even on nonexisting files]'
# TODO: --cumulative is undocumented.
'--cumulative[undocumented]'
# TODO: --follow is undocumented.
'--follow[undocumented]'
# TODO: --textconv is undocumented.
'--textconv[undocumented]'
# TODO: --no-textconv is undocumented.
'--no-textconv[undocumented]'
# TODO: -G is undocumented.
'-G[undocumented]'
# TODO: --output is undocumented.
'--output[undocumented]:undocumented')
}
(( $+functions[__git_setup_revision_options] )) ||
__git_setup_revision_options () {
local -a diff_options
__git_setup_diff_options
revision_options=(
$diff_options
# TODO: format pretty print format is a lot more advanced than this.
# TODO: You cant actually specify --format without a format.
'(-v --header)'{--pretty=-,--format=-}'[pretty print commit messages]::format:((oneline\:"commit-ids and subject of messages"
short\:"few headers and only subject of messages"
medium\:"most parts of messages"
full\:"all parts of commit messages"
fuller\:"like full and includes dates"
email\:"use email headers like From and Subject"
raw\:"the raw commits"
format\:"specify own format"))'
'--abbrev-commit[show only partial prefixes of commit object names]'
'--oneline[shorthand for --pretty=oneline --abbrev-commit]'
'--encoding=-[output log messages in given encoding]:: :__git_encodings'
'(--no-notes --show-notes --standard-notes --no-standard-notes)--no-notes[do not show notes that annotate commit]'
'(--no-notes --show-notes --standard-notes --no-standard-notes)--show-notes[do not show notes that annotate commit]:: :__git_note_references'
'(--no-notes --show-notes --standard-notes --no-standard-notes)--no-standard-notes[enable populating notes ref list from core.notesRef and notes.displayRef]'
'(--no-notes --show-notes --standard-notes --no-standard-notes)--no-standard-notes[disable populating notes ref list from core.notesRef and notes.displayRef]'
'( --date)--relative-date[show dates relative to current time]'
'(--relative-date )--date=-[format of date output]: :__git_date_formats'
'--parents[display parents of commit]'
'--children[display children of commit]'
'--left-right[mark which side of symmetric diff commit is reachable from]'
'--graph[display graphical representation of commit history]'
'--count[display how many commits would have been listed]'
'(-n --max-count)'{-n+,--max-count=}'[maximum number of commits to display]: :__git_guard_number'
'--skip=[skip given number of commits before output]: :__git_guard_number'
'(--max-age --since --after)'{--since=,--after=}'[show commits more recent than given date]:date'
'(--min-age --until --before)'{--until=,--before=}'[show commits older than given date]: :__git_guard_number timestamp'
'( --since --after)--max-age=-[maximum age of commits to output]: :__git_guard_number timestamp'
'( --until --before)--min-age[minimum age of commits to output]: :__git_guard_number timestamp'
'*--author=[limit commits to those by given author]:author'
'*--committer=[limit commits to those by given committer]:committer'
'*--grep=[limit commits to those with log messages matching the given pattern]:pattern'
'--all-match[limit commits to ones matching all --grep, --author, and --committer]'
'(-i --regexp-ignore-case)'{-i,--regexp-ignore-case}'[match regexps ignoring case]'
'(-E --extended-regexp)'{-E,--extended-regexp}'[use POSIX extended regexps]'
'(-F --fixed-strings)'{-F,--fixed-strings}'[do not interpret patterns as regexps]'
'--remove-empty[stop when given path disappears from tree]'
'--merges[display only merge commits]'
'--no-merges[do not display commits with more than one parent]'
'--first-parent[follow only first parent from merge commits]'
'*--not[reverses meaning of ^ prefix for revisions that follow]'
'--all[show all commits from refs]'
'--branches=-[show all commits from refs/heads]::pattern'
'--tags=[-show all commits from refs/tags]::pattern'
'--remotes=[-show all commits from refs/remotes]::pattern'
'--glob=[show all commits from refs matching glob]:pattern'
'--stdin[read commit objects from standard input]'
'--cherry-pick[omit any same-change commits]'
'(-g --walk-reflogs --reverse)'{-g,--walk-reflogs}'[walk reflog entries from most recent to oldest]'
'--merge[after a failed merge, show refs that touch files having a conflict]'
'--boundary[output uninteresting commits at boundary]'
'--simplify-by-decoration[show only commits that are referenced by a ref]'
'( --dense --sparse --simplify-merges --ancestry-path)--full-history[do not prune history]'
'(--full-history --sparse --simplify-merges --ancestry-path)--dense[only display selected commits, plus meaningful history]'
'(--full-history --dense --simplify-merges --ancestry-path)--sparse[when paths are given, display only commits that changes any of them]'
'(--full-history --dense --sparse --ancestry-path)--simplify-merges[milder version of --full-history]'
'(--full-history --dense --sparse --simplify-merges )--ancestry-path[only display commits that exists directly on ancestry chains]'
'( --date-order)--topo-order[display commits in topological order]'
'(--topo-order )--date-order[display commits in date order]'
'(-g --walk-reflogs)--reverse[display commits in reverse order]'
'( --objects-edge)--objects[display object ids of objects referenced by listed commits]'
'(--objects )--objects-edge[display object ids of objects referenced by listed and excluded commits]'
'( --do-walk)--no-walk[only display given revs, do not traverse their ancestors]'
'(--no-walk )--do-walk[only display given revs, traversing their ancestors]'
# TODO: --reflog is undocumented.
'--reflog[show all commits from reflogs]'
# TODO: --default is undocumented.
'--default[use argument as default revision]:default revision:__git_revisions'
# TODO: --full-diff is undocumented.
'(-c --cc )--full-diff[undocumented]'
# TODO: --abrev is undocumented.
'--abbrev=[set minimum SHA1 display-length]: :__git_guard_number length'
# TODO: --no-abbrev is undocumented.
'--no-abbrev[undocumented]'
# TODO: --early-output is undocumented.
'--early-output=-[undocumented]::undocumented'
# TODO: --log-size is undocumented.
'--log-size[undocumented]')
if (( words[(I)--objects(|-edge)] )); then
revision_options+=('--unpacked[print object IDs not in packs]')
fi
}
(( $+functions[__git_setup_merge_options] )) ||
__git_setup_merge_options () {
merge_options=(
'( --no-commit)--commit[perform the merge and commit the result]'
'(--commit )--no-commit[perform the merge but do not commit the result]'
'( --no-ff)--ff[do not generate a merge commit if the merge resolved as a fast-forward]'
'(--ff )--no-ff[generate a merge commit even if the merge resolved as a fast-forward]'
'( --no-log)--log[fill in one-line descriptions of the commits being merged in the log message]'
'(--log )--no-log[do not list one-line descriptions of the commits being merged in the log message]'
'(-n --no-stat)--stat[show a diffstat at the end of the merge]'
'(--stat -n --no-stat)'{-n,--no-stat}'[do not show diffstat at the end of the merge]'
'( --no-squash)--squash[merge, but do not commit]'
'(--squash )--no-squash[merge and commit]'
'--ff-only[refuse to merge unless HEAD is up to date or merge can be resolved as a fast-forward]'
'*'{-s,--strategy=}'[use given merge strategy]:merge strategy:__git_merge_strategies'
'*'{-X,--strategy-option=}'[pass merge-strategy-specific option to merge strategy]'
'(-q --quiet -v --verbose)'{-q,--quiet}'[suppress all output]'
'(-q --quiet -v --verbose)'{-v,--verbose}'[output additional information]')
}
(( $+functions[__git_setup_fetch_options] )) ||
__git_setup_fetch_options () {
fetch_options=(
'(: *)--all[fetch all remotes]'
'(-a --append)'{-a,--append}'[append ref names and object names of fetched refs to "$GIT_DIR/FETCH_HEAD"]'
'--depth=[deepen the history of a shallow repository by the given number of commits]: :__git_guard_number depth'
'--dry-run[show what would be done, without making any changes]'
'(-f --force)'{-f,--force}'[allow refs that are not ancestors to be updated]'
'(-k --keep)'{-k,--keep}'[keep downloaded pack]'
'(-p --prune)'{-p,--prune}'[remove any remote tracking branches that no longer exist remotely]'
'(-n --no-tags -t --tags)'{-n,--no-tags}'[disable automatic tag following]'
'(--no-tags -t --tags)'{-t,--tags}'[fetch remote tags]'
'(-u --update-head-ok)'{-u,--update-head-ok}'[allow updates of current branch head]'
'--upload-pack=[specify path to git-upload-pack on remote side]:remote path'
'(-q --quiet -v --verbose --progress)'{-q,--quiet}'[suppress all output]'
'(-q --quiet -v --verbose)'{-v,--verbose}'[output additional information]'
'(-q --quiet)--progress[output progress information]')
}
(( $+functions[__git_setup_apply_options] )) ||
__git_setup_apply_options () {
apply_options=(
'--whitespace=[detect a new or modified line that ends with trailing whitespaces]: :__git_apply_whitespace_strategies'
'-p-[remove N leading slashes from traditional diff paths]: :_guard "[[\:digit\:]]#" "number of slashes to remove"'
'-C-[ensure at least N lines of context match before and after each change]: :_guard "[[\:digit\:]]#" "number of lines of context"'
'--reject[apply hunks that apply and leave rejected hunks in .rej files]'
'(--ignore-space-change --ignore-whitespace)'{--ignore-space-change,--ignore-whitespace}'[ignore changes in whitespace in context lines]'
'--directory=[root to prepend to all filenames]:root:_directories')
}
# Git Config Helpers
(( $+functions[__git_config_get_regexp] )) ||
__git_config_get_regexp () {
declare -A opts
zparseopts -A opts -D b: a:
[[ -n $opts[-b] ]] || opts[-b]='*.'
[[ -n $opts[-a] ]] || opts[-a]='.[^.]##'
[[ $1 == -- ]] && shift
set -A $2 ${${${(0)"$(_call_program ${3:-$2} "git config -z --get-regexp -- '$1'")"}#${~opts[-b]}}%%${~opts[-a]}$'\n'*}
}
(( $+functions[__git_config_sections] )) ||
__git_config_sections () {
declare -a opts
local regex tag desc
local -a groups
zparseopts -a opts -D b: a:
regex=$1
tag=$2
desc=$3
shift 3
__git_config_get_regexp $opts -- $regex groups $tag
# TODO: Should escape : with \: in groups.
_describe -t $tag $desc groups $*
}
# __git_config_booleans [-t TAG] [-l LABEL] CURRENT DEFAULT DESCRIPTION [OTHER]...
#
# -t can be used to specify a tag to use (default: booleans).
# -l can be used to specify a label to use (default: boolean).
#
# The first argument is the current value, so that the description of the
# current value can be suffixed with “ (current)”.
#
# The second argument is the default value, so that the description of the
# default value can be suffixed with “ (default)”.
#
# The third argument is the description to use for the true and false values.
#
# The rest of the arguments can be used to provide additional “boolean” values
# that should be included. They should be of the form that _describe expects.
(( $+functions[__git_config_booleans] )) ||
__git_config_booleans () {
local tag label current default description
declare -a booleans
zparseopts -D t=tag l=label
current=$1
default=${2:-true}
description=$3
shift 3
booleans=(
{true,yes,on}":$description"
{false,no,off}":do not $description"
$*)
__git_config_values -t ${tag:-booleans} -l ${label:-boolean} -- "$current" $default $booleans
}
# __git_config_values [-t TAG] [-l LABEL] CURRENT DEFAULT [VALUES]...
#
# -t can be used to specify a tag to use (default: values).
# -l can be used to specify a label to use (default: value).
#
# The first argument is the current value, so that the description of the
# current value can be suffixed with “ (current)”.
#
# The second argument is the default value, so that the description of the
# default value can be suffixed with “ (default)”.
#
# The rest of the arguments are values of the form VALUE:DESCRIPTION to be
# passed to _describe.
(( $+functions[__git_config_values] )) ||
__git_config_values () {
declare -A opts
local current default key
declare -a values
zparseopts -A opts -D t: l:
[[ $1 == -- ]] && shift
current=$1
default=$2
shift 2
values=($*)
[[ -n $current ]] && values[(r)$(__git_pattern_escape $default):*]+=' (current)'
values[(r)$(__git_pattern_escape $default):*]+=' (default)'
_describe -t ${opts[-t]:-values} ${opts[-l]:-value} values
}
# Git Config Sections and Types
(( $+functions[__git_browsers] )) ||
__git_browsers () {
integer ret=1
local expl
declare -a userbrowsers builtinbrowsers
__git_config_get_regexp '^browser\..+\.cmd$' userbrowsers
builtinbrowsers=(
firefox
iceweasel
konquerer
w3m
links
lynx
dillo
open
start)
_tags user-browsers builtin-browsers
while _tags; do
_requested user-browsers expl 'user-defined browser' compadd $* - $userbrowsers && ret=0
_requested builtin-browsers expl 'builtin browser' compadd $* - $builtinbrowsers && ret=0
(( ret )) || break
done
return ret
}
(( $+functions[__git_difftools] )) ||
__git_difftools () {
__git_diff-or-merge-tools diff $*
}
(( $+functions[__git_diff-or-merge-tools] )) ||
__git_diff-or-merge-tools () {
local type=$1; shift
integer ret=1
local expl
declare -a userdifftools usermergetools builtintools builtindifftools builtinmergetools
[[ $type == diff ]] && __git_config_get_regexp '^difftool\..+\.cmd$' userdifftools
__git_config_get_regexp '^mergetool\..+\.cmd$' usermergetools
builtintools=(
kdiff3
tkdiff
xxdiff
meld
opendiff
vimdiff
gvimdiff
vimdiff2
gvimdiff2
emerge
ecmerge
diffuse
araxis
p4merge)
builtindifftools=($builtintools kompare)
builtinmergetools=($builtintools tortoisemerge)
case $type in
(diff) _tags user-difftools builtin-difftools user-mergetools ;;
(merge) _tags user-mergetools builtin-mergetools ;;
esac
while _tags; do
_requested user-difftools expl 'user-defined difftool' compadd $* - $userdifftools && ret=0
_requested user-mergetools expl 'user-defined mergetool' compadd $* - $usermergetools && ret=0
_requested builtin-difftools expl 'builtin difftool' compadd $* - $builtindifftools && ret=0
_requested builtin-mergetools expl 'builtin mergetool' compadd $* - $builtinmergetools && ret=0
(( ret )) || break
done
return ret
}
(( $+functions[__git_mergetools] )) ||
__git_mergetools () {
__git_diff-or-merge-tools merge $*
}
(( $+functions[__git_merge_drivers] )) ||
__git_merge_drivers () {
__git_config_sections '^merge\..+\.name$' merge-drivers 'merge driver' $*
}
(( $+functions[__git_builtin_merge_drivers] )) ||
__git_builtin_merge_drivers () {
local -a builtin_merge_drivers
builtin_merge_drivers=(
text:'normal 3-way file-level merge for text files'
binary:'binary file merge driver'
union:'run 3-way file-levele merge with lines from both versions')
_describe -t builtin-merge-drivers 'builtin merge driver' builtin_merge_drivers $*
}
(( $+functions[__git_man_viewers] )) ||
__git_man_viewers () {
# TODO: Add support for standard commands.
__git_config_sections '^man\..+\.cmd$' man-viewers 'man viewer' $*
}
(( $+functions[__git_svn-remotes] )) ||
__git_svn-remotes () {
__git_config_sections -a '(|)' '^svn-remote\..+$' svn-remotes 'svn remote' $*
}
(( $+functions[__git_remote-groups] )) ||
__git_remote-groups () {
__git_config_sections -a '(|)' '^remotes\..+$' remotes-groups 'remotes group' $*
}
(( $+functions[__git_remotes_groups] )) ||
__git_remotes_groups () {
local expl
_wanted remotes-groups expl 'remotes group' \
compadd $* - ${${${(0)"$(_call_program remotes-groups git config --get-regexp -z '"^remotes\..*$"')"}%%$'\n'*}#remotes.}
}
(( $+functions[__git_sendemail_identities] )) ||
__git_sendemail_identities () {
__git_config_sections '^sendemail\..+\.[^.]+$' identities 'sendemail identity' $*
}
(( $+functions[__git_sendemail_smtpencryption_values] )) ||
__git_sendemail_smtpencryption_values () {
__git_config_values -- "$current" "$parts[5]" \
ssl:'use SSL' \
tls:'use TLS'
}
(( $+functions[__git_sendemail_confirm_values] )) ||
__git_sendemail_confirm_values () {
__git_config_values -- "$current" "$parts[5]" \
always:'always confirm before sending' \
never:'never confirm before sending' \
cc:'confirm before sending to automatically added Cc-addresses' \
compose:'confirm before sending first message when using --compose' \
auto:'same as cc together with compose'
}
(( $+functions[__git_sendemail_suppresscc_values] )) ||
__git_sendemail_suppresscc_values () {
__git_config_values -- "$current" "$parts[5]" \
author:'avoid including patch author' \
self:'avoid including sender' \
cc:'avoid including anyone mentioned in Cc lines except for self' \
bodycc:'avoid including anyone mentiond in Cc lines in patch body except for self' \
sob:'avoid including anyone mentiond in Signed-off-by lines except for self' \
cccmd:'avoid running --cc-cmd' \
body:'equivalent to sob + bodycc' \
all:'avoid all auto Cc values'
}
(( $+functions[__git_colors] )) ||
__git_colors () {
declare -a colors
colors=(black red green yellow blue magenta cyan white)
_describe -t colors color colors $*
}
(( $+functions[__git_color_attributes] )) ||
__git_color_attributes () {
declare -a attributes
attributes=(bold dim ul blink reverse)
_describe -t attributes attribute attributes $*
}
# Now, for the main driver…
_git() {
if (( CURRENT > 2 )); then
local -a aliases
local -A git_aliases
# TODO: Should use -z here, but I couldnt get it to work.
aliases=(${(f)${${${(f)"$(_call_program aliases git config --get-regexp '\^alias\.')"}#alias.}/ /$'\n'}/(#e)/$'\n'})
(( $#aliases % 2 == 0 )) && git_aliases=($aliases)
if (( $+git_aliases[$words[2]] && !$+commands[git-$words[2]] && !$+functions[_git-$words[2]] )); then
local -a tmpwords expalias
expalias=(${(z)git_aliases[$words[2]]})
tmpwords=(${words[1]} ${expalias})
if [[ -n "${words[3,-1]}" ]] ; then
tmpwords+=(${words[3,-1]})
fi
[[ -n ${words[$CURRENT]} ]] || tmpwords+=('')
(( CURRENT += ${#expalias} - 1 ))
words=("${tmpwords[@]}")
unset tmpwords expalias
fi
unset git_aliases aliases
fi
integer ret=1
if [[ $service == git ]]; then
local curcontext=$curcontext state line
declare -A opt_args
# TODO: This needs an update
# TODO: How do we fix -c argument?
_arguments -C \
'(- :)--version[display version information]' \
'(- :)--help[display help message]' \
'-c[pass configuration parameter to command]:parameter' \
'--exec-path=-[path containing core git-programs]:: :_directories' \
'--html-path[display path to HTML documentation and exit]' \
'(-p --paginate)'{-p,--paginate}'[pipe output into $PAGER]' \
'--no-pager[do not pipe git output into a pager]' \
'--git-dir=-[path to repository]: :_directories' \
'--work-tree=-[path to working tree]: :_directories' \
'--bare[use $PWD as repository]' \
'--no-replace-objects[do not use replacement refs to replace git objects]' \
'(-): :->command' \
'(-)*:: :->option-or-argument' && return
case $state in
(command)
_git_commands && ret=0
;;
(option-or-argument)
curcontext=${curcontext%:*:*}:git-$words[1]:
if (( $+functions[_git-$words[1]] )); then
_call_function ret _git-$words[1]
elif zstyle -T :completion:$curcontext: use-fallback; then
_files && ret=0
else
_message 'unknown sub-command'
fi
;;
esac
else
_call_function ret _$service
fi
return ret
}
# Load any _git-* definitions so that they may be completed as commands.
declare -gUa _git_third_party_commands
_git_third_party_commands=()
local file
for file in ${^fpath}/_git-*~(*~|*.zwc)(.N); do
local name=${${file:t}#_git-}
if (( $+_git_third_party_commands[$name] )); then
continue
fi
local desc=
integer i=1
while read input; do
if (( i == 2 )); then
if [[ $input == '#description '* ]]; then
desc=:${input#\#description }
fi
break
fi
(( i++ ))
done < $file
_git_third_party_commands+=$name$desc
done
_git