summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-29 10:30:38 -0300
committerGabriel Schneider <[email protected]>2026-10-01 00:12:16 -0300
commit2d0c506583d18d6f004fc117282deb2faea1d17e (patch)
tree683d1dd2820df31222360c0308fb3333b64aae1e /README.md
parentf207f1d4d56d1012766e6206e713f2b3da70579d (diff)
downloadpardes-2d0c506583d18d6f004fc117282deb2faea1d17e.tar.gz
pardes-2d0c506583d18d6f004fc117282deb2faea1d17e.zip
Recent lists the files opened lately, closed ones too, and a jump back to a closed file reopens it
A file closed by accident, its path forgotten, could not be found again: the jumplist dropped closed panes. Every file opened (a look, a Save of a scratch, a Restore, a rename) goes first in a list of 200, kept once, its dot noted when it closes, kept across sessions in $XDG_STATE_HOME/pardes/ recent. `Recent` (SPC f r) shows it in a reused +Recent, each row `path:line:col open|closed` a look reopens; /recent reads `open|closed <path>`. The jumplist keeps a closed file's entries, +Jumps marks them `(closed)`, and Back to one opens the file at its place. acme has no such thing; its dump and Load are the nearest. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'README.md')
-rw-r--r--README.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/README.md b/README.md
index 49ecfa4d..826f86c8 100644
--- a/README.md
+++ b/README.md
@@ -103,6 +103,25 @@ pane shells outlive every frontend; a frontend keeps only what needs the human's
own display. From inside the editor, `Attach` and `Detach` do the same thing as
words. See `docs/detached.md`.
+## Recent files
+
+A file closed by accident is found again. `Recent` (`SPC f r`) lists the
+files opened lately, most recent first, closed ones too, each marked `open`
+or `closed` at the place its dot was when it closed:
+
+```
+/home/me/src/main.zig:120:5 closed
+/home/me/notes.txt open
+```
+
+A look at a row opens that file there. The list keeps 200 files, each once,
+and lasts across sessions in `$XDG_STATE_HOME/pardes/recent` (else
+`~/.local/state/pardes/recent`). The jumplist keeps a closed file's entries
+too: `Back` to one opens the file again at its place, and `+Jumps` marks it
+`(closed)`. Over 9P, `/recent` reads `open <path>` or `closed <path>` a line.
+acme has nothing like it (its dump and Load are the nearest); pardes goes
+beyond acme here.
+
## Tests
```