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.
This commit is contained in:
Levi Neely 2026-10-08 20:06:54 +02:00
parent e9d86b35f8
commit 2c41a430b6
1 changed files with 15 additions and 0 deletions

View File

@ -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 Each plugin is independent — enable only what you want. Keys shown below are the
defaults. 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) ### `[deft:util] palette` — command palette (M-x)
A Sublime/Emacs-style launcher over **every action currently offered by the A Sublime/Emacs-style launcher over **every action currently offered by the