Hello community,
here is the log from the commit of package perl-Linux-Inotify2 for
openSUSE:Factory
checked in at Fri Jun 17 11:23:15 CEST 2011.
--------
--- perl-Linux-Inotify2/perl-Linux-Inotify2.changes 2011-03-17
08:56:27.000000000 +0100
+++
/mounts/work_src_done/STABLE/perl-Linux-Inotify2/perl-Linux-Inotify2.changes
2011-06-16 09:53:57.000000000 +0200
@@ -1,0 +2,8 @@
+Thu Jun 16 07:37:42 UTC 2011 - [email protected]
+
+- update to 1.22
+ - use a more useful definition of IN_xxx methods - any bits, not
+ a match. (pointed out by Anatoliy Grishayev).
+ - slightly reworked the documentation.
+
+-------------------------------------------------------------------
calling whatdependson for head-i586
Old:
----
Linux-Inotify2-1.21.tar.bz2
New:
----
Linux-Inotify2-1.22.tar.bz2
_service:format_spec_file:perl-Linux-Inotify2.spec
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ _service:format_spec_file:perl-Linux-Inotify2.spec ++++++
#
# spec file for package perl-Linux-Inotify2
#
# Copyright (c) 2011 SUSE LINUX Products GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.
# Please submit bugfixes or comments via http://bugs.opensuse.org/
#
Name: perl-Linux-Inotify2
Summary: scalable directory/file change notification
Version: 1.22
Release: 13
Group: Development/Libraries/Perl
License: GPL+ or Artistic
Url: http://www.cpan.org/modules/by-module/Linux/
Source: Linux-Inotify2-%{version}.tar.bz2
BuildRoot: %{_tmppath}/%{name}-%{version}-build
BuildRequires: perl perl-common-sense perl-macros
Requires: perl-common-sense
%{perl_requires}
%description
This module implements an interface to the Linux 2.6.13 and later
Inotify file/directory change notification sytem.
%prep
%setup -q -n Linux-Inotify2-%{version}
%build
perl Makefile.PL
make %{?_smp_mflags}
%check
make test
%install
%perl_make_install
%perl_process_packlist
%clean
rm -rf $RPM_BUILD_ROOT
%files
%defattr(-,root,root)
%doc README Changes MANIFEST COPYING
%doc %{_mandir}/man3/*Inotify2*.gz
%{perl_vendorarch}/auto/Linux
%{perl_vendorarch}/Linux
%changelog
++++++ perl-Linux-Inotify2.spec ++++++
--- /var/tmp/diff_new_pack.rGYdRf/_old 2011-06-17 11:22:49.000000000 +0200
+++ /var/tmp/diff_new_pack.rGYdRf/_new 2011-06-17 11:22:49.000000000 +0200
@@ -19,8 +19,8 @@
Name: perl-Linux-Inotify2
Summary: scalable directory/file change notification
-Version: 1.21
-Release: 13
+Version: 1.22
+Release: 1
Group: Development/Libraries/Perl
License: GPL+ or Artistic
Url: http://www.cpan.org/modules/by-module/Linux/
++++++ Linux-Inotify2-1.21.tar.bz2 -> Linux-Inotify2-1.22.tar.bz2 ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/Linux-Inotify2-1.21/Changes
new/Linux-Inotify2-1.22/Changes
--- old/Linux-Inotify2-1.21/Changes 2009-09-21 10:07:29.000000000 +0200
+++ new/Linux-Inotify2-1.22/Changes 2011-06-14 08:41:28.000000000 +0200
@@ -3,6 +3,11 @@
TODO: document move/renaming issues for fullname
TODO: find_watchers($path), or maybe just ->watchers
+1.22 Tue Jun 14 08:34:38 CEST 2011
+ - use a more useful definition of IN_xxx methods - any bits, not
+ a match. (pointed out by Anatoliy Grishayev).
+ - slightly reworked the documentation.
+
1.21 Mon Sep 21 10:07:07 CEST 2009
- fix a couple of typoes, as pointed out by Grant McLean.
- rely on common::sense for stricter namespace checking.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/Linux-Inotify2-1.21/Inotify2.pm
new/Linux-Inotify2-1.22/Inotify2.pm
--- old/Linux-Inotify2-1.21/Inotify2.pm 2009-09-21 10:08:02.000000000 +0200
+++ new/Linux-Inotify2-1.22/Inotify2.pm 2011-06-14 08:41:39.000000000 +0200
@@ -57,7 +57,7 @@
=head1 DESCRIPTION
This module implements an interface to the Linux 2.6.13 and later Inotify
-file/directory change notification sytem.
+file/directory change notification system.
It has a number of advantages over the Linux::Inotify module:
@@ -84,7 +84,7 @@
use base 'Exporter';
BEGIN {
- our $VERSION = '1.21';
+ our $VERSION = '1.22';
our @EXPORT = qw(
IN_ACCESS IN_MODIFY IN_ATTRIB IN_CLOSE_WRITE
IN_CLOSE_NOWRITE IN_OPEN IN_MOVED_FROM IN_MOVED_TO
@@ -102,11 +102,11 @@
=item my $inotify = new Linux::Inotify2
Create a new notify object and return it. A notify object is kind of a
-container that stores watches on filesystem names and is responsible for
+container that stores watches on file system names and is responsible for
handling event data.
-On error, C<undef> is returned and C<$!> will be set accordingly. The
followign errors
-are documented:
+On error, C<undef> is returned and C<$!> will be set accordingly. The
+following errors are documented:
ENFILE The system limit on the total number of file descriptors has been
reached.
EMFILE The user limit on the total number of inotify instances has been
reached.
@@ -135,9 +135,9 @@
on the pathname C<$name> as given in C<$mask>, which can be any of the
following constants (all exported by default) ORed together.
-"file" refers to any filesystem object in the watch'ed object (always a
+"file" refers to any file system object in the watched object (always a
directory), that is files, directories, symlinks, device nodes etc., while
-"object" refers to the object the watch has been set on itself:
+"object" refers to the object the watcher has been set on itself:
IN_ACCESS object was accessed
IN_MODIFY object was modified
@@ -211,8 +211,9 @@
=item $inotify->fileno
-Returns the fileno for this notify object. You are responsible for calling
-the C<poll> method when this fileno becomes ready for reading.
+Returns the file descriptor for this notify object. When in non-blocking
+mode, you are responsible for calling the C<poll> method when this file
+descriptor becomes ready for reading.
=cut
@@ -234,10 +235,10 @@
=item $count = $inotify->poll
-Reads events from the kernel and handles them. If the notify fileno is
-blocking (the default), then this method waits for at least one event
-(and thus returns true unless an error occurs). Otherwise it returns
-immediately when no pending events could be read.
+Reads events from the kernel and handles them. If the notify file
+descriptor is blocking (the default), then this method waits for at least
+one event (and thus returns true unless an error occurs). Otherwise it
+returns immediately when no pending events could be read.
Returns the count of events that have been handled.
@@ -247,11 +248,15 @@
scalar &read
}
-=item $count = $inotify->read
+=item @events = $inotify->read
+
+Reads events from the kernel. Blocks when the file descriptor is in
+blocking mode (default) until any event arrives. Returns list of
+C<Linux::Inotify2::Event> objects or empty list if none (non-blocking
+mode) or error occurred ($! should be checked).
-Reads events from the kernel. Blocks in blocking mode (default) until any
-event arrives. Returns list of C<Linux::Inotify2::Event> objects or empty
-list if none (non-blocking mode) or error occured ($! should be checked).
+Normally you shouldn't use this function, but instead use watcher
+callbacks and call C<< ->poll >>.
=cut
@@ -289,7 +294,7 @@
=head2 The Linux::Inotify2::Event Class
-Objects of this class are handed as first argument to the watch
+Objects of this class are handed as first argument to the watcher
callback. It has the following members and methods:
=over 4
@@ -304,35 +309,36 @@
=item $event->{name}
-The path of the filesystem object, relative to the watch name.
+The path of the file system object, relative to the watched name.
-=item $watch->fullname
+=item $event->fullname
Returns the "full" name of the relevant object, i.e. including the C<name>
-member of the watcher (if the the watch is on a directory and a dir entry
-is affected), or simply the C<name> member itself when the object is the
-watch object itself.
+member of the watcher (if the watch object is on a directory and a
+directory entry is affected), or simply the C<name> member itself when the
+object is the watch object itself.
=item $event->mask
=item $event->{mask}
-The received event mask. In addition the the events described for
-C<$inotify->watch>, the following flags (exported by default) can be set:
+The received event mask. In addition to the events described for C<<
+$inotify->watch >>, the following flags (exported by default) can be set:
IN_ISDIR event object is a directory
IN_Q_OVERFLOW event queue overflowed
# when any of the following flags are set,
# then watchers for this event are automatically canceled
- IN_UNMOUNT filesystem for watch'ed object was unmounted
+ IN_UNMOUNT filesystem for watched object was unmounted
IN_IGNORED file was ignored/is gone (no more events are delivered)
IN_ONESHOT only one event was generated
=item $event->IN_xxx
-Returns a boolean that returns true if the event mask matches the
-event. All of the C<IN_xxx> constants can be used as methods.
+Returns a boolean that returns true if the event mask contains any events
+specified by the mask. All of the C<IN_xxx> constants can be used as
+methods.
=item $event->cookie
@@ -363,12 +369,12 @@
for my $name (@Linux::Inotify2::EXPORT) {
my $mask = &{"Linux::Inotify2::$name"};
- *$name = sub { ($_[0]{mask} & $mask) == $mask };
+ *$name = sub { $_[0]{mask} & $mask };
}
=head2 The Linux::Inotify2::Watch Class
-Watch objects are created by calling the C<watch> method of a notifier.
+Watcher objects are created by calling the C<watch> method of a notifier.
It has the following members and methods:
@@ -396,7 +402,7 @@
=item $watch->cancel
-Cancels/removes this watch. Future events, even if already queued queued,
+Cancels/removes this watcher. Future events, even if already queued queued,
will not be handled and resources will be freed.
=back
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/Linux-Inotify2-1.21/MANIFEST
new/Linux-Inotify2-1.22/MANIFEST
--- old/Linux-Inotify2-1.21/MANIFEST 2009-09-21 10:09:09.000000000 +0200
+++ new/Linux-Inotify2-1.22/MANIFEST 2011-06-14 08:41:43.000000000 +0200
@@ -9,4 +9,4 @@
eg/event
t/00_load.t
t/01_inotify.t
-META.yml Module meta-data (added by MakeMaker)
+META.json Module meta-data (added by MakeMaker)
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/Linux-Inotify2-1.21/META.json
new/Linux-Inotify2-1.22/META.json
--- old/Linux-Inotify2-1.21/META.json 1970-01-01 01:00:00.000000000 +0100
+++ new/Linux-Inotify2-1.22/META.json 2011-06-14 08:41:43.000000000 +0200
@@ -0,0 +1,28 @@
+{
+ "no_index" : {
+ "directory" : [
+ "t",
+ "inc"
+ ]
+ },
+ "meta-spec" : {
+ "version" : 1.4,
+ "url" : "http://module-build.sourceforge.net/META-spec-v1.4.html";
+ },
+ "generated_by" : "ExtUtils::MakeMaker::JSONMETA version 7.000",
+ "distribution_type" : "module",
+ "version" : "1.22",
+ "name" : "Linux-Inotify2",
+ "author" : [],
+ "license" : "unknown",
+ "build_requires" : {
+ "ExtUtils::MakeMaker" : 0
+ },
+ "requires" : {
+ "common::sense" : 0
+ },
+ "abstract" : null,
+ "configure_requires" : {
+ "ExtUtils::MakeMaker" : 0
+ }
+}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/Linux-Inotify2-1.21/META.yml
new/Linux-Inotify2-1.22/META.yml
--- old/Linux-Inotify2-1.21/META.yml 2009-09-21 10:09:09.000000000 +0200
+++ new/Linux-Inotify2-1.22/META.yml 1970-01-01 01:00:00.000000000 +0100
@@ -1,28 +0,0 @@
-{
- "no_index" : {
- "directory" : [
- "t",
- "inc"
- ]
- },
- "meta-spec" : {
- "version" : 1.4,
- "url" : "http://module-build.sourceforge.net/META-spec-v1.4.html";
- },
- "generated_by" : "ExtUtils::MakeMaker version 6.50",
- "distribution_type" : "module",
- "version" : "1.21",
- "name" : "Linux-Inotify2",
- "author" : [],
- "license" : "unknown",
- "build_requires" : {
- "ExtUtils::MakeMaker" : 0
- },
- "requires" : {
- "common::sense" : 0
- },
- "abstract" : null,
- "configure_requires" : {
- "ExtUtils::MakeMaker" : 0
- }
-}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/Linux-Inotify2-1.21/README
new/Linux-Inotify2-1.22/README
--- old/Linux-Inotify2-1.21/README 2009-09-21 10:09:09.000000000 +0200
+++ new/Linux-Inotify2-1.22/README 2011-06-14 08:41:43.000000000 +0200
@@ -52,7 +52,7 @@
DESCRIPTION
This module implements an interface to the Linux 2.6.13 and later
- Inotify file/directory change notification sytem.
+ Inotify file/directory change notification system.
It has a number of advantages over the Linux::Inotify module:
@@ -65,11 +65,11 @@
The Linux::Inotify2 Class
my $inotify = new Linux::Inotify2
Create a new notify object and return it. A notify object is kind of
- a container that stores watches on filesystem names and is
+ a container that stores watches on file system names and is
responsible for handling event data.
On error, "undef" is returned and $! will be set accordingly. The
- followign errors are documented:
+ following errors are documented:
ENFILE The system limit on the total number of file descriptors has
been reached.
EMFILE The user limit on the total number of inotify instances has
been reached.
@@ -85,9 +85,9 @@
events on the pathname $name as given in $mask, which can be any of
the following constants (all exported by default) ORed together.
- "file" refers to any filesystem object in the watch'ed object
+ "file" refers to any file system object in the watched object
(always a directory), that is files, directories, symlinks, device
- nodes etc., while "object" refers to the object the watch has been
+ nodes etc., while "object" refers to the object the watcher has been
set on itself:
IN_ACCESS object was accessed
@@ -139,30 +139,34 @@
});
$inotify->fileno
- Returns the fileno for this notify object. You are responsible for
- calling the "poll" method when this fileno becomes ready for
- reading.
+ Returns the file descriptor for this notify object. When in
+ non-blocking mode, you are responsible for calling the "poll" method
+ when this file descriptor becomes ready for reading.
$inotify->blocking ($blocking)
Clears ($blocking true) or sets ($blocking false) the "O_NONBLOCK"
flag on the file descriptor.
$count = $inotify->poll
- Reads events from the kernel and handles them. If the notify fileno
- is blocking (the default), then this method waits for at least one
- event (and thus returns true unless an error occurs). Otherwise it
- returns immediately when no pending events could be read.
+ Reads events from the kernel and handles them. If the notify file
+ descriptor is blocking (the default), then this method waits for at
+ least one event (and thus returns true unless an error occurs).
+ Otherwise it returns immediately when no pending events could be
+ read.
Returns the count of events that have been handled.
- $count = $inotify->read
- Reads events from the kernel. Blocks in blocking mode (default)
- until any event arrives. Returns list of "Linux::Inotify2::Event"
- objects or empty list if none (non-blocking mode) or error occured
- ($! should be checked).
+ @events = $inotify->read
+ Reads events from the kernel. Blocks when the file descriptor is in
+ blocking mode (default) until any event arrives. Returns list of
+ "Linux::Inotify2::Event" objects or empty list if none (non-blocking
+ mode) or error occurred ($! should be checked).
+
+ Normally you shouldn't use this function, but instead use watcher
+ callbacks and call "->poll".
The Linux::Inotify2::Event Class
- Objects of this class are handed as first argument to the watch
+ Objects of this class are handed as first argument to the watcher
callback. It has the following members and methods:
$event->w
@@ -171,18 +175,18 @@
$event->name
$event->{name}
- The path of the filesystem object, relative to the watch name.
+ The path of the file system object, relative to the watched name.
- $watch->fullname
+ $event->fullname
Returns the "full" name of the relevant object, i.e. including the
- "name" member of the watcher (if the the watch is on a directory and
- a dir entry is affected), or simply the "name" member itself when
- the object is the watch object itself.
+ "name" member of the watcher (if the watch object is on a directory
+ and a directory entry is affected), or simply the "name" member
+ itself when the object is the watch object itself.
$event->mask
$event->{mask}
- The received event mask. In addition the the events described for
- "$inotify-"watch>, the following flags (exported by default) can be
+ The received event mask. In addition to the events described for
+ "$inotify->watch", the following flags (exported by default) can be
set:
IN_ISDIR event object is a directory
@@ -190,13 +194,14 @@
# when any of the following flags are set,
# then watchers for this event are automatically canceled
- IN_UNMOUNT filesystem for watch'ed object was unmounted
+ IN_UNMOUNT filesystem for watched object was unmounted
IN_IGNORED file was ignored/is gone (no more events are
delivered)
IN_ONESHOT only one event was generated
$event->IN_xxx
- Returns a boolean that returns true if the event mask matches the
- event. All of the "IN_xxx" constants can be used as methods.
+ Returns a boolean that returns true if the event mask contains any
+ events specified by the mask. All of the "IN_xxx" constants can be
+ used as methods.
$event->cookie
$event->{cookie}
@@ -207,7 +212,7 @@
file.
The Linux::Inotify2::Watch Class
- Watch objects are created by calling the "watch" method of a notifier.
+ Watcher objects are created by calling the "watch" method of a notifier.
It has the following members and methods:
@@ -227,7 +232,7 @@
changed.
$watch->cancel
- Cancels/removes this watch. Future events, even if already queued
+ Cancels/removes this watcher. Future events, even if already queued
queued, will not be handled and resources will be freed.
SEE ALSO
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Remember to have fun...
--
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
