about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorPeter Stephenson <pws@zsh.org>2015-02-11 12:52:22 +0000
committerPeter Stephenson <pws@zsh.org>2015-02-11 12:52:22 +0000
commit638bccb1c5e85da44f0dd551cc97bd522e633b4b (patch)
tree12854215893d51eb6e5d5164852d9452460d9e62 /Doc/Zsh
parent0209635832f519401ce9c45b675ef871be105cfc (diff)
downloadzsh-638bccb1c5e85da44f0dd551cc97bd522e633b4b.tar.gz
zsh-638bccb1c5e85da44f0dd551cc97bd522e633b4b.tar.xz
zsh-638bccb1c5e85da44f0dd551cc97bd522e633b4b.zip
users/19850: add pattern support to watch variable
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/params.yo14
1 files changed, 13 insertions, 1 deletions
diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo
index ee7c05412..273be21e4 100644
--- a/Doc/Zsh/params.yo
+++ b/Doc/Zsh/params.yo
@@ -1472,15 +1472,27 @@ vindex(watch)
 vindex(WATCH)
 item(tt(watch) <S> <Z> (tt(WATCH) <S>))(
 An array (colon-separated list) of login/logout events to report.
+
 If it contains the single word `tt(all)', then all login/logout events
 are reported.  If it contains the single word `tt(notme)', then all
 events are reported as with `tt(all)' except tt($USERNAME).
+
 An entry in this list may consist of a username,
 an `tt(@)' followed by a remote hostname,
-and a `tt(%)' followed by a line (tty).
+and a `tt(%)' followed by a line (tty).  Any of these may
+be a pattern (be sure to quote this during the assignment to
+tt(watch) so that it does not immediately perform file generation);
+the setting of the tt(EXTENDED_GLOB) option is respected.
 Any or all of these components may be present in an entry;
 if a login/logout event matches all of them,
 it is reported.
+
+For example, with the tt(EXTENDED_GLOB) option set, the following:
+
+example(watch=('^(pws|barts)'))
+
+causes reports for activity assoicated with any user other than tt(pws)
+or tt(barts).
 )
 vindex(WATCHFMT)
 item(tt(WATCHFMT))(