El Capitan and Homebrew: update instructions.

These seem to not apply for everyone on 10.11 any more (as explained in #45387). Closes #45387. Closes #45566. Signed-off-by: Mike McQuaid <[email protected]>
Homebrew · Nov 2, 2015 · fdc0570 · fdc0570
1 parent 1ed3b52
commit fdc0570
Showing 1 changed file with 9 additions and 2 deletions.
diff --git a/share/doc/homebrew/El_Capitan_and_Homebrew.md b/share/doc/homebrew/El_Capitan_and_Homebrew.md
@@ -2,9 +2,9 @@
 
 Part of the OS X 10.11/El Capitan changes is something called [System Integrity Protection](https://en.wikipedia.org/wiki/System_Integrity_Protection) or "SIP".
 
-SIP prevents you from writing to many system directories such as `/usr`, `/System` & `/bin`, regardless of whether or not you are root. The Apple keynote is [here](https://developer.apple.com/videos/wwdc/2015/?id=706) if you'd like to learn more.
+SIP prevents you from writing to many system directories such as `/usr`, `/System` & `/bin`, regardless of whether or not you are root. The Apple keynote is [here](https://developer.apple.com/videos/wwdc/2015/?id=706) if you'd like to learn more. As noted in the keynote, Apple is leaving `/usr/local` open for developers to use, so Homebrew can still be used as expected.
 
-One of the implications of SIP is that you cannot simply create `/usr/local` if you have removed it. However, as noted in the keynote, Apple is leaving `/usr/local` open for developers to use, so Homebrew can still be used as expected.
+One of the implications of SIP was that you could not simply create `/usr/local` if you had removed it. This issue was fixed with the `com.apple.pkg.SystemIntegrityProtectionConfig.14U2076` update.
 
 **If you haven't installed Homebrew in `/usr/local` or another system-protected directory, this document does not apply to you.**
 
@@ -17,6 +17,13 @@ sudo chown -R $(whoami):admin /usr/local
 ```
 
 ## If `/usr/local` does not exist:
+First, try to create `/usr/local` the normal way:
+
+```bash
+  sudo mkdir /usr/local && sudo chflags norestricted /usr/local && sudo chown -R $(whoami):admin /usr/local
+```
+
+If you see permission issues instead try:
 
 * Reboot into Recovery mode (Hold Cmd+R on boot) & access the Terminal.
 * In that terminal run: