1File::ChangeNotify(3) User Contributed Perl DocumentationFile::ChangeNotify(3)
2
3
4

NAME

6       File::ChangeNotify - Watch for changes to files, cross-platform style
7

VERSION

9       version 0.16
10

SYNOPSIS

12           use File::ChangeNotify;
13
14           my $watcher =
15               File::ChangeNotify->instantiate_watcher
16                   ( directories => [ '/my/path', '/my/other' ],
17                     filter      => qr/\.(?:pm|conf|yml)$/,
18                   );
19
20           if ( my @events = $watcher->new_events() ) { ... }
21
22           # blocking
23           while ( my @events = $watcher->wait_for_events() ) { ... }
24

DESCRIPTION

26       This module provides an API for creating a File::ChangeNotify::Watcher
27       subclass that will work on your platform.
28
29       Most of the documentation for this distro is in
30       File::ChangeNotify::Watcher.
31

METHODS

33       This class provides the following methods:
34
35   File::ChangeNotify->instantiate_watcher(...)
36       This method looks at each available subclass of
37       File::ChangeNotify::Watcher and instantiates the first one it can load,
38       using the arguments you provided.
39
40       It always tries to use the File::ChangeNotify::Watcher::Default class
41       last, on the assumption that any other class that is available is a
42       better option.
43
44   File::ChangeNotify->usable_classes()
45       Returns a list of all the loadable File::ChangeNotify::Watcher
46       subclasses.
47

BUGS

49       Please report any bugs or feature requests to
50       "bug-file-changenotify@rt.cpan.org", or through the web interface at
51       <http://rt.cpan.org>.  I will be notified, and then you'll
52       automatically be notified of progress on your bug as I make changes.
53

DONATIONS

55       If you'd like to thank me for the work I've done on this module, please
56       consider making a "donation" to me via PayPal. I spend a lot of free
57       time creating free software, and would appreciate any support you'd
58       care to offer.
59
60       Please note that I am not suggesting that you must do this in order for
61       me to continue working on this particular software. I will continue to
62       do so, inasmuch as I have in the past, for as long as it interests me.
63
64       Similarly, a donation made in this way will probably not make me work
65       on this software much more, unless I get so many donations that I can
66       consider working on free software full time, which seems unlikely at
67       best.
68
69       To donate, log into PayPal and send money to autarch@urth.org or use
70       the button on this page: http://www.urth.org/~autarch/fs-donation.html
71       <http://www.urth.org/~autarch/fs-donation.html>
72

AUTHOR

74         Dave Rolsky <autarch@urth.org>
75

77       This software is Copyright (c) 2010 by Dave Rolsky.
78
79       This is free software, licensed under:
80
81         The Artistic License 2.0
82
83
84
85perl v5.12.1                      2010-07-12             File::ChangeNotify(3)
Impressum