Homebrew / brew.sh

On the brew homepage, the text states:

    
           how: Homebrew installs packages to their own directory and then symlinks their files into <code>/usr/local</code>.

However, per the man page, the prefix for the location where symlinks are created is platform dependent (i.e. not always /usr/local):

--prefix [--unbrewed] [--installed] [formula ...]
       Display Homebrew´s install path. Default:

       •   macOS Intel: /usr/local

       •   macOS ARM: /opt/homebrew

       •   Linux: /home/linuxbrew/.linuxbrew

This behavior is confirmed when installing on an M1 Mac.

The examples are easier to understand when we refer to a single prefix. We could add a (on macOS Intel) or something if desired.

Apple no longer sells laptops with Intel CPUs; it won't be long until the rest of the line follows suit. Using the Intel path provides users with outdated information.

@ReagentX It will be a long time until the majority of Homebrew users are on ARM. There's a bunch of software still not ported and, as a result, a bunch of users still using /usr/local on ARM for the Intel binaries under Rosetta 2.

If you have a concrete suggestion on how to improve this: please make a PR.

Symlink Location is Platform-Dependent