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 - vci...@novell.com + +- 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: opensuse-commit+unsubscr...@opensuse.org For additional commands, e-mail: opensuse-commit+h...@opensuse.org