From 2bdde8c5ec1049ea0f575c6f9165ed4cef00ea50 Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Tue, 15 Sep 2026 13:21:29 -0300 Subject: Align location results and configure source context --- docs/config.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'docs') diff --git a/docs/config.md b/docs/config.md index d986855e..e8c25ceb 100644 --- a/docs/config.md +++ b/docs/config.md @@ -128,6 +128,28 @@ scrolling; scrolling upward reveals that source line as the headers recede. `Dump` and `Restore` preserve the setting per pane. Customized tags retain their text; the command can still be executed from any source pane. +`LocationsConfig` prints the current settings for Search, Grep and LSP location +results in an output pane. Execute the printed line to apply it again, or +supply just the fields to change: + +```text +LocationsConfig context:5 tscontext:on tslocations:off +``` + +- `context` is the number of source lines above and below each match (default + `0`). Overlapping context is shown once. +- `tscontext` includes enclosing tree-sitter declaration headers in source + order (default `off`). +- `tslocations` shows locations beside those declaration headers (default + `on`). Turning it off keeps the headers' syntax colors. + +Result locations are padded so the source text aligns, preserving the source's +indentation. Context rows begin with `| `; `n` and `N` still stop on matches. +Open file buffers supply context from their current edits. Missing files still +leave the original result available. These settings apply to subsequent result +generation and survive `Dump`/`Restore`. Invalid fields reject the entire +update; if a field appears twice, its last value wins. + `WindowOpacity ` controls the opacity of everything in the SDL window except text and the cursor, which stay fully opaque. Use `WindowOpacity 85` to see the desktop through the editor, or `WindowOpacity 100` to restore full -- cgit v1.3