aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorRuss Cox <rsc@swtch.com>2014-04-30 12:14:29 -0400
committerRuss Cox <rsc@swtch.com>2014-04-30 12:14:29 -0400
commit4a3fb87264f8bc03fc62f00ef335056f30d18023 (patch)
tree77d52013a1fbb6fd967c1e146d5ddbf5ca0c065d /man
parent833216fef8b946895956737d205bcad7031bf06f (diff)
downloadplan9port-4a3fb87264f8bc03fc62f00ef335056f30d18023.tar.gz
plan9port-4a3fb87264f8bc03fc62f00ef335056f30d18023.tar.bz2
plan9port-4a3fb87264f8bc03fc62f00ef335056f30d18023.zip
acme: add log file in acme root directory
Reading /mnt/acme/log reports a log of window create, put, and delete events, as they happen. It blocks until the next event is available. Example log output: 8 new /Users/rsc/foo.go 8 put /Users/rsc/foo.go 8 del /Users/rsc/foo.go This lets acme-aware programs react to file writes, for example compiling code, running a test, or updating an import block. TBR=r R=r https://codereview.appspot.com/89560044
Diffstat (limited to 'man')
-rw-r--r--man/man4/acme.428
1 files changed, 26 insertions, 2 deletions
diff --git a/man/man4/acme.4 b/man/man4/acme.4
index 78214cad..7449dbd2 100644
--- a/man/man4/acme.4
+++ b/man/man4/acme.4
@@ -73,7 +73,7 @@ was run.
The window is created if necessary, but not until text is actually written.
.TP
.B consctl
-Is an empty unwritable file present only for compatibility; there is no way
+is an empty unwritable file present only for compatibility; there is no way
to turn off `echo', for example, under
.IR acme .
.TP
@@ -95,8 +95,32 @@ file.
is an empty file, writable without effect, present only for compatibility with
.BR rio .
.TP
+.B log
+reports a log of window operations since the opening of the
+.B log
+file.
+Each line describes a single operation using three fields separated by single spaces:
+the decimal window ID, the operation, and the window name.
+Reading from
+.B log
+blocks until there is an operation to report, so reading the file
+can be used to monitor editor activity and react to changes.
+The reported operations are
+.L new
+(window creation),
+.L zerox
+(window creation via zerox),
+.LR get ,
+.LR put ,
+and
+.LR del
+(window deletion).
+The window name can be the empty string; in particular it is empty in
+.L new
+log entries corresponding to windows created by external programs.
+.TP
.B new
-A directory analogous to the numbered directories
+is a directory analogous to the numbered directories
.RI ( q.v. ).
Accessing any
file in