From 5cb6c84f0897ad9e836b25a885723fd9aa4a166e Mon Sep 17 00:00:00 2001 From: NotAShelf Date: Fri, 3 Apr 2026 14:07:45 +0300 Subject: [PATCH] docs: document clipboard persistence opt-in behaviour Signed-off-by: NotAShelf Change-Id: Ie0830d547ba0e4fcbd620290b3d314b16a6a6964 --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 42dd542..d29b4f4 100644 --- a/README.md +++ b/README.md @@ -320,6 +320,25 @@ ask the compositor for image data first. Most users will be fine using the default value (`any`) but in the case your browser (or other applications!) regularly misrepresent data, you might wish to prioritize a different type. +#### Clipboard Persistence + +By default, when you copy something and close the source application, Wayland +clears the clipboard. Stash can optionally keep the clipboard contents available +after the source closes using the `--persist` flag. + +```bash +stash watch --persist +``` + +When enabled, Stash will fork a background process to serve the clipboard +contents, keeping them available even after the original application exits. + +> [!NOTE] +> This feature is **opt-in** and disabled by default, as it may not be desirable +> for all users and can leave clipboard data in memory longer than expected. You +> must start the `stash watch` daemon with `--persist` for clipboard +> persistence. + ### Options Some commands take additional flags to modify Stash's behavior. See each