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.



   HISTORY
    - v1.2 : fixed memory leak on command line argument (Xenic)


   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
 AmigaOS4 version by Alexandre Balaban, contact me for any AmigaOS4
 specific issue via E-Mail: alexandre#balaban.fr (replace # by ())