WaitNotify                                                         WaitNotify

   NAME
        WaitNotify -- Wait for a file or directory modification

   SYNOPSIS
        WaitNotify NAME/A/M,QUIET/S,FMT=FORMAT/K

   FUNCTION
        WaitNotify posts a notification request on the given files
        or directories.  The command will not return until at least
        one of them has been modified.  For files, it will return
        after the file is closed.

        The optional format string will be printed when the file or
        directory changes.  The first "%s" in it will be replaced by
        the name.

   INPUTS
        NAME          - name of the files or directories which you want
                        to observe
        QUIET         - suppresses warnings and error messages (but sets
                        the return value to allow later diagnostis
        FORMAT        - string to print on exit.

   EXAMPLES
        ;Wait for a change in our startup-sequence
        WaitNotify S:Startup-Sequence

        ;Wait for a change in either startup script and report its name
        WaitNotify S:Startup-Sequence S:User-Startup FMT="%s*N"

        ;Show the first file which changes via More
        More `WaitNotify S:Startup-Sequence S:User-Startup FMT=%s`

   BUGS
        Not all filesystems will support file notification. In particular,
        most network filesystems won't support it.


   DISCLAIMER
        This file is part of the WaitNotify distribution.

        WaitNotify is free software; you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published
        by the Free Software Foundation; either version 1 of the License,
        or (at your option) any later version.

        WaitNotify is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
        See the GNU General Public License for more details.

        You should have received a copy of the GNU General Public License
        along with the program; see the file COPYING.  If not, write to
        the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

   COPYRIGHT
        WaitNotify is Copyright (C)1994 by Tobias Ferber.
        You can reach me via E-mail: ukjg@rz.uni-karlsruhe.de

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 4960   12474  39.8% -lh5- 6b1c Dec 14  1994 WaitNotify/COPYING
[generic]                  527     939  56.1% -lh5- 71fe Dec 14  1994 WaitNotify/Distfile
[generic]                  591    1077  54.9% -lh5- d013 Dec 14  1994 WaitNotify/DMakefile
[generic]                 6207   10280  60.4% -lh5- f400 Dec 14  1994 WaitNotify/WaitNotify
[generic]                 2358    6360  37.1% -lh5- 143c Dec 14  1994 WaitNotify/waitnotify.c
[generic]                 1041    2106  49.4% -lh5- 72e8 Dec 14  1994 WaitNotify/WaitNotify.doc
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         6 files   15684   33236  47.2%            Dec 16  1994