diff options
Diffstat (limited to 'docs/FAQ.md')
| -rw-r--r-- | docs/FAQ.md | 36 |
1 files changed, 14 insertions, 22 deletions
diff --git a/docs/FAQ.md b/docs/FAQ.md index 7527289dc..5656d1e34 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -17,8 +17,6 @@ Or upgrade a specific formula with: brew upgrade $FORMULA -<a name="cleanup"></a> - ## How do I stop certain formulae from being updated? To stop something from being updated/upgraded: @@ -38,12 +36,10 @@ or clean up everything at once: brew cleanup -to see what would be cleaned up: +or to see what would be cleaned up: brew cleanup -n -<a name="uninstall"></a> - ## How do I uninstall Homebrew? To uninstall Homebrew, paste the command below in a terminal prompt. @@ -53,15 +49,12 @@ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/ Download the [uninstall script](https://raw.githubusercontent.com/Homebrew/install/master/uninstall) and run `./uninstall --help` to view more uninstall options. -<a name="uninstall-package"></a> - ## How do I uninstall a formula? If you do not uninstall all of the versions that Homebrew has installed, Homebrew will continue to attempt to install the newest version it knows -about when you do (`brew upgrade --all`). This can be surprising. +about when you run `brew upgrade --all`. This can be surprising. -To remove a formula entirely, you may do -(`brew uninstall formula_name --force`). +To remove a formula entirely, you may run `brew uninstall formula_name --force`. Be careful as this is a destructive operation. @@ -85,13 +78,13 @@ Read [CONTRIBUTING.md](https://github.com/Homebrew/brew/blob/master/CONTRIBUTING ## Why do you compile everything? Homebrew provides pre-compiled versions for many formulae. These -pre-compiled versions are referred to as **bottles** and are available +pre-compiled versions are referred to as [bottles](Bottles.md) and are available at <https://bintray.com/homebrew/bottles>. If available, bottled binaries will be used by default except under the following conditions: -* Options were passed to the install command i.e. `brew install $FORMULA` +* Options were passed to the install command, i.e. `brew install $FORMULA` will use a bottled version of $FORMULA, but `brew install $FORMULA --enable-bar` will trigger a source build. * The `--build-from-source` option is invoked. @@ -99,7 +92,7 @@ will use a bottled version of $FORMULA, but * The machine is not running a supported version of macOS as all bottled builds are generated only for supported macOS versions. * Homebrew is installed to a prefix other than the standard -`/usr/local` (although some bottles support this) +`/usr/local` (although some bottles support this). In order to completely disable bottled builds, simply add a value for the environment variable `HOMEBREW_BUILD_FROM_SOURCE` to @@ -123,7 +116,6 @@ Or: `brew pull https://github.com/Homebrew/homebrew-core/pull/1234` ## Why does Homebrew prefer I install to `/usr/local`? -<a name="usrlocal"></a> 1. **It’s easier**<br>`/usr/local/bin` is already in your `PATH`. @@ -142,13 +134,13 @@ brews then save yourself a bunch of hassle and install to It is not always straightforward to tell `gem` to look in non-standard directories for headers and libraries. If you choose `/usr/local`, many things will "just work". -## Why does Homebrew say sudo is bad? <a name="sudo"></a> +## Why does Homebrew say sudo is bad? **tl;dr** Sudo is dangerous, and you installed TextMate.app without sudo anyway. Homebrew is designed to work without using sudo. You can decide to use it but we strongly recommend not to do so. If you have used sudo and run -into a bug then it is likely to be the cause. Please don’t file a bug +into a bug then this is likely to be the cause. Please don’t file a bug report unless you can reproduce it after reinstalling Homebrew from scratch without using sudo. @@ -179,7 +171,7 @@ If it’s been a while, bump it with a “bump” comment. Sometimes we miss req Yes! It’s easy! Just `brew edit $FORMULA`. You don’t have to submit modifications back to *Homebrew/homebrew-core*, just edit the formula as you personally need it and `brew install`. As a bonus `brew update` will merge your changes with upstream so you can still keep the formula up-to-date **with** your personal modifications! ## Can I make new formulae? -Yes! It’s easy! Just `brew create URL` Homebrew will then open the +Yes! It’s easy! Just `brew create URL`. Homebrew will then open the formula in `$EDITOR` so you can edit it, but it probably already installs; try it: `brew install $FORMULA`. If you come up with any issues, run the command with the `-d` switch like so: `brew install -d $FORMULA`, @@ -193,7 +185,7 @@ Yes, brew is designed to not get in your way so you can use it how you like. Install your own stuff, but be aware that if you install common -libraries, like libexpat yourself, it may cause trouble when trying to +libraries like libexpat yourself, it may cause trouble when trying to build certain Homebrew formula. As a result `brew doctor` will warn you about this. @@ -215,13 +207,13 @@ Linking /usr/local/Cellar/foo/0.1… 17 symlinks created Use `brew log $FORMULA` to find out! Likely because it had unresolved issues or our analytics identified it was not widely used. -## Homebrew is a poor name, it is generic, why was it chosen? +## Homebrew is a poor name, it's too generic, why was it chosen? @mxcl was too concerned with the beer theme and didn’t consider that the -project may actually prove popular. By the time he realized it was too -late. However, today, the first google hit for “homebrew” is not beer +project may actually prove popular. By the time he realized it was, it was too +late. However, today, the first Google hit for “homebrew” is not beer related ;-) -## What does *keg-only* mean? +## What does "keg-only" mean? It means the formula is installed only into the Cellar; it is not linked into `/usr/local`. This means most tools will not find it. We don’t do this for stupid reasons. You can still link in the formula if you need |