summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-30 13:54:40 -0300
committerGabriel Schneider <[email protected]>2026-10-01 00:12:17 -0300
commite8fc2964acdf7156ab0c9961b7bf83d74f152192 (patch)
treeaf05298c50c8ba4237e2200ef2cf4b15e3b3e81e /docs
parenta33fc226c32d97a053bafdb13d6ec3bf8b537f35 (diff)
downloadpardes-e8fc2964acdf7156ab0c9961b7bf83d74f152192.tar.gz
pardes-e8fc2964acdf7156ab0c9961b7bf83d74f152192.zip
DumpConfig's lines that set nothing start with #, and a line starting with # runs as nothing at an exec, a ctl or the init file
DumpConfig's information lines ("Platform: tty", "Startup config: ...") began with words. Written back, as the report means to be, or clicked, each ran as a shell command or failed as an unknown control message. Each now starts with `# `. A line starting with `#` is a comment, as in a shell: it runs as nothing, silently, at an exec, at the root's, a pane's or a column's ctl, and in the init file. Documented in fs.md and config.md. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs')
-rw-r--r--docs/config.md4
-rw-r--r--docs/fs.md2
2 files changed, 5 insertions, 1 deletions
diff --git a/docs/config.md b/docs/config.md
index 35f0b6e7..1967a158 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -38,7 +38,9 @@ Save writes it, making its directory first. `DumpConfig` opens a
it and its value (`Shell /bin/bash`, `PanelSlide off`, `LocationsConfig …`)
and `unsupported` for one the frontend cannot show. After a blank line
come what is in effect but set by no word, such as the last shell spawned
-and the font in use, and the startup path (a right click opens it). The
+and the font in use, and the startup path (a right click opens it), each a
+`#` line. A line starting with `#` is a comment wherever a line runs (the
+init file, a ctl, an exec), so the report can be written back as is. The
root `ctl` file reads the settings back in the words a write takes
([fs.md](fs.md#the-root-ctl)).
diff --git a/docs/fs.md b/docs/fs.md
index efbcf21a..334b6783 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -219,6 +219,8 @@ A line written to `exec` is a middle click:
A builtin that needs its argument (`Msg`, `Mount`, `Find`) written bare is
`wrong #args in control message "Msg"`, and so is one that takes none
written with one (`Config extra`).
+- a line starting with `#` is a comment, as in a shell: it runs as
+ nothing, silently, here and in every ctl.
- the language server's words ask about a file pane's text at its cursor
(set it with `addr` and `dot=addr` first): `Hover` fills `+Hover`,
`Rename new` renames the symbol everywhere and lists the places,