From d570c61e017b60c9bced8264effe65a70e8c89fc Mon Sep 17 00:00:00 2001 From: Jacob Bednarz Date: Tue, 21 May 2024 10:11:30 +1000 Subject: [PATCH] docs: update README to mention `--zap` for Homebrew uninstall Adds some pointers to the documentation to help those with Homebrew uninstallation where `--zap` is required otherwise, they may see issues when upgrading from older versions. --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index 283aad80..4f869d82 100644 --- a/README.md +++ b/README.md @@ -127,6 +127,14 @@ That file can be backed up or transferred to other machines. If you are using Rectangle v0.44+, you can also use the import/export button in the Preferences pane to share to your preferences and keyboard shortcuts across machines using a JSON file. +> [!NOTE] +> If you are having issues with configuration options persisting after an application restart and you've installed using Homebrew, you will need to uninstall and reinstall with the `--zap` flag. + +``` +brew uninstall --zap rectangle +brew install rectangle +``` + ## Uninstallation Rectangle can be uninstalled by quitting the app and moving it to the trash. You can remove the Rectangle defaults from your machine with the following terminal command: @@ -135,6 +143,13 @@ Rectangle can be uninstalled by quitting the app and moving it to the trash. You defaults delete com.knollsoft.Rectangle ``` +> [!TIP] +> If you are uninstalling after installing with Homebrew, you should include the `--zap` flag to ensure it removes the plist entries too. + +``` +brew uninstall --zap rectangle +``` + --- ## Contributing