diff options
author | Russ Cox <rsc@swtch.com> | 2014-04-30 12:14:29 -0400 |
---|---|---|
committer | Russ Cox <rsc@swtch.com> | 2014-04-30 12:14:29 -0400 |
commit | 4a3fb87264f8bc03fc62f00ef335056f30d18023 (patch) | |
tree | 77d52013a1fbb6fd967c1e146d5ddbf5ca0c065d /man/man4 | |
parent | 833216fef8b946895956737d205bcad7031bf06f (diff) | |
download | plan9port-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/man4')
-rw-r--r-- | man/man4/acme.4 | 28 |
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 |