ohmyzsh/plugins/git-extras/README.md

# git-extras

This plugin provides completion definitions for some of the commands defined by [git-extras](https://github.com/tj/git-extras), which must already be installed.

To use it, add `git-extras` to the plugins array in your zshrc file:

```zsh
plugins=(... git-extras)
```

## Setup notes

The completions work by augmenting the `_git` completion provided by `zsh`. This only works with the `zsh`-provided `_git`, not the `_git` provided by `git` itself. If you have both `zsh` and `git` installed, you need to make sure that the `zsh`-provided `_git` takes precedence.

### OS X Homebrew Setup

**NOTE:** this no longer works on current Homebrew distributions of git. ~~On OS X with Homebrew, you need to install `git` with `brew install git --without-completions`. Otherwise, `git`'s `_git` will take precedence, and you won't see the completions for `git-extras` commands.~~
git-extras: fix for compatibility with zsh _git This changes all the __git_* functions it was defining to __gitex_* to avoid collisions with the internal functions used inside _git from zsh. 2015-10-02 09:07:01 +02:00			`# git-extras`

docs(git-extras): clarify readme (#11776) 2023-06-26 10:48:17 +02:00			`This plugin provides completion definitions for some of the commands defined by [git-extras](https://github.com/tj/git-extras), which must already be installed.`
git-extras: fix for compatibility with zsh _git This changes all the __git_* functions it was defining to __gitex_* to avoid collisions with the internal functions used inside _git from zsh. 2015-10-02 09:07:01 +02:00
Clean up plugin READMEs and a few plugins - fasd - history - mercurial - pylint - repo - yii2 2020-03-11 19:57:46 +01:00			To use it, add `git-extras` to the plugins array in your zshrc file:

			```zsh
			`plugins=(... git-extras)`
			```

			`## Setup notes`
git-extras: fix for compatibility with zsh _git This changes all the __git_* functions it was defining to __gitex_* to avoid collisions with the internal functions used inside _git from zsh. 2015-10-02 09:07:01 +02:00
			The completions work by augmenting the `_git` completion provided by `zsh`. This only works with the `zsh`-provided `_git`, not the `_git` provided by `git` itself. If you have both `zsh` and `git` installed, you need to make sure that the `zsh`-provided `_git` takes precedence.

			`### OS X Homebrew Setup`

Clean up plugin READMEs and a few plugins - fasd - history - mercurial - pylint - repo - yii2 2020-03-11 19:57:46 +01:00			NOTE: this no longer works on current Homebrew distributions of git. ~~On OS X with Homebrew, you need to install `git` with `brew install git --without-completions`. Otherwise, `git`'s `_git` will take precedence, and you won't see the completions for `git-extras` commands.~~