Align location results and configure source context

1 files changed, 22 insertions, 0 deletions

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 <percent>` 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