Short:    Wait for a file or diretory modification
Author:   ukjg@rz.rz.uni-karlsruhe.de (Tobias Ferber)
Uploader: ferber@rpk.mach.uni-karlsruhe.de (Tobias Ferber)
Type:     util/cli

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


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
   12474    4960 60.2% 14-Dec-94 18:43:58  WaitNotify/COPYING
     939     527 43.8% 14-Dec-94 18:43:58  WaitNotify/Distfile
    1077     591 45.1% 14-Dec-94 18:43:58  WaitNotify/DMakefile
   10280    6207 39.6% 14-Dec-94 18:43:58  WaitNotify/WaitNotify
    6360    2358 62.9% 14-Dec-94 18:43:58  WaitNotify/waitnotify.c
    2106    1041 50.5% 14-Dec-94 18:43:58  WaitNotify/WaitNotify.doc
-------- ------- ----- --------- --------
   33236   15684 52.8% 16-Dec-94 00:11:18   6 files