From ef393db92646be86189b1f2d2d160babd04d3d33 Mon Sep 17 00:00:00 2001 From: "James P. Ascher" Date: Sat, 13 Feb 2021 14:37:54 -0500 Subject: [PATCH 1/3] reinstallation instructions for build failures --- docs/Common-Issues.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/Common-Issues.md b/docs/Common-Issues.md index 7dfc6c2d03..444b9310f2 100644 --- a/docs/Common-Issues.md +++ b/docs/Common-Issues.md @@ -113,3 +113,7 @@ Following a macOS upgrade it may be necessary to reinstall the Xcode Command Lin xcode-select --install brew upgrade ``` + +### Local build failures + +Build failures on one machine, but not similarly equipped machines (check issues for other projects too), can indicate that the install is borked. If `brew doctor` doesn’t, reinstalling may help. That is, `brew bundle dump`, [uninstall](https://docs.brew.sh/FAQ#how-do-i-uninstall-homebrew), [reinstall](https://docs.brew.sh/Installation), and `brew bundle install`. From 341904099b48bc434856b5ace1687f12a36bac9a Mon Sep 17 00:00:00 2001 From: cacology Date: Sat, 13 Feb 2021 15:21:56 -0500 Subject: [PATCH 2/3] Correct sentence spacing --- docs/Common-Issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Common-Issues.md b/docs/Common-Issues.md index 444b9310f2..38f85102b3 100644 --- a/docs/Common-Issues.md +++ b/docs/Common-Issues.md @@ -116,4 +116,4 @@ brew upgrade ### Local build failures -Build failures on one machine, but not similarly equipped machines (check issues for other projects too), can indicate that the install is borked. If `brew doctor` doesn’t, reinstalling may help. That is, `brew bundle dump`, [uninstall](https://docs.brew.sh/FAQ#how-do-i-uninstall-homebrew), [reinstall](https://docs.brew.sh/Installation), and `brew bundle install`. +Build failures on one machine, but not similarly equipped machines (check issues for other projects too), can indicate that the install is borked. If `brew doctor` doesn’t, reinstalling may help. That is, `brew bundle dump`, [uninstall](https://docs.brew.sh/FAQ#how-do-i-uninstall-homebrew), [reinstall](https://docs.brew.sh/Installation), and `brew bundle install`. From 6837f9c0399d6d9d4279ba5bc8e6e8bf4408102b Mon Sep 17 00:00:00 2001 From: cacology Date: Thu, 1 Apr 2021 15:51:00 -0400 Subject: [PATCH 3/3] Update docs/Common-Issues.md I think this is a substantial improvement and does what I hoped, helps folks help themselves if--say--they just want to get emacs working; next time they'll have the technique in their pocket too. Co-authored-by: Rylan Polster --- docs/Common-Issues.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Common-Issues.md b/docs/Common-Issues.md index 38f85102b3..1d457eaf55 100644 --- a/docs/Common-Issues.md +++ b/docs/Common-Issues.md @@ -114,6 +114,6 @@ xcode-select --install brew upgrade ``` -### Local build failures +### Other local issues -Build failures on one machine, but not similarly equipped machines (check issues for other projects too), can indicate that the install is borked. If `brew doctor` doesn’t, reinstalling may help. That is, `brew bundle dump`, [uninstall](https://docs.brew.sh/FAQ#how-do-i-uninstall-homebrew), [reinstall](https://docs.brew.sh/Installation), and `brew bundle install`. +If your Homebrew installation gets messed up (and fixing the issues found by `brew doctor` doesn't solve the problem), reinstalling Homebrew may help to reset to a normal state. To easily reinstall Homebrew, use [Homebrew Bundle](https://github.com/Homebrew/homebrew-bundle) to automatically restore your installed formulae and casks. To do so, run `brew bundle dump`, [uninstall](https://docs.brew.sh/FAQ#how-do-i-uninstall-homebrew), [reinstall](https://docs.brew.sh/Installation), and run `brew bundle install`.