Short:        Wait for a file or diretory modification
Author:       Tobias Ferber, AOS4 version by uploader
Uploader:     Alexandre Balaban <alexandre balaban fr>
Type:         util/cli
Version:      1.2
Architecture: ppc-amigaos >= 4.0.5

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 @)