addr takes a row's range, L:C-L2:C2 or L:C-C2, so a Recent, +Search or Jumplist row pastes in

The rows spell a range L:C-L2:C2 (inclusive), which addr read as L:C then back L2 lines. After an L:C, a - and a number is now that range, through its last character; the docs set both spellings side by side.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 9 insertions, 1 deletions

diff --git a/docs/fs.md b/docs/fs.md
index 53082b11..a7e91fb3 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -659,7 +659,15 @@ column 0, is `address out of range`. Since the column counts bytes, a
 column a tool gives in characters (pytest's, a compiler's) is the same
 only on an ASCII line; elsewhere address the line and search it
 (`12/name/`) or use `#n`. sam would read `12:5` as a syntax
-error.
+error. The rows of Recent, a +Search and the Jumplist spell a range
+`12:5-14:2` (or `12:5-9` on one line), and `addr` takes that too, so a row
+pastes in; the two spellings side by side:
+
+    12:5,14:2    sam's range: from line 12 column 5 up to the point at 14:2
+    12:5-14:2    a row's range: 12:5 through the character at 14:2, inclusive
+
+A `-` right after `L:C` and a digit is this range, not sam's "back N
+lines" from that point.
 A write to `data` or `xdata` replaces the range `addr` names, as acme's
 does (editors/acme/xfid.c:491-523: it deletes the range, then inserts), so
 `echo NEW > data` and `echo NEW >> data` both replace that range, and