diff --git a/docs/guides/main.rst b/docs/guides/main.rst index ee9e59df1..4e833fe3c 100644 --- a/docs/guides/main.rst +++ b/docs/guides/main.rst @@ -72,7 +72,15 @@ new versions. Installing on macOS 10.11 and Higher ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Starting with macOS 10.11 (El Capitan), Apple has enabled `System Integrity Protection`_ (SIP), and because of SIP, some installation processes may fail, even with ``sudo``, because they intrude on protected areas of the system (if you've installed python via `Homebrew`_ this probably won't happen since the Python libraries are installed to an unrestricted folder). If this does happen, try installing beets only for the current user by running ``pip install --user beets``. It might also be a good idea to add ``~/Library/Python/2.7/bin`` to your ``$PATH``. +Starting with version 10.11 (El Capitan), macOS has a new security feature +called `System Integrity Protection`_ (SIP) that prevents you from modifying +some parts of the system. This means that some ``pip`` commands may fail with +a permissions error, even when you use ``sudo``. (You probably *won't* run +into this if you've installed Python yourself with `Homebrew`_ or otherwise.) + +If this happens, you can install beets for the current user only (sans +``sudo``) by typing ``pip install --user beets``. If you do that, you might want +to add ``~/Library/Python/2.7/bin`` to your ``$PATH``. .. _System Integrity Protection: https://support.apple.com/en-us/HT204899 .. _Homebrew: http://brew.sh