From cfab6f908818689508fb2b067534d4c2e41c8ec7 Mon Sep 17 00:00:00 2001
From: Lukas Holecek <hluk@email.cz>
Date: Tue, 25 Jun 2024 14:40:26 +0200
Subject: [PATCH] macOS: Update install steps for #2652

---
 docs/installation.rst | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index fe3b8c43cb..1b625129ad 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -5,13 +5,25 @@ Packages and installation files are available at `Releases page <https://github.
 
 Alternatively, you can install the app with one of the following methods:
 
-a. On **Windows**, you can install `Chocolatey package <https://chocolatey.org/packages/copyq>`__.
-b. On **OS X**, you can use `Homebrew <https://brew.sh/>`__ to install the app.
+On **Windows**, you can install `Chocolatey package <https://chocolatey.org/packages/copyq>`__.
+
+On **macOS**, you can use `Homebrew <https://brew.sh/>`__ to install the app
+(also see the problem in the next section):
 
 .. code-block:: bash
 
     brew install --cask copyq
 
+On **macOS**, if you encounter issue where the app does crash with a dialog
+saying "CopyQ is damaged" or "CopyQ cannot be opened", you may need to run the
+following commands (for details, see `issue #2652
+<https://github.com/hluk/CopyQ/issues/2652>`__):
+
+.. code-block:: bash
+
+    xattr -d com.apple.quarantine /Applications/CopyQ.app
+    codesign --force --deep --sign - /Applications/CopyQ.app
+
 On Debian unstable, **Debian 10+**, **Ubuntu 18.04+** and later derivatives can
 install stable version from official repositories: