aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--share/doc/homebrew/Common-Issues.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/share/doc/homebrew/Common-Issues.md b/share/doc/homebrew/Common-Issues.md
index a3f4d531f..7d8c8640c 100644
--- a/share/doc/homebrew/Common-Issues.md
+++ b/share/doc/homebrew/Common-Issues.md
@@ -160,3 +160,17 @@ To list all files that would be deleted:
Don't follow the advice here but fix by using
`Language::Python.setup_install_args` in the formula as described in
[Python for Formula Authors](Python-for-Formula-Authors.md).
+
+### Upgrading OS X
+
+Upgrading OS X can cause errors like the following:
+
+- `dyld: Library not loaded: /usr/local/opt/icu4c/lib/libicui18n.54.dylib`
+- `configure: error: Cannot find libz`
+
+Following an OS X upgrade it may be necessary to reinstall the Xcode Command Line Tools and `brew upgrade` all installed formula:
+
+```bash
+xcode-select --install
+brew upgrade
+```