X-Git-Url: https://ruderich.org/simon/gitweb/?p=wall-notify%2Fwall-notify.git;a=blobdiff_plain;f=README;h=4027cd9ef0a4000374c11fbc361d63850e06f66e;hp=132b6c3e17dc2f92d20d5b5343150d2ce61191ed;hb=628ef9ac5b77a08e1fef630a3663583e2128c416;hpb=aaaaf11639fafcd1c926cfcccd282182551f3382

diff --git a/README b/README
index 132b6c3..4027cd9 100644
--- a/README
+++ b/README
@@ -11,6 +11,9 @@ wall messages are either directly created by root with the `wall` command or
 sent by other programs like `reboot`, `shutdown` or other processes like NFS
 to warn users when the NFS server terminates.
 
+Optionally X11 can be used to automatically terminate wall-notify when the
+current X11 session terminates, i.e. when the user logs out. See below.
+
 wall-notify is licensed under GPL 3 (or later).
 
 
@@ -20,35 +23,58 @@ DEPENDENCIES
 - C89 compiler
 - libutempter or utmpx.h (utmpx.x requires a setgid utmp binary)
 
+- optional: X11 headers and library, necessary for X11 support
+
 
 INSTALLATION
 ------------
 
     ./configure && make && make check
 
+The libutempter is not available, the binary must be setgid utmp:
+
+    chgrp utmp src/wall-notify
+    chmod g+s src/wall-notify
+
 
 USAGE
 -----
 
 To dump all wall messages to stdout use:
 
-    ./wall-notify cat
+    ./src/wall-notify cat
 
 All arguments passed to `wall-notify` are used when execing the process, e.g.
 to replace all spaces with underlines use:
 
-    ./wall-notify sed 's/ /_/g'
+    ./src/wall-notify sed 's/ /_/g'
 
 To display the messages with `xmessage` use:
 
-    ./wall-notfiy xmessage -file -
+    ./src/wall-notify xmessage -file -
+
+However this will display '^M' (carriage-return) and other control characters
+in the message. For a simple wrapper script which removes those, see
+`contrib/message-helper`:
+
+    ./src/wall-notify contrib/message.sh xmessage -file -
 
 The shell is not used when running the program.
 
 
+If X11 support is compiled in then the '-X' option can be used to terminate
+wall-notify automatically when the X session quits. This is useful when
+wall-notify is started in `.xinitrc` and should quit when the X session ends,
+i.e the user logs out:
+
+    ./src/wall-notify -X cat
+
+
 BUGS
 ----
 
+Doesn't work on OpenBSD which has no support for utmpx.h.
+
 If you find any bugs not mentioned in this document please report them to
 <simon@ruderich.org> with wall-notify in the subject.