From d82c901ad6aa2e6bab201e7b89a8af6a9c989da0 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Mon, 6 Jul 2026 20:34:19 -0500
Subject: [PATCH] docs: document indicator padding option

Add indicator.padding (x, y) to the vimdoc help file and README config
tables.
---
 README.md         |  1 +
 doc/tags          |  1 +
 doc/watchexec.txt | 12 ++++++++++++
 3 files changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 0be3ed8..02800a5 100644
--- a/README.md
+++ b/README.md
@@ -110,6 +110,7 @@ to close it. Press `<Leader>wxt` to toggle it back.
 | `failure_hl` | `string`                                                          | `"WatchexecFailure"` | Highlight for failure state.     |
 | `width`      | `integer`                                                         | `2`                  | Indicator width in cells.        |
 | `height`     | `integer`                                                         | `1`                  | Indicator height in cells.       |
+| `padding`    | `table`                                                           | `{ x = 1, y = 1 }`  | Offset from editor edges.        |
 | `patterns`   | `table`                                                           | *(see below)*        | Lua patterns for parsing output. |
 
 #### `indicator.patterns`
diff --git a/doc/tags b/doc/tags
index 180195f..79f3100 100644
--- a/doc/tags
+++ b/doc/tags
@@ -19,6 +19,7 @@ watchexec-wxt	watchexec.txt	/*watchexec-wxt*
 watchexec.Config	watchexec.txt	/*watchexec.Config*
 watchexec.Config.auto_scroll	watchexec.txt	/*watchexec.Config.auto_scroll*
 watchexec.Config.indicator	watchexec.txt	/*watchexec.Config.indicator*
+watchexec.Config.indicator.padding	watchexec.txt	/*watchexec.Config.indicator.padding*
 watchexec.Config.indicator.patterns	watchexec.txt	/*watchexec.Config.indicator.patterns*
 watchexec.Config.max_lines	watchexec.txt	/*watchexec.Config.max_lines*
 watchexec.Config.watchexec	watchexec.txt	/*watchexec.Config.watchexec*
diff --git a/doc/watchexec.txt b/doc/watchexec.txt
index 1d5a37f..2926fc4 100644
--- a/doc/watchexec.txt
+++ b/doc/watchexec.txt
@@ -177,6 +177,18 @@ indicator (table|nil) ~
     Height of the indicator in screen cells.
     Default: 1
 
+  padding (table|nil) ~
+                                        *watchexec.Config.indicator.padding*
+    Offset from the editor edges. Each value is a number of screen cells.
+
+    x (integer|nil) ~
+      Horizontal offset from the left or right edge.
+      Default: 1
+
+    y (integer|nil) ~
+      Vertical offset from the top or bottom edge.
+      Default: 1
+
   patterns (table|nil) ~
     Lua patterns for detecting command lifecycle in output.
                                    *watchexec.Config.indicator.patterns*