admin/brew
1
0
Fork 0
Code Issues Packages Projects Releases 6 Wiki Activity

Merge pull request #6111 from Homebrew/tap-pin-docs

Browse Source 
Taps: remove references to pinning.
This commit is contained in:
Mike McQuaid 2019-05-09 20:30:00 +01:00 committed by GitHub
commit 415d57841e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/Taps.md
View File

@ -53,42 +53,28 @@ dunn/emacs
version: `brew tap username/homebrew-foobar`. `brew` will automatically add
back the 'homebrew-' prefix whenever it's necessary.
## Formula duplicate names
## Formula with duplicate names
If your tap contains a formula that is also present in
[homebrew/core](https://github.com/Homebrew/homebrew-core), that's fine,
but it means that you must install it explicitly by default.
If you would like to prioritise a tap over `homebrew/core`, you can use
`brew tap-pin username/repo` to pin the tap,
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
If you need a formula to be installed from a particular tap, you can use fully
qualified names to refer to them.
For example, you can create a tap for an alternative `vim` formula. Without
pinning it, the behaviour will be:
You can create a tap for an alternative `vim` formula. The behaviour will be:
```sh
brew install vim # installs from homebrew/core
brew install username/repo/vim # installs from your custom repository
```
However if you pin the tap with `brew tap-pin username/repo`, you will need to
use `homebrew/core` to refer to the core formula.
```sh
brew install vim # installs from your custom repository
brew install homebrew/core/vim # installs from homebrew/core
```
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
dependencies.
As a result, we recommend you give formulae a different name if you want to make
them easier to install. Note that there is (intentionally) no way of replacing
dependencies of core formulae with those from taps.