summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/next-tests.md2
-rw-r--r--docs/typ/building.typ19
-rw-r--r--docs/typ/builtins-gui.json1
-rw-r--r--docs/typ/builtins-tty.json1
-rw-r--r--docs/typ/cheatsheet.typ1
-rw-r--r--docs/typ/reference.typ9
6 files changed, 4 insertions, 29 deletions
diff --git a/docs/next-tests.md b/docs/next-tests.md
index b7b5d3ef..5b4f3f0d 100644
--- a/docs/next-tests.md
+++ b/docs/next-tests.md
@@ -38,7 +38,7 @@ agent's survey. The `e2e` line (kbdin, mousein) is its first step.
- **snap9p** reads /screen through `Files`.
The Python suites in the build (fs.py, monkey9p.py, gui_monkey.py,
- v9fs*.py, agent_session_test.py) move onto it or onto Session, then
+ agent_session_test.py) move onto it or onto Session, then
leave the build. The developer tools (ui_review, record_demos,
appearance_gallery…) stay Python, as examples. A real process performs
its effects, so tests that need one can land at T2.
diff --git a/docs/typ/building.typ b/docs/typ/building.typ
index d8c089f6..b1d8d127 100644
--- a/docs/typ/building.typ
+++ b/docs/typ/building.typ
@@ -16,7 +16,7 @@ builds MuPDF and is on by default (`-Dmupdf=false` drops it). 9P over QUIC
(`-Dquic=true`) uses system OpenSSL 3.6+ and pkg-config.
#pairs(
- [`zig build`], [the terminal shell and the SDL window together, *installed into `~/.local/bin`* (`pardes`, `pardes-gui`, and `pardes-v9fs`, the #word("Tty9p") helper)],
+ [`zig build`], [the terminal shell and the SDL window together, *installed into `~/.local/bin`* (`pardes` and `pardes-gui`)],
[`zig build -Dplatform=tty`], [the terminal shell alone],
[`zig build -Dplatform=gui`], [the SDL3 window alone],
[`zig build web -Dplatform=web -Dtarget=wasm32-freestanding -Ddump=<file>`], [a freestanding wasm core plus vanilla JavaScript (`docs/web.md`)],
@@ -85,7 +85,6 @@ zig build agent-session-test interactive session driver checks over 9P
zig build 9p-test freestanding protocol tests
zig build 9p-io-test native 9P transports and client
zig build quic-test -Dquic=true optional QUIC transport tests
-zig build v9fs-test a real kernel mount (needs sudo -v; fails, not skips, without it)
zig build snap scripted input traces against frozen golden grids
zig build monkey random snapshot scripts hunting panics (not a gate)
zig build hxdiff differential suite against helix's own behaviour
@@ -314,7 +313,7 @@ symlink whose socket refuses a connect is removed with its socket. pardes
binds its own socket rather than going through `cloud9.post`, which takes
only flat names. A reader of the registry must `stat` through the symlink.
-== Kernel mounts and Tty9p
+== Kernel mounts
For Linux v9fs use `version=9p2000,cache=none,access=any`, `trans=unix`
(or `trans=tcp` with `port=`), `uname`, `dfltuid` and `dfltgid` for the
@@ -322,20 +321,6 @@ local user, and an empty `aname`. Linux follows `O_TRUNC` with a `Twstat`
of zero length and an `mtime` hint; pardes takes the truncation and drops
the hint.
-#word("Tty9p") starts the normal shell and queues a quoted helper command,
-which bash and fish run at their first prompt as a foreground job, so
-sudo has the terminal. The unprivileged launcher makes a private temporary
-mountpoint and runs `sudo -E`; the elevated `pardes-v9fs` helper makes a
-private mount namespace, mounts the session's socket with
-`trans=unix,version=9p2000,cache=none,access=any,nosuid,nodev,noexec`,
-drops every root id and capability, and runs the shell as the user (with
-the caller's `PATH` again). The namespace and the mount go with its last
-process. Nothing setuid and no passwordless sudo rule is installed; the
-helper takes explicit paths and a command and is no restricted broker, so
-never grant it passwordless sudo. The host finds the helper beside its own
-executable, or at `PARDES_V9FS_HELPER`. Code: `src/linux/v9fs.zig`;
-`zig build v9fs-terminal-test` and `v9fs-driver-test` need no privileges.
-
= Other notes
`docs/` keeps the platform and design notes beside this book:
diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json
index e731b75e..c7553186 100644
--- a/docs/typ/builtins-gui.json
+++ b/docs/typ/builtins-gui.json
@@ -146,7 +146,6 @@
{"name": "TreeContext", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show the declarations enclosing the top row at the pane's head, on or off."},
{"name": "TreeContextTagStyle", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A pane's TreeContext rows draw in the tag's style, on or off."},
{"name": "Tty", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
- {"name": "Tty9p", "leader": "SPC n 9", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "A Linux terminal with the current session mounted through kernel v9fs."},
{"name": "Tutor", "leader": "SPC h t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the tutor, a document to work through."},
{"name": "Unattach", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Unattach a pane from the pane it answers for: it stays where it is, a pane of its own, and the next search from that pane opens another under it."},
{"name": "Undo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Undo and Redo: step the pane's body back or forward through its edits, from a tag, a pane ctl or exec."},
diff --git a/docs/typ/builtins-tty.json b/docs/typ/builtins-tty.json
index fe81b3fa..613627a7 100644
--- a/docs/typ/builtins-tty.json
+++ b/docs/typ/builtins-tty.json
@@ -129,7 +129,6 @@
{"name": "TreeContext", "leader": null, "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "Show the declarations enclosing the top row at the pane's head, on or off."},
{"name": "TreeContextTagStyle", "leader": null, "also": [], "arg": true, "scope": "root", "setting": true, "choices": "on, off", "doc": "A pane's TreeContext rows draw in the tag's style, on or off."},
{"name": "Tty", "leader": "SPC n t", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "A shell in the calling pane's directory, raw from the first frame."},
- {"name": "Tty9p", "leader": "SPC n 9", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "A Linux terminal with the current session mounted through kernel v9fs."},
{"name": "Tutor", "leader": "SPC h t", "also": ["topbar"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Open the tutor, a document to work through."},
{"name": "Unattach", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Unattach a pane from the pane it answers for: it stays where it is, a pane of its own, and the next search from that pane opens another under it."},
{"name": "Undo", "leader": null, "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "acme's Undo and Redo: step the pane's body back or forward through its edits, from a tag, a pane ctl or exec."},
diff --git a/docs/typ/cheatsheet.typ b/docs/typ/cheatsheet.typ
index a831273b..a70b56e2 100644
--- a/docs/typ/cheatsheet.typ
+++ b/docs/typ/cheatsheet.typ
@@ -92,7 +92,6 @@ Helix-style: motions *select*, then an edit acts on the selection. Mode box: bla
key("SPC f c"), word("Config"),
key("SPC d"), word("Del"),
key("SPC n t"), word("Tty"),
- key("SPC n 9"), word("Tty9p"),
key("SPC w"), word("Window"),
key("SPC j j"), word("Last"),
key("SPC j l"), word("Jumplist"),
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 45863f04..b272306c 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -1118,15 +1118,8 @@ every pane pardes spawns gets it as `$PARDES_MOUNT`. Under `9ns --unix SOCK
plan9port's `9p write` opens with OTRUNC, so on #file("body") it replaces
the whole text. To append, use `>>` through a mount. Through a FUSE mount
bash's `read -t` cannot time out: wrap a follow loop in `timeout`. The
-scripting chapter's rule (a mount, else `9p`) covers most uses. Two more:
+scripting chapter's rule (a mount, else `9p`) covers most uses. One more:
-- #word("Tty9p") (#key("SPC n 9")) opens a terminal with the session
- kernel-mounted (Linux v9fs): it asks for your sudo password in the pane,
- mounts the socket in a private mount namespace and starts your shell as
- you, with `PARDES_MOUNT` naming the mount. Only that shell sees it, and
- each takes one of the session's 16 connections. It needs the `9p` and
- `9pnet_fd` kernel modules and the `pardes-v9fs` helper the build installs
- beside `pardes`.
- `test/ninep.py` is a Python 9P client that exists only in the source tree
(it is not installed). It is for when nothing is mounted and `9p` is not
there, or when a fid must stay open (#file("event"), #file("pty/data"), a