Skip to content

Commit

Permalink
README: mention "brew autoremove" when fixing macOS homebrew install
Browse files Browse the repository at this point in the history
The segfaults reported in #1389 were caused by a homebrew installation
that needed to be reset. The reporter was able to accomplish this using
a "brew uninstall" + "brew autoremove" cycle.

Related-to: #1389
Reported-by: @gerkereitz on github
Helped-by: @matthiasdg on github
Signed-off-by: David Aguilar <davvid@gmail.com>
  • Loading branch information
davvid committed Apr 5, 2024
1 parent 526737d commit 0dbbbaf
Showing 1 changed file with 6 additions and 22 deletions.
28 changes: 6 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -262,34 +262,18 @@ You will need to periodically rebuild the app wrapper whenever Python is upgrade

Updating macOS can often break Homebrew-managed software.

If you upgrade your macOS version and Git Cola no longer runs then then it is
recommended that you re-install Git Cola's dependencies after upgrading.
If you update macOS and Git Cola stops working then then you probably need to re-install
Git Cola's dependencies.

A quick fix when upgrading to newer versions of XCode or macOS is to
reinstall PyQt6.
Re-installing from scratch using the instructions below can get things back in shape.

brew reinstall pyqt@6

You may also need to relink your pyqt installation:

brew link pyqt@6

This is required when upgrading to a modern (post-10.11 El Capitan) Mac OS X.
Homebrew now bundles its own Python3 installation instead of using the
system-provided default Python.

If the "brew reinstall" command above does not work then re-installing from
scratch using the instructions below should get things back in shape.

# update homebrew
brew update

# uninstall git-cola and its dependencies
brew uninstall git-cola
brew uninstall pyqt5
brew uninstall sip
brew uninstall pyqt
brew uninstall pyqt@5
brew autoremove

# re-install git-cola and its dependencies
brew install git-cola


Expand Down

0 comments on commit 0dbbbaf

Please sign in to comment.