summaryrefslogtreecommitdiff
path: root/docs/typ/reference.typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ/reference.typ')
-rw-r--r--docs/typ/reference.typ24
1 files changed, 23 insertions, 1 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index db090d24..7ffbd3ea 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -612,7 +612,8 @@ takes:
its tag; #word("Window") (#key("Ctrl-w"), #key("SPC w")) picks the pane
first: #keys("h", "j", "k", "l") move an outline, #key("Enter") or
#key("Esc") or a pane's letter focuses, #key("d") is #word("Del") and
- #key("c") #word("Collapse") on the outlined pane.
+ #key("c") #word("Collapse") on the outlined pane. #word("Follow")
+ (#key("SPC c f")) and #word("Unfollow"), below.
- `get`: reload from the file (refused once over unsaved edits, `<name>: Modified (get again to discard)`). It is an undo step, so #word("Undo") brings back what was there: the sure way back to the file on disk.
- `lock`/`unlock` (acme's). The lock binds only clients that take it and
belongs to the open that wrote it: `exec 3>$pane/ctl; echo lock >&3; ...; exec 3>&-`. A `lock` another open holds fails at once, `file in use`
@@ -629,6 +630,27 @@ A file changed on disk reloads by itself only when the buffer has no
unsaved edits; otherwise it stays dirty, says `<name> changed on disk (get reloads it, Save overwrites it)`, logs `changed <serial>`, and its next
#word("Save") warns once. A file whose disk text is what the pane was read or saved as is no change: an #word("Undo") back across #word("Get") `file` or `e` to unsaved edits says nothing changed, and #word("Save") writes it.
+== Follow <follow>
+
+#word("Follow") (#key("SPC c f")) is Emacs's follow-mode: one text across a
+chain of panes as consecutive pages. On a file pane it adds a page, a
+#word("Zerox") twin, at the end of the column right of the chain's last
+page, or alone in a new column there when there is none; the keyboard stays
+where it was. #word("Follow") on any page adds one after the last; on a twin
+outside the chain it is refused (`Follow: this text has a chain: Follow on
+one of its panes`). The pages, in column order, each start on the line after
+the one before ends (a line wrapped on past a page's bottom starts the next
+again), and scroll as one: the wheel, a page key, a jump or a #word("Look")
+in any page moves the others with it. Each page keeps its own cursor; one
+moved past its page's last row (or above its first) takes the keyboard to
+the page showing its line, scrolling nothing, and past the chain's ends the
+chain scrolls as one pane would. A page the chain made has #word("Unfollow")
+on its tag: it takes the pane out, a plain twin with the scroll it has, and
+the chain closes up. #word("Del") of a page leaves the chain too; the first
+page left is the head, whose tag has no #word("Unfollow"), and a chain of
+one is none. The chain is kept across #word("Dump") and #word("Restore");
+each window or terminal on the session scrolls its own.
+
== Addresses and data <addresses>
#file("addr"), #file("dot") and #file("limit") read the pair of byte