zsh/Completion/Unix/Command/_git, branch master

github #156: _git: fix --git-dir and --work-tree options when used with parameters

2026-04-05T19:08:04Z

github #155: update git completion

2026-04-03T12:21:38Z

54185+54209: set default value of verbose style to true

2026-03-08T15:12:22Z

54092 (tweaked): _git: improve format completion

2025-11-22T19:52:09Z

- complete user-defined formats (pretty. in config) - complete tformat: syntax - auto-remove extra : when completing (t|)format: - add new place-holders + added comment per off-list suggestion

54091: _git: add support for more pretty format specifiers

2025-11-17T16:49:35Z

The specifiers are taken from the git-log(1) man page. The %[ac]h specifier matches the behaviour of git rev-list --date=human.

53577: _git: improve max-verbose, other descriptions

2025-11-16T16:45:46Z

- add ability to style specific ref types - significantly improve performance of resolving unambiguous ref names - fix display of ref names without descriptions - make branch and commit descriptions more consistent - improve format of alias descriptions

github #147: Clean up some leaked variables in completion functions

2025-10-23T17:28:54Z

53985: update git completion for new options in 2.51

2025-10-02T21:06:00Z

github #143: list only remote branches for `git checkout --guess`

2025-09-23T22:57:06Z

github #142: Fix text for git merge --squash/--no-squash

2025-09-23T22:47:51Z

53825: fix regexp in in __git_extract_aliases

2025-08-03T15:03:34Z

