From 0b52a354fa2313d21d211c73286d5572d1e68d46 Mon Sep 17 00:00:00 2001 From: Valery Kharshats Date: Mon, 24 Aug 2026 15:32:36 -0600 Subject: [PATCH] docs: note scrollopt+=hor for trackpad users 'scrollbind' only syncs the axes listed in 'scrollopt', which defaults to "ver,jump", so the panes do not scroll together horizontally. --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index c796a80..97b6d9f 100644 --- a/README.md +++ b/README.md @@ -184,6 +184,20 @@ The `highlight_mode` option controls how syntax highlighting is applied: - **`treesitter`** (default): Full syntax highlighting via Neovim's treesitter. Changes are shown with background colors. - **`difftastic`**: Minimal highlighting like the CLI. No syntax colors; changes are shown with foreground colors (green/red) to make diffs more prominent. +### Trackpad Scrolling + +The panes scroll together vertically but not horizontally, because `'scrollbind'` only syncs the +axes listed in `'scrollopt'` and the default is `ver,jump`. With a trackpad, a sideways swipe moves +one pane alone. Add `hor` to `'scrollopt'` in your config to fix it: + +```lua +vim.opt.scrollopt:append("hor") +``` + +```vim +set scrollopt+=hor +``` + ## Highlight Groups Highlights automatically inherit from your colorscheme's semantic groups (`Added`, `Removed`, `Directory`, `Normal`) and update when you switch themes. Strong background colors are derived by blending the foreground color with your `Normal` background at 38% opacity. Line background colors use half of that opacity for a lighter full-line context.