summaryrefslogtreecommitdiff
path: root/docs/fs.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-30 11:48:22 -0300
committerGabriel Schneider <[email protected]>2026-10-01 00:12:17 -0300
commitfc8e1abf361ab2151109e68e5c88a0ed45650b38 (patch)
treee39977dbf694d185ae5348af5e572c0393320d50 /docs/fs.md
parentf7c22573915cd4ecb98ef400b0914949ed07874e (diff)
downloadpardes-fc8e1abf361ab2151109e68e5c88a0ed45650b38.tar.gz
pardes-fc8e1abf361ab2151109e68e5c88a0ed45650b38.zip
pardes NEWFILE in a pane forwards even when its directory is missing, and Save makes the directories
fs.md said FILE must already exist, while `pardes new.txt` in fact forwarded, making a pane named for it that Save creates. With a missing directory (`pardes notes/new.txt`) the launch gave up forwarding and started a nested editor inside the pane. Now the name is made absolute as written and forwarded the same way. A name written to a pane's name file that goes into a directory not there has its Save make the directories, as Config's pane does. A Save <path> into a missing directory still fails ENOENT. The Forwarding section now says what a new FILE does. fs.py launches one into a missing directory and saves it. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs/fs.md')
-rw-r--r--docs/fs.md11
1 files changed, 7 insertions, 4 deletions
diff --git a/docs/fs.md b/docs/fs.md
index 75f9fd14..2a618173 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -18,9 +18,11 @@ and `PARDES_PANE` (their pane's serial).
**Forwarding.** `pardes FILE` run in a pane (a live `PARDES_PID`, with
`PARDES_9P` and `PARDES_PANE`) writes FILE to that pane's `look` and returns
-at once, as acme's `B` does. FILE must already exist; a name that does not
-resolve, or a missing `PARDES_9P`/`PARDES_PANE`, starts a separate editor
-instead. Bare `pardes` in a pane refuses and names `--nested`.
+at once, as acme's `B` does. A FILE not there yet (`pardes notes/new.txt`)
+opens a new pane named for it, empty, and its Save creates the file, making
+its directories first when they are not there either. A missing
+`PARDES_9P`/`PARDES_PANE` starts a separate editor instead. Bare `pardes` in
+a pane refuses and names `--nested`.
`--wait` (`-w`) returns when the pane that shows FILE is deleted (exit 0) or
the session goes away (exit 1), as acme's `E` does. Use
@@ -342,7 +344,8 @@ are ENOSPC, for this open and for a look, exec, `New` or `Tty` alike.
**`name`** reads the file name (a terminal's directory); a write renames the
buffer (relative to the pane's directory) and marks nothing dirty; `Save`
-then writes under the new name. A name is one line; refused (EINVAL) are a
+then writes under the new name, making its directories first when the name
+went into one not there. A name is one line; refused (EINVAL) are a
second line, a blank at either end, control bytes and non-UTF-8 (`bad
character in file name: a blank at its start`, ...). Up to 255 bytes a
component.