From 4a3fb87264f8bc03fc62f00ef335056f30d18023 Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Wed, 30 Apr 2014 12:14:29 -0400 Subject: 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 --- man/man4/acme.4 | 28 ++++++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) (limited to 'man/man4') 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 -- cgit v1.2.3