diff options
Diffstat (limited to 'docs/brew-tap.md')
| -rw-r--r-- | docs/brew-tap.md | 24 |
1 files changed, 12 insertions, 12 deletions
diff --git a/docs/brew-tap.md b/docs/brew-tap.md index cfa0870d8..6a537428f 100644 --- a/docs/brew-tap.md +++ b/docs/brew-tap.md @@ -1,7 +1,7 @@ # Taps (third-party repositories) -`brew tap` adds more repos to the list of formulae that `brew` tracks, updates, -and installs from. By default, `tap` assumes that the repos come from GitHub, +`brew tap` adds more repositories to the list of formulae that `brew` tracks, updates, +and installs from. By default, `tap` assumes that the repositories come from GitHub, but the command isn't limited to any one location. ## The command (`brew tap`) @@ -18,26 +18,26 @@ edavis/emacs * `brew tap <user/repo>` makes a shallow clone of the repository at https://github.com/user/repo. After that, `brew` will be able to work on - those formulae as if there were in Homebrew's canonical repository. You can + those formulae as if they were in Homebrew's canonical repository. You can install and uninstall them with `brew [un]install`, and the formulae are automatically updated when you run `brew update`. (See below for details about how `brew tap` handles the names of repositories.) * `brew tap <user/repo> <URL>` makes a shallow clone of the repository at URL. Unlike the one-argument version, URL is not assumed to be GitHub, and it - doesn't have to be HTTP. Any location and any protocol that git can handle is + doesn't have to be HTTP. Any location and any protocol that Git can handle is fine. -* Add `--full` to either the one- or two-argument invocations above, and git +* Add `--full` to either the one- or two-argument invocations above, and Git will make a complete clone rather than a shallow one. Full is the default for Homebrew developers. -* `brew tap --repair` migrates tapped formulae from symlink-based to +* `brew tap --repair` migrates tapped formulae from a symlink-based to directory-based structure. (This should only need to be run once.) * `brew untap user/repo [user/repo user/repo ...]` removes the given taps. The - repos are deleted and `brew` will no longer be aware of its formulae. `brew - untap` can handle multiple removals at once. + repositories are deleted and `brew` will no longer be aware of their formulae. + `brew untap` can handle multiple removals at once. ## Repository naming conventions and assumptions @@ -65,9 +65,9 @@ and use `brew tap-unpin username/repo` to revert the pin. Whenever a `brew install foo` command is issued, brew will find which formula to use by searching in the following order: -* Pinned taps -* Core formulae -* Other taps +* pinned taps +* core formulae +* other taps If you need a formula to be installed from a particular tap, you can use fully qualified names to refer to them. @@ -89,5 +89,5 @@ brew install homebrew/core/vim # installs from homebrew/core ``` Do note that pinned taps are prioritized only when the formula name is directly -given by you. i.e., it will not influence formulae automatically installed as +given by you, i.e. it will not influence formulae automatically installed as dependencies. |