unposted (mentioned on github #134): __git_worktrees: Match the order of $(git worktree list).

2025-05-18T03:06:59Z

The output of __git_worktrees() now matches the output of `git worktree list` exactly, modulo the 'list-separator' style.

github #134 (+ implement commit review suggestion): __git_worktrees: Use a library function

2025-05-18T03:06:16Z

Using _describe makes the completions and descriptions line up in columns, and makes the function honour the list-separator style.

github #118: completion(git-rebase): non-interactive mode also supports --autosquash

2025-01-30T12:02:39Z

53327: update for git 2.47

2025-01-27T22:35:03Z

github #120: Update _git to reflect `--recursive` being an alias

2024-08-31T10:09:26Z

`--recursive` and `--recurse-submodules` are aliased according to https://github.com/git/git/blob/99c33bed562b41de6ce9bd3fd561303d39645048/builtin/clone.c#L105

53031: Completion/Unix/Command/_git: add missing terminator in case statement

2024-08-14T02:32:34Z

52904: Improve quoting of paths passed via _call_program to "git ls-files"

2024-05-25T02:22:44Z

52280: update git completion for new options in git through to version 2.42.0

2023-11-09T15:48:12Z

52141: Add trailer token completion for git commit --trailer

2023-09-20T18:00:10Z

Via 842587016d in the git project there has been support for git commit trailer tokens for the bash completion system. This commit adds similar support to zsh. It includes additional hardening of the regexp and allows for tokens which include a '.'. This can be found in git via 9a0ec17606.

51603: complete dates and times in the form that git accepts

2023-03-27T19:11:34Z

51583: update completion of git attributes

2023-03-16T21:16:52Z

51539: don't complete diff options to git blame

2023-03-11T12:52:05Z

51456: complete only modified files with git add -u

2023-02-19T16:25:17Z

Also fix a typo, add a missing =, add a prompt for function name after git blame -L and git worktree --force has gained a short -f form.

51391: complete remote branch names respecting --delete for git push

2023-02-17T22:35:39Z

51313: fix "git rerere forget" completion

2023-01-22T03:21:30Z

51256: Add --refetch to completions of git-fetch

2023-01-11T15:08:43Z

50714: also complete in the 2nd argument of "git diff" anything that could

2022-10-23T03:26:23Z

be in the 1st argument. This probably shouldn't complete ranges but all other code is in common, so leaving it to someone more familiar with _git to clean up.

49664: Use associative array for third-party completion

2021-12-28T23:29:50Z

49633: update options for git 2.34

2021-12-07T06:35:59Z

github #83: _git-push, _git-send-pack: Make --push-option repeatable.

2021-11-26T11:48:55Z

49597: add a helper for completing numbers with unit suffixes and separate out defaults, ranges and units in completion descriptions

2021-11-24T22:09:38Z

49345: fix git file completion for paths starting with ../

2021-09-04T11:11:07Z

49327: complete for new git maintenance, for-each-repo, sparse-checkout and bugreport commands

2021-08-29T15:12:56Z

49150: consistently use singular form for headings on completion match groups

2021-07-08T22:23:52Z

48338: _git: Support case-insensitive path matching

2021-04-10T20:54:26Z

48231: add missing git --pretty formats and improve descriptions

2021-03-28T08:49:34Z

users/26107: complete changed files after git diff HEAD

2020-10-29T20:44:19Z

46131: _git-config: Partly fix a bug whereby a 'foo.ba' wouldn't be completed to 'foo.bar.baz'.

2020-06-28T13:01:09Z

Now it properly gets completed, but in the case of gpg.openpgp.program, the description would be shown as "unknown option name", that being the description of gpg.*.program via `git help -c`, which shadows the more description of gpg.openpgp.program in $git_options.

46128: _git: Complete more options and diff/merge tools.

2020-06-28T13:01:09Z

46129: _git-config: Fix a bug where a second trailing dot would be incorrectly offered.

2020-06-28T13:01:09Z

46130: _git-config: Complete some more options.

2020-06-28T13:01:09Z

46140: _git: Fix insufficiently quoted pattern

2020-06-27T20:35:08Z

46139: _git: Remove hanging whitespaces

2020-06-27T20:32:39Z

github #46: _git-restore: Complete arguments to the --source option after a '=' sign

2020-03-28T22:49:41Z

github #46: Better restrict git-restore(1) file completions

2020-03-28T22:49:41Z

Add support to the -S and -W options. Remove the facility for completing files from the tree specified by the --source argument since, upon testing in git 2.26.0, that doesn't seem to be correct behaviour. (Note git-restore(1) says the command is experimental and its semantics may change.) See discussion on the PR for details.

unposted: _git: Fix copy/paste error in earlier commit that broke `git stash drop`

2020-03-13T14:46:14Z

This was broken by workers/44923 (8aa84bd5fc44)

Merge remote-tracking branch 'origin/master' into 5.9

2020-03-07T21:36:46Z

* Test/D02glob.ztst: On the "unreadable directories can be globbed (users/24619, users/24626)" test, resolve conflicts by removing the Cygwin-only skip that has been added in master, since the test is passing on this branch. This effectively reverts workers/45492. See discussion starting in workers/45504. * origin/master: unposted: Remove 'sgi', as that OpenBSD port has been discontinued. 45509: fix typos in B01cd.ztst 45490 (+45495 and a test): refactor rlimits.c github #49: Fix typo: longson should be loongson users/24710: Fix job control problem with sudo. 45492: skip test added by users/24633 on Cygwin 45488: COMP_WORDS for bash need "$@"-style quoting 45487: Missing mod_export declarations for AIX 45447: Complete vcs_info_hookadd and vcs_info_hookdel. Expose _vcs_info_hooks as a top-level helper function. 45463: test: kill: Document why we use SIGURG 45453: builtins: kill: Do not signal current process group when pid is empty 45452: builtins: kill: Add `kill ''` regression test with explicit sigspec 45451: builtins: kill: Add basic test suite github #48/0002: vcs_info git: properly detect bare repositories github #48/0001: vcs_info git: avoid warnings in bare repositories unposted: Post-release version bump unposted: Release 5.8 CVE-2019-20044: Update change log for preceding commits Update NEWS/README Add unsetopt/PRIVILEGED tests Clean up error-message white space Improve PRIVILEGED fixes (again) Improve PRIVILEGED fixes Drop privileges securely unposted: V01zmodload: Fix failing test from workers/45385 45423: _su: Improve arg handling, shell look-ups unposted: _zip: Recognise '--' 45385: Add a test for 'zmodload -Fa' preemptively disabling ("blacklisting"?) features. unposted: Test release: 5.7.1-test-3 zsh/system: Fix infinite loop in sysread _diff_options: Restore -w completion lost in workers/43351 unposted: Fix ChangeLog typo. 45368: Add tests for workers/45367's issue about double slashes in 'cd -P' and /home/daniel/in/zsh. 45373: Fix ERR_EXIT bug in else branch of if. 45372: Record a symlink loop bug involving :P 45365: _git: Fix __git_recent_branches for the case when a commit has an empty message 45343: Queue signals around arithmetic evaluations 45344: Document where third-party completion functions should be installed. 45345: internal: ztst.vim: Fix highlighting of zsh comments in test payload unposted: internal: Add some comments and fix indentation. No functional change. 45340: internal: Document the difference between paramtab and realparamtab. 45332: _git: add completion for git-version _brace_parameter: add missing \ Conflicts: ChangeLog Test/D02glob.ztst Test/V01zmodload.ztst

45365: _git: Fix __git_recent_branches for the case when a commit has an empty message

2020-02-02T07:32:14Z

45332: _git: add completion for git-version

2020-01-19T23:32:37Z

Signed-off-by: Eitan Adler

45313: _git: Support completion from outside of a worktree when --git-dir/--work-tree are specified on the command line

2020-01-17T21:52:45Z

Revised version of workers/41523.

Merge remote-tracking branch 'origin/master' into 5.9

2020-01-15T22:49:09Z

Right now, as we're preparing to tag the 5.8 release, the 5.9 branch is maintained as a topic branch off master. * origin/master: 45287: zshexpn: Describe parameter elision and add some introductory prose 45302: bin_umask(): Queue signals around umask(). users/24656: docs: Add an example of setting and querying zstyles users/24659: Cross-ref doc for matchers. 45296: D02glob: Clean up after test from users/24633 45290: New helper script for listing XFail tests. users/24633: Add an xfail test for users/24619. unposted: additional typo fix 45280: _git: add -local variants users/24628 (fixed): More doc for selectw-word-style widgets. 45266: Fix losetup completion, broken in da085b7a20729401c725f91ae930200d0deda64f (41720). unposted: Fix punctuation. use /dev/fd on Cygwin for process substitution unposted: Two additional typo fixes. Fix typos reported by codespell in shell code Fix typos reported by codespell in Src/ 45269: Fix misspellings in completions and elsewhere. 45261: _gcc: Detect clang-as-gcc unposted: internal: Remove Vim modeline that interferes with ztst.vim. unposted: internal: ztst.vim: Use :syn-sync to work around (#x) and "`\\\\\\\\`" confusing the highlighting. unposted: internal: zyodl.vim: Support glob qualifiers in example()'s unposted: internal: zyodl.vim: Support yodl comments. github #44: Allow completion for picocom to list symlinks to character devices 45245: _gcc: add some clang specific warnings 45231: _rsync: When completing remote modules, ignore more of the motd. unposted: _tac: Eliminate superfluous variable 45226: _man: Improve completion of file paths 45184: Clarify documentation of %-sequences understood by compadd -[Xx] 45239: Remove 'appendhistory' from zsh-newuser-install 45218: add more options to swaks completion 45196: fix completion after make -C, allowing for -C being used multiple times unposted (after 45183): Fix yodl error: "contrib.yo:4457: No macro: back(...)". 45181: Fix workers/45164: ${(S)%%} will now consider the empty string as a potential match. 45183: Improve documentation examples unposted: Add some tests for ${(S)}, including a regression test for workers/45164. 45169/0002 (tweaked for trailing newlines): Add an expected-to-fail test for workers/44007. 45169/0001: In the test suite, allow test cases to be marked as expected to fail. users/24582 + users/24583: Add regression tests for the previous commit. 24581: Fix array assignments in shell word splitting and completion. 45160: zshexpn: Expand documentation of (S) 45150 + 45152: zshexpn: Use a more minimal example in the documentation of (#b). unposted: internal: Vim ztst support: Add an ftplugin in addition to the syntax highlighter. 45130: _multi_parts: Always pass -f to compadd if given by caller unposted: zerrmsg(): Fix macro guard missed in previous commit unposted: ChangeLog for last commit internal: Allow %L in zerrmsg() in non-debug builds, too.

45288: _git: Complete bisect/new as well as bisect/bad.

2020-01-15T22:41:25Z

Also, complete the bisect/old-$commithash ref names.

45280: _git: add -local variants

2020-01-11T16:37:44Z

Technically all timezone formats support the "-local" suffix but it is not meaningful for all of them. As such just list out the specific formats which it does. Also adjust the 'default' description

Fix typos reported by codespell in shell code

2020-01-09T13:51:08Z

45269: Fix misspellings in completions and elsewhere.

2020-01-09T13:42:02Z

44923: update options for git 2.24

2019-11-24T21:58:38Z

44797: _git-config: Complete unknown options from 'git help -c'.

2019-10-02T17:11:11Z

44779: completion for new git switch and git restore commands

2019-09-26T22:16:54Z

github #38: fix completion text for git update-index --chmod

2019-09-18T16:29:47Z

44551: update for new git changes

2019-07-18T23:42:26Z

44274: allow finer control of completion match soring with compadd's -o option

2019-05-07T21:24:49Z

44111: _git: Use `git rev-list` for log messages

2019-03-21T22:02:16Z

This side-steps issues related to `git log` respecting settings like log.showSignature

44080: Completion: Fix several option-description typos

2019-02-26T07:21:29Z

github #32: Fix a typo in the git tag completion.

2019-01-28T00:48:23Z

43974: _git: Always offer -F/-m for `git tag`

2019-01-04T21:12:31Z

github #29: Add completion support for Gits --color-moved option and color settings

2018-11-01T23:45:35Z

--color-moved was added in Git 2.15.

43698: update options for git 2.19.1

2018-10-17T15:56:36Z

43443: _git: When completing worktrees, show the ref and hash of each worktree.

2018-09-12T15:12:09Z

43442: _git: Break out a helper function.

2018-09-12T15:12:07Z

unposted: git describe's --long and --abbrev options are not mutually exclusive

2018-08-31T21:17:28Z

43359: further review of git remote set-url completion

2018-08-31T21:10:36Z

42810: git remote set-url completion

2018-08-31T20:58:52Z

unposted (PR #26): __git_files: fix double quotation of star

2018-08-12T19:37:47Z

This fixes the double quote introduced by aa160fc8, so that the end result of the parameter expansion is $pref followed by \* (a quoted star), meaning `git ls-files` gets a literal star, not an expanded list of matching files, as was intended in commit cc7437bf. Fixes completion of `git add ../`.

43073: various completion option updates

2018-06-21T11:28:24Z

43006: complete modified files after `git stash --`

2018-06-18T07:23:27Z

users/23484: be consistent on matcher specs for git branches to fix issue with partial matching

2018-06-18T07:19:26Z

42752: enhance git external alias completion

2018-05-08T16:13:12Z

If alias expands to !cmd-name, complete as a normal command line after cmd-name.

42659: various completion option updates

2018-04-16T15:02:56Z

42491 based on 42000 (Andrei Shevchuk): factor ssh host completion for use for mosh and git

2018-03-23T23:09:12Z

42364: _git: fix __git_ignore_line to ignore the current word

2018-02-22T22:41:13Z

Before this patch "git branch -d master" would result in "no matches found", while "master" itself should get completed here. The "(bQ)" (added in 527badc23, via 38129?!) does not seem to be necessary anymore: with files "f\[a-z\]o" and "foo", "git add f[a-z]o " offers "f\[a-z\]o", but not "foo".

42324: _git: handle mutually exclusive options

2018-02-12T09:12:22Z

Currently `git show --stat -p` is not considered a valid completion and prevents further completions like `--no-abbrev`. It is a valid use case however to use `--stat` with `-p` (and there is a synonym `--patch-with-stat` for it even). This patch changes `__git_setup_diff_options` to only handle mutually exclusive arguments reported by Git (as a fatal error) in a special way.

42333: git 2.16.0 no longer accepts an empty string as a pathspec element so replace empty strings with a dot

2018-02-07T23:49:46Z

42323: _git: move "local" statement out of loop

2018-01-24T20:55:27Z

Fixup for 99cf61fd4.

42317: completion option updates for commands that have had recent updates

2018-01-23T10:03:00Z

42171: prevent parameters of various parameters from becoming global

2018-01-02T19:38:03Z

42138: _git-revert: Complete recent commits first.

2017-12-20T04:13:39Z

42019: update options in git completion to 2.15

2017-11-13T20:47:29Z

also improve format completion for git tag and for-each-ref

41957: update git completion for git 2.14.3

2017-10-28T22:07:22Z

41808: _git-cherry-pick: Typo fixes

2017-10-04T22:07:23Z

41552: complete only branches after git worktree add --detach

2017-08-16T21:41:09Z

the --detach is superfluous for other commits

41493: fix to not print hash into terminal and update options for git 2.14

2017-08-05T22:28:22Z

41475: _git: Complete files after 'reset' when there are no commits, when the 'verbose' style is set.

2017-08-02T14:09:57Z

unposted: _git: Fix style lookup for 'max-verbose'.

2017-07-31T00:52:49Z

41414: fix for commas used in exclusion lists

2017-07-14T10:07:49Z

also missing escape for _gcc and --no-index option for git diff

41419: update for git 2.13.2

2017-07-14T09:59:31Z

41339: Unquote treeish argument for git checkout completion

2017-06-22T09:05:07Z

40943: __git_recent_commits: prefer recent commit objects

2017-04-23T20:27:38Z

Without this "commit to be amended" shows up before "recent commit object name" with `git commit --fixup`, but the recent commit objects are the most useful here.

40818: _git-checkout: When completing local heads, prefer recently-checked-out ones. (after 38592)

2017-03-14T11:14:14Z

40817: __git_recent_branches: Retrieve less data, but faster.

2017-03-14T11:14:13Z

By replacing the --grep-reflog=needle argument with a ${(M)...:#needle} filter, we retrieve less data from the reflog, and consequently run (on my test cases) 16% to 40% faster. The trade-off is that we retrieve less data: instead of retrieving the 1000 most recent 'checkout' operations, we retrieve the most recent 1000 operations, which would include fewer than 1000 checkout operations. Also change [[:xdigit:]] to [0-9a-f] since it's faster, however, the absolute gain from this is minor compared to the cost of 'git reflog'.