summaryrefslogtreecommitdiff
path: root/plugins/brew/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/brew/README.md')
-rw-r--r--plugins/brew/README.md30
1 files changed, 19 insertions, 11 deletions
diff --git a/plugins/brew/README.md b/plugins/brew/README.md
index c129a7652..44af05225 100644
--- a/plugins/brew/README.md
+++ b/plugins/brew/README.md
@@ -3,19 +3,27 @@
The plugin adds several aliases for common [brew](https://brew.sh) commands.
To use it, add `brew` to the plugins array of your zshrc file:
-```
+
+```zsh
plugins=(... brew)
```
## Aliases
-| Alias | Command | Description |
-|--------|----------------------|---------------|
-| brewp | `brew pin` | Pin a specified formulae, preventing them from being upgraded when issuing the brew upgrade <formulae> command. |
-| brews | `brew list -1` | List installed formulae, one entry per line, or the installed files for a given formulae. |
-| brewsp | `brew list --pinned` | Show the versions of pinned formulae, or only the specified (pinned) formulae if formulae are given. |
-| bubo | `brew update && brew outdated` | Fetch the newest version of Homebrew and all formulae, then list outdated formulae. |
-| bubc | `brew upgrade && brew cleanup` | Upgrade outdated, unpinned brews (with existing install options), then removes stale lock files and outdated downloads for formulae and casks, and removes old versions of installed formulae. |
-| bubu | `bubo && bubc` | Updates Homebrew, lists outdated formulae, upgrades oudated and unpinned formulae, and removes stale and outdated downloads and versions. |
-| bcubo | `brew update && brew cask outdated` | Fetch the newest version of Homebrew and all formulae, then list outdated casks. |
-| bcubc | `brew cask reinstall $(brew cask outdated) && brew cleanup` | Updates outdated casks, then runs cleanup. | \ No newline at end of file
+| Alias | Command | Description |
+|----------|-------------------------------------------------------------|---------------------------------------------------------------------|
+| `brewp` | `brew pin` | Pin a specified formula so that it's not upgraded. |
+| `brews` | `brew list -1` | List installed formulae or the installed files for a given formula. |
+| `brewsp` | `brew list --pinned` | List pinned formulae, or show the version of a given formula. |
+| `bubo` | `brew update && brew outdated` | Update Homebrew and all formulae, then list outdated formulae. |
+| `bubc` | `brew upgrade && brew cleanup` | Upgrade outdated formulae, then run cleanup. |
+| `bubu` | `bubo && bubc` | Do the last two operations above. |
+| `bcubo` | `brew update && brew cask outdated` | Update Homebrew and alll formulae, then list outdated casks. |
+| `bcubc` | `brew cask reinstall $(brew cask outdated) && brew cleanup` | Update outdated casks, then run cleanup. |
+
+## Completion
+
+With the release of Homebrew 1.0, they decided to bundle the zsh completion as part of the
+brew installation, so we no longer ship it with the brew plugin; now it only has brew
+aliases. If you find that brew completion no longer works, make sure you have your Homebrew
+installation fully up to date.