summaryrefslogtreecommitdiff
path: root/docs/typ
diff options
context:
space:
mode:
Diffstat (limited to 'docs/typ')
-rw-r--r--docs/typ/reference.typ10
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/typ/reference.typ b/docs/typ/reference.typ
index 4d077f71..987f9f9b 100644
--- a/docs/typ/reference.typ
+++ b/docs/typ/reference.typ
@@ -1073,7 +1073,10 @@ own: a file or directory opened, else the word searched for.
a message over its 64 KiB queue is not sent to it (an `err` in the log
says so). Messages sent before the open are not its.
- The ports pardes reads itself, whatever else reads them: `edit` (the
- data opened as a #word("Look") opens it, at `addr=` when given), `web`
+ data opened as a #word("Look") opens it, at `addr=` when given; with
+ `action=showdata` the data itself shown, as acme's `plumb -i`, in the
+ pane `filename=` names, else a new clean one of that name, and with
+ `action=showdiff` then stacked in a +Diff in its place), `web`
(the host's browser, a URL of at most 256 bytes) and each loaded kind by
its name (`image`, `pdf`). A message to another port goes to its
readers; with none, its rule set's `start` runs (the message dropped),
@@ -1096,7 +1099,10 @@ with the file, which declines one with no hunk, opened as text then); an
existing directory or file to `edit`, Look's own open (a kind's file in
its kind); a commit hash looked at in the editor, in a git work tree, to
#word("Diff") with it, `git show` paged (outside one, Diff declines and
-the word is searched for):
+the word is searched for); a diff paged into a +Pager, which the pager
+sends to `edit` (`src` `pager`, `type` `text/x-diff`, `action=showdata`
+and the +Pager's `filename`), made `showdiff`: stacked in a +Diff in the
++Pager's place. Text paged that is no diff is not sent:
#raw(read("../../src/plumbing"), block: true)