From 2c41a430b63e3ab0a2cfc2aa1695b8d55bd2e778 Mon Sep 17 00:00:00 2001 From: Levi Neely Date: Thu, 8 Oct 2026 20:06:54 +0200 Subject: [PATCH] docs(README): warn that the plugins are opinionated Several plugins reshape or suppress Kate's defaults (radial takes the right mouse button, acme rebinds Ctrl+A/E/H/U/W + double-click + mouse chords and kills X11 primary paste, palette/switch/plumb claim Alt+X/P/G and F2). Add a callout at the top of 'The plugins' so users enable them deliberately rather than being surprised. --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index c9bf34a..941fbbb 100644 --- a/README.md +++ b/README.md @@ -88,6 +88,21 @@ entry points when its sibling is also enabled. Each plugin is independent — enable only what you want. Keys shown below are the defaults. +> ⚠️ **These plugins are opinionated.** They are built around one person's +> workflow (mouse-at-the-caret, one-handed typing, no chords, Plan 9 / Emacs +> habits), and several *reshape or suppress Kate's defaults* rather than just +> adding features: +> +> - `radial` hijacks the **right mouse button** in the editor, suppressing the +> normal context menu while enabled. +> - `acme` rebinds `Ctrl+A/E/H/U/W`, repurposes **double-click**, turns +> left-button **mouse chords** into Cut/Paste, and kills X11 middle-click +> primary paste. +> - `palette` and `switch` claim `Alt+X/P/G`; `plumb` claims `F2`. +> +> This is deliberate, not a bug. If you want a conventional Kate, don't enable +> the ones whose gestures you aren't ready for — try them one at a time. + ### `[deft:util] palette` — command palette (M-x) A Sublime/Emacs-style launcher over **every action currently offered by the