From c3c8c7c6681de66eea8f04bb2aec49733cdfe837 Mon Sep 17 00:00:00 2001 From: Shaun Jackman Date: Thu, 26 Nov 2020 10:28:02 -0800 Subject: [PATCH] Revise docs/FAQ.md --- docs/FAQ.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/FAQ.md b/docs/FAQ.md index fcc41ab6d7..af3ac7a73f 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -85,6 +85,10 @@ cd $(brew --repository) hub pull someone_else ``` +## Why should I install Homebrew in the default location? + +Homebrew's pre-built binary packages, called [bottles](Bottles.md), of many packages can only be used if you install in the default installation prefix, otherwise they have to be built from source. Building from source takes a long time, is prone to fail, and is not supported. Do yourself a favour and install to the default prefix so that you can use our pre-built binary packages. The default prefix is `/usr/local` for macOS on Intel, `opt/homebrew` for macOS on ARM, and `/home/linuxbrew/.linuxbrew` for Linux. *Pick another prefix at your peril!* + ## Why does Homebrew prefer I install to `/usr/local`? 1. **It’s easier**
`/usr/local/bin` is already in your @@ -102,13 +106,9 @@ hub pull someone_else 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 on Linux recommend that I install to `/home/linuxbrew/.linuxbrew`? +## Why is the default installation prefix `/home/linuxbrew/.linuxbrew` on Linux? -The prefix `/home/linuxbrew/.linuxbrew` was chosen so that users without admin access can ask an admin to create a `linuxbrew` role account and still benefit from precompiled binaries. If you do not yourself have admin privileges, consider asking your admin staff to create a `linuxbrew` role account for you with home directory `/home/linuxbrew`. - -+ https://docs.brew.sh/FAQ.html#why-do-you-compile-everything -+ https://docs.brew.sh/Installation.html#alternative-installs -+ https://docs.brew.sh/Bottles.html#cellar-cellar +The prefix `/home/linuxbrew/.linuxbrew` was chosen so that users without admin access can ask an admin to create a `linuxbrew` role account and still benefit from precompiled binaries. If you do not yourself have admin privileges, consider asking your admin staff to create a `linuxbrew` role account for you with home directory `/home/linuxbrew`. ## Why does Homebrew say sudo is bad? **tl;dr** Sudo is dangerous, and you installed TextMate.app without sudo