r64673 - in /branches/upstream/libproc-simple-perl/current: Changes META.yml Makefile.PL README Simple.pm
carnil at users.alioth.debian.org
carnil at users.alioth.debian.org
Sun Nov 7 13:17:02 UTC 2010
Author: carnil
Date: Sun Nov 7 13:16:37 2010
New Revision: 64673
URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=64673
Log:
[svn-upgrade] new version libproc-simple-perl (1.27)
Modified:
branches/upstream/libproc-simple-perl/current/Changes
branches/upstream/libproc-simple-perl/current/META.yml
branches/upstream/libproc-simple-perl/current/Makefile.PL
branches/upstream/libproc-simple-perl/current/README
branches/upstream/libproc-simple-perl/current/Simple.pm
Modified: branches/upstream/libproc-simple-perl/current/Changes
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libproc-simple-perl/current/Changes?rev=64673&op=diff
==============================================================================
--- branches/upstream/libproc-simple-perl/current/Changes (original)
+++ branches/upstream/libproc-simple-perl/current/Changes Sun Nov 7 13:16:37 2010
@@ -1,6 +1,9 @@
######################################################################
Proc::Simple CHANGES
######################################################################
+
+ From 1.26: [RT 62285] Pod fix for redirect_output()
+ Fixed github link
from 1.25: Localize special variables so that the exit status
from waitpid doesn't leak out, causing exit status
Modified: branches/upstream/libproc-simple-perl/current/META.yml
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libproc-simple-perl/current/META.yml?rev=64673&op=diff
==============================================================================
--- branches/upstream/libproc-simple-perl/current/META.yml (original)
+++ branches/upstream/libproc-simple-perl/current/META.yml Sun Nov 7 13:16:37 2010
@@ -1,6 +1,6 @@
--- #YAML:1.0
name: Proc-Simple
-version: 1.26
+version: 1.27
abstract: ~
author: []
license: unknown
@@ -18,7 +18,7 @@
directory:
- t
- inc
-generated_by: ExtUtils::MakeMaker version 6.50
+generated_by: ExtUtils::MakeMaker version 6.55_02
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
Modified: branches/upstream/libproc-simple-perl/current/Makefile.PL
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libproc-simple-perl/current/Makefile.PL?rev=64673&op=diff
==============================================================================
--- branches/upstream/libproc-simple-perl/current/Makefile.PL (original)
+++ branches/upstream/libproc-simple-perl/current/Makefile.PL Sun Nov 7 13:16:37 2010
@@ -1,5 +1,13 @@
use ExtUtils::MakeMaker;
+
+my $meta_merge = {
+ META_MERGE => {
+ resources => {
+ repository => 'http://github.com/mschilli/proc-simple-perl',
+ },
+ }
+};
WriteMakefile(
'VERSION_FROM' => "Simple.pm",
@@ -9,9 +17,5 @@
'Test::More' => 0,
'IO::Handle' => 0,
},
- META_MERGE => {
- resources => {
- repository => 'http://github.com/mschilli/proc-simple-perl',
- }
- },
- );
+ $ExtUtils::MakeMaker::VERSION >= 6.50 ? (%$meta_merge) : (),
+);
Modified: branches/upstream/libproc-simple-perl/current/README
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libproc-simple-perl/current/README?rev=64673&op=diff
==============================================================================
--- branches/upstream/libproc-simple-perl/current/README (original)
+++ branches/upstream/libproc-simple-perl/current/README Sun Nov 7 13:16:37 2010
@@ -1,5 +1,5 @@
######################################################################
- Proc::Simple 1.26
+ Proc::Simple 1.27
######################################################################
NAME
@@ -29,9 +29,12 @@
$myproc->kill(); # Kill Process (SIGTERM)
+
+
$myproc->kill("SIGUSR1"); # Send specified signal
$myproc->exit_status(); # Return exit status of process
+
Proc::Simple::debug($level); # Turn debug on
@@ -106,56 +109,54 @@
self-defined subroutines (like "foo()") in a new process.
Starting External Programs
- For an external program to be started, call
-
- $status = $proc->start("program-name");
-
- If you want to pass a couple of parameters to the launched program,
- there's two options: You can either pass them in one argument like
- in
-
- $status = $proc->start("/bin/echo hello world");
-
- or in several arguments like in
-
- $status = $proc->start("/bin/echo", "hello", "world");
-
- Just as in Perl's function "system()", there's a big difference
- between the two methods: If you provide one argument containing a
- blank-separated command line, your shell is going to process any
- meta-characters (if you choose to use some) before the process is
- actually launched:
-
- $status = $proc->start("/bin/ls -l /etc/initt*");
-
- will expand "/etc/initt*" to "/etc/inittab" before running the "ls"
- command. If, on the other hand, you say
-
- $status = $proc->start("/bin/ls", "-l", "*");
-
- the "*" will stay unexpanded, meaning you'll look for a file with
- the literal name "*" (which is unlikely to exist on your system
- unless you deliberately create confusingly named files :). For more
- info on this, look up "perldoc -f exec".
+ For an external program to be started, call
+
+ $status = $proc->start("program-name");
+
+ If you want to pass a couple of parameters to the launched program,
+ there's two options: You can either pass them in one argument like in
+
+ $status = $proc->start("/bin/echo hello world");
+
+ or in several arguments like in
+
+ $status = $proc->start("/bin/echo", "hello", "world");
+
+ Just as in Perl's function "system()", there's a big difference between
+ the two methods: If you provide one argument containing a
+ blank-separated command line, your shell is going to process any
+ meta-characters (if you choose to use some) before the process is
+ actually launched:
+
+ $status = $proc->start("/bin/ls -l /etc/initt*");
+
+ will expand "/etc/initt*" to "/etc/inittab" before running the "ls"
+ command. If, on the other hand, you say
+
+ $status = $proc->start("/bin/ls", "-l", "*");
+
+ the "*" will stay unexpanded, meaning you'll look for a file with the
+ literal name "*" (which is unlikely to exist on your system unless you
+ deliberately create confusingly named files :). For more info on this,
+ look up "perldoc -f exec".
Starting Subroutines
- If, on the other hand, you want to start a Perl subroutine in the
- background, simply provide the function reference like
-
- $status = $proc->start(\&your_function);
-
- or supply an unnamed subroutine:
-
- $status = $proc->start( sub { sleep(1) } );
-
- You can also provide additional parameters to be passed to the
- function:
-
- $status = $proc->start(\&printme, "hello", "world");
-
- The *start* Method returns immediately after starting the specified
- process in background, i.e. non-blocking mode. It returns *1* if the
- process has been launched sucessfully and *0* if not.
+ If, on the other hand, you want to start a Perl subroutine in the
+ background, simply provide the function reference like
+
+ $status = $proc->start(\&your_function);
+
+ or supply an unnamed subroutine:
+
+ $status = $proc->start( sub { sleep(1) } );
+
+ You can also provide additional parameters to be passed to the function:
+
+ $status = $proc->start(\&printme, "hello", "world");
+
+ The *start* Method returns immediately after starting the specified
+ process in background, i.e. non-blocking mode. It returns *1* if the
+ process has been launched sucessfully and *0* if not.
poll
The *poll* method checks if the process is still running
@@ -196,7 +197,8 @@
redirect_output
This allows to redirect the stdout and/or stderr output to a file.
- Specify undef to leave th
+ Specify undef to leave the stderr/stdout handles of the process
+ alone.
# stdout to a file, left stderr unchanged
$proc->redirect_output ("/tmp/someapp.stdout", undef);
@@ -245,40 +247,52 @@
switches them on, Proc::Simple::debug(0) keeps Proc::Simple quiet.
NOTE
- Please keep in mind that there is no guarantee that the SIGTERM
- signal really terminates a process. Processes can have signal
- handlers defined that avoid the shutdown. If in doubt, whether a
- process still exists, check it repeatedly with the *poll* routine
- after sending the signal.
+ Please keep in mind that there is no guarantee that the SIGTERM signal
+ really terminates a process. Processes can have signal handlers defined
+ that avoid the shutdown. If in doubt, whether a process still exists,
+ check it repeatedly with the *poll* routine after sending the signal.
REQUIREMENTS
- I'd recommend using perl 5.6.0 although it might also run with 5.003
- -- if you don't have it, this is the time to upgrade!
-
- LEGALESE Copyright 1996 by Mike Schilli, all rights reserved. This
- program is free software, you can redistribute it and/or modify it
- under the same terms as Perl itself.
+ I'd recommend using perl 5.6.0 although it might also run with 5.003 --
+ if you don't have it, this is the time to upgrade!
+
+ LEGALESE Copyright 1996 by Mike Schilli, all rights reserved. This
+ program is free software, you can redistribute it and/or modify it under
+ the same terms as Perl itself.
AUTHOR
- Michael Schilli <michael at perlmeister.com>
-
- Contributors:
-
- Tim Jenness <t.jenness at jach.hawaii.edu> did
- kill_on_destroy/signal_on_destroy/pid
-
- Mark R. Southern <mark_southern at merck.com> worked on EXIT_STATUS
- tracking
-
- Tobias Jahn <tjahn at users.sourceforge.net> added redirection to
- stdout/stderr
-
- Clauss Strauch <Clauss_Strauch at aquila.fac.cs.cmu.edu> suggested the
- multi-arg start()-methods.
-
- Chip Capelik contributed a patch with the wait() method.
-
- Jeff Holt provided a patch for time tracking with t0() and t1().
-
- Brad Cavanagh fixed RT33440 (unreliable $?)
-
+ Michael Schilli <michael at perlmeister.com>
+
+ Contributors:
+
+ Tim Jenness <t.jenness at jach.hawaii.edu> did
+ kill_on_destroy/signal_on_destroy/pid
+
+ Mark R. Southern <mark_southern at merck.com> worked on EXIT_STATUS
+ tracking
+
+ Tobias Jahn <tjahn at users.sourceforge.net> added redirection to
+ stdout/stderr
+
+ Clauss Strauch <Clauss_Strauch at aquila.fac.cs.cmu.edu> suggested the
+ multi-arg start()-methods.
+
+ Chip Capelik contributed a patch with the wait() method.
+
+ Jeff Holt provided a patch for time tracking with t0() and t1().
+
+ Brad Cavanagh fixed RT33440 (unreliable $?)
+
+POD ERRORS
+ Hey! The above document had some coding errors, which are explained
+ below:
+
+ Around line 178:
+ You forgot a '=back' before '=head2'
+
+ Around line 282:
+ '=item' outside of any '=over'
+
+ Around line 720:
+ You forgot a '=back' before '=head1'
+
Modified: branches/upstream/libproc-simple-perl/current/Simple.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libproc-simple-perl/current/Simple.pm?rev=64673&op=diff
==============================================================================
--- branches/upstream/libproc-simple-perl/current/Simple.pm (original)
+++ branches/upstream/libproc-simple-perl/current/Simple.pm Sun Nov 7 13:16:37 2010
@@ -117,7 +117,7 @@
@ISA = qw(Exporter AutoLoader);
@EXPORT = qw( );
-$VERSION = '1.26';
+$VERSION = '1.27';
######################################################################
# Globals: Debug and the mysterious waitpid nohang constant.
@@ -411,7 +411,7 @@
=item redirect_output
This allows to redirect the stdout and/or stderr output to a file.
-Specify undef to leave th
+Specify undef to leave the stderr/stdout handles of the process alone.
# stdout to a file, left stderr unchanged
$proc->redirect_output ("/tmp/someapp.stdout", undef);
More information about the Pkg-perl-cvs-commits
mailing list