Hello community,
here is the log from the commit of package perl-Term-ReadKey for openSUSE:Factory checked in at 2014-06-02 07:03:00
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/perl-Term-ReadKey (Old)
and /work/SRC/openSUSE:Factory/.perl-Term-ReadKey.new (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "perl-Term-ReadKey"
Changes:
--------
--- /work/SRC/openSUSE:Factory/perl-Term-ReadKey/perl-Term-ReadKey.changes 2013-12-03 13:24:21.000000000 +0100
+++ /work/SRC/openSUSE:Factory/.perl-Term-ReadKey.new/perl-Term-ReadKey.changes 2014-06-02 07:03:02.000000000 +0200
@@ -1,0 +2,15 @@
+Thu May 29 16:47:00 UTC 2014 - stephan.barth@suse.com
+
+- Update to version 2.32 from 2.31
+ Upstream changes:
+ 2014-05-10 Jonathan Stowe
+ * Makefile.PL: Makefile.PL more specific
+ 2014-05-10 Jonathan Stowe
+ * : Merge pull request #2 from jacquesg/warnings Fix some warnings
+ 2014-03-09 Jonathan Stowe
+ * Configure.pm, META.yml, Makefile.PL: Don't index Configure.pm
+ 2014-03-03 Jonathan Stowe
+ * Changes, README, ReadKey.pm: Added documentation patch as per
+ Chris Marshall Bumped version
+
+-------------------------------------------------------------------
Old:
----
TermReadKey-2.31.tar.gz
New:
----
TermReadKey-2.32.tar.gz
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ perl-Term-ReadKey.spec ++++++
--- /var/tmp/diff_new_pack.1mHKsD/_old 2014-06-02 07:03:02.000000000 +0200
+++ /var/tmp/diff_new_pack.1mHKsD/_new 2014-06-02 07:03:02.000000000 +0200
@@ -1,7 +1,7 @@
#
# spec file for package perl-Term-ReadKey
#
-# Copyright (c) 2013 SUSE LINUX Products GmbH, Nuernberg, Germany.
+# Copyright (c) 2014 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
@@ -17,7 +17,7 @@
Name: perl-Term-ReadKey
-Version: 2.31
+Version: 2.32
Release: 0
Summary: Module for Simple Terminal Control
License: GPL-1.0+ or Artistic-1.0
++++++ TermReadKey-2.31.tar.gz -> TermReadKey-2.32.tar.gz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/TermReadKey-2.31/Changes new/TermReadKey-2.32/Changes
--- old/TermReadKey-2.31/Changes 2013-10-26 23:33:10.000000000 +0200
+++ new/TermReadKey-2.32/Changes 2014-05-10 15:01:55.000000000 +0200
@@ -0,0 +1,226 @@
+2014-05-10 Jonathan Stowe
+
+ * Makefile.PL: Makefile.PL more specific
+
+2014-05-10 Jonathan Stowe
+
+ * : Merge pull request #2 from jacquesg/warnings Fix some warnings
+
+2014-03-09 Jonathan Stowe
+
+ * Configure.pm, META.yml, Makefile.PL: Don't index Configure.pm
+
+2014-03-03 Jonathan Stowe
+
+ * Changes, README, ReadKey.pm: Added documentation patch as per
+ Chris Marshall Bumped version
+
+2013-10-28 Jonathan Stowe
+
+ * README: Some changes to README
+
+2013-10-28 Brian Wightman
+
+ * ReadKey.pm: Promote SUPPORT and LICENSE to top-level head sections SUPPORT and LICENSE sections were in item sections, but outside of
+ an over/back block.
+
+2013-10-27 Jonathan Stowe
+
+ * Makefile.PL, README, ReadKey.pm, ReadKey.xs, genchars.pl: Change
+ licensing Fix some warnings
+
+2013-10-26 Jonathan Stowe
+
+ * ReadKey.pm: Applied patch from rt #35669
+
+2013-10-26 Jonathan Stowe
+
+ * Makefile.PL, ReadKey.xs: Applied change from rt #26235 Also fixed
+ repo name
+
+2013-10-26 Jonathan Stowe
+
+ * ReadKey.pm: Patch from rt #35671
+
+2013-10-26 Jonathan Stowe
+
+ * ppport.h: Updated ppport.h as per #78831
+
+2013-10-26 Jonathan Stowe
+
+ * Makefile.PL: Changed distname per RT #87885 Added additional
+ metadata
+
+2013-10-26 Jonathan Stowe
+
+ * ReadKey.pm: Added changes for RT #86584
+
+2013-10-26 Jonathan Stowe
+
+ * ReadKey.pm: Added patch from jpeacock@cpan.org for RT #88266
+
+2011-04-19 Jonathan Stowe
+
+ * Changes: Added Changes
+
+2011-04-19 Jonathan Stowe
+
+ * : commit 40ba6a2a80ae495b921ab416f6b024014daac25e Author: Stas
+ Grabois <CENSORED> Date: Tue Jun 24 01:57:37 2008 -0800
+
+2006-01-13 jonathan
+
+ * MANIFEST, Makefile.PL: Added Changes git-svn-id: http://jstowe.googlecode.com/svn/trunk/TermReadKey@74
+ d4a3e428-c23c-0410-a93a-b1ce904c0fb3
+
+2005-01-12 Jonathan Stowe
+
+ * Configure.pm, MANIFEST, META.yml, Makefile.PL, README,
+ ReadKey.pm, ReadKey.xs, genchars.pl, ppport.h, test.pl: import
+ TermReadKey 2.30 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.30
+ git-cpan-authorid: JSTOWE git-cpan-file:
+ authors/id/J/JS/JSTOWE/TermReadKey-2.30.tar.gz
+
+2005-01-11 jonathan
+
+ * test.pl: Skip tests if /dev/tty for automated testing git-svn-id: http://jstowe.googlecode.com/svn/trunk/TermReadKey@53
+ d4a3e428-c23c-0410-a93a-b1ce904c0fb3
+
+2005-01-11 jonathan
+
+ * ReadKey.pm: Fixed POD git-svn-id: http://jstowe.googlecode.com/svn/trunk/TermReadKey@52
+ d4a3e428-c23c-0410-a93a-b1ce904c0fb3
+
+2005-01-11 jonathan
+
+ * README, ReadKey.pm, ReadKey.xs, genchars.pl, ppport.h: * Updated ppport.h * Fixed example in synopsis * termio branch not updated git-svn-id: http://jstowe.googlecode.com/svn/trunk/TermReadKey@51
+ d4a3e428-c23c-0410-a93a-b1ce904c0fb3
+
+2004-03-02 jonathan
+
+ * Put back in CVS git-svn-id: http://jstowe.googlecode.com/svn/trunk/TermReadKey@19
+ d4a3e428-c23c-0410-a93a-b1ce904c0fb3
+
+2002-07-28 Jonathan Stowe
+
+ * README, ReadKey.pm, ReadKey.xs, ppport.h, test.pl: import
+ TermReadKey 2.21 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.21
+ git-cpan-authorid: JSTOWE git-cpan-file:
+ authors/id/J/JS/JSTOWE/TermReadKey-2.21.tar.gz
+
+2002-05-24 Jonathan Stowe
+
+ * README, ReadKey.pm, ReadKey.xs: import TermReadKey 2.20 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.20
+ git-cpan-authorid: JSTOWE git-cpan-file:
+ authors/id/J/JS/JSTOWE/TermReadKey-2.20.tar.gz
+
+2002-03-21 Jonathan Stowe
+
+ * README, ReadKey.pm, ReadKey.xs: import TermReadKey 2.19 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.19
+ git-cpan-authorid: JSTOWE git-cpan-file:
+ authors/id/J/JS/JSTOWE/TermReadKey-2.19.tar.gz
+
+2002-02-10 Jonathan Stowe
+
+ * Configure.pm, Makefile.PL, README, ReadKey.pm, ReadKey.xs,
+ genchars.pl: import TermReadKey 2.18 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.18
+ git-cpan-authorid: JSTOWE git-cpan-file:
+ authors/id/J/JS/JSTOWE/TermReadKey-2.18.tar.gz
+
+2002-01-25 Jonathan Stowe
+
+ * Makefile.PL, README, ReadKey.pm, ReadKey.xs, test.pl: import
+ TermReadKey 2.17 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.17
+ git-cpan-authorid: JSTOWE git-cpan-file:
+ authors/id/J/JS/JSTOWE/TermReadKey-2.17.tar.gz
+
+2001-11-29 Jonathan Stowe
+
+ * ReadKey.pm, ReadKey.xs, genchars.pl, ppport.h: import TermReadKey
+ 2.16 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.16
+ git-cpan-authorid: JSTOWE git-cpan-file:
+ authors/id/J/JS/JSTOWE/TermReadKey-2.16.tar.gz
+
+2001-11-07 Jonathan Stowe
+
+ * ReadKey.pm, ReadKey.xs: import TermReadKey 2.15 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.15
+ git-cpan-authorid: JSTOWE git-cpan-file:
+ authors/id/J/JS/JSTOWE/TermReadKey-2.15.tar.gz
+
+1999-03-29 Kenneth Albanowski
+
+ * Makefile.PL, ReadKey.pm, ReadKey.xs, ppport.h: import TermReadKey
+ 2.14 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.14
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.14.tar.gz
+
+1999-03-24 Kenneth Albanowski
+
+ * MANIFEST, Makefile.PL, README, ReadKey.pm, ReadKey.xs,
+ genchars.pl, ppport.h: import TermReadKey 2.13 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.13
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.13.tar.gz
+
+1998-01-07 Kenneth Albanowski
+
+ * Makefile.PL, README, ReadKey.pm, ReadKey.xs, test.pl: import
+ TermReadKey 2.12 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.12
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.12.tar.gz
+
+1997-12-13 Kenneth Albanowski
+
+ * Makefile.PL, README, ReadKey.pm, ReadKey.xs, test.pl: import
+ TermReadKey 2.11 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.11
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.11.tar.gz
+
+1997-10-07 Kenneth Albanowski
+
+ * Makefile.PL, ReadKey.pm, ReadKey.xs, genchars.pl: import
+ TermReadKey 2.09 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.09
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.09.tar.gz
+
+1997-10-06 Kenneth Albanowski
+
+ * Makefile.PL, README, ReadKey.pm, ReadKey.xs: import TermReadKey
+ 2.08 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.08
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.08.tar.gz
+
+1997-01-27 Kenneth Albanowski
+
+ * Makefile.PL, ReadKey.pm, ReadKey.xs: import TermReadKey 2.07 from
+ CPAN git-cpan-module: TermReadKey git-cpan-version: 2.07
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.07.tar.gz
+
+1996-11-25 Kenneth Albanowski
+
+ * Makefile.PL, README, ReadKey.pm, ReadKey.xs, test.pl: import
+ TermReadKey 2.06 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.06
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.06.tar.gz
+
+1996-03-14 Kenneth Albanowski
+
+ * Makefile.PL, README, ReadKey.pm, ReadKey.xs: import TermReadKey
+ 2.05 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.05
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.05.tar.gz
+
+1995-10-11 Kenneth Albanowski
+
+ * Makefile.PL, README, ReadKey.xs: import TermReadKey 2.04 from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.04
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.04.tar.gz
+
+1995-09-29 Kenneth Albanowski
+
+ * Configure.pm, MANIFEST, Makefile.PL, README, ReadKey.pm,
+ ReadKey.xs, genchars.pl, test.pl: initial import of TermReadKey 2.03
+ from CPAN git-cpan-module: TermReadKey git-cpan-version: 2.03
+ git-cpan-authorid: KJALB git-cpan-file:
+ authors/id/K/KJ/KJALB/TermReadKey-2.03.tar.gz
+
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/TermReadKey-2.31/Configure.pm new/TermReadKey-2.32/Configure.pm
--- old/TermReadKey-2.31/Configure.pm 2013-10-26 23:33:10.000000000 +0200
+++ new/TermReadKey-2.32/Configure.pm 2014-03-09 23:03:29.000000000 +0100
@@ -14,7 +14,9 @@
# Todo: clean up redudant code in CPP, Compile, Link, and Execute
#
-package Configure;
+# for when no_index is not enough
+package
+Configure;
use strict;
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/TermReadKey-2.31/META.json new/TermReadKey-2.32/META.json
--- old/TermReadKey-2.31/META.json 2013-10-27 01:30:40.000000000 +0200
+++ new/TermReadKey-2.32/META.json 2014-05-10 15:05:49.000000000 +0200
@@ -4,7 +4,7 @@
"unknown"
],
"dynamic_config" : 1,
- "generated_by" : "ExtUtils::MakeMaker version 6.62, CPAN::Meta::Converter version 2.120921",
+ "generated_by" : "ExtUtils::MakeMaker version 6.64, CPAN::Meta::Converter version 2.120921",
"license" : [
"perl_5"
],
@@ -17,6 +17,12 @@
"directory" : [
"t",
"inc"
+ ],
+ "file" : [
+ "Configure.pm"
+ ],
+ "package" : [
+ "Configure"
]
},
"release_status" : "stable",
@@ -27,5 +33,5 @@
"web" : "https://github.com/jonathanstowe/TermReadKey"
}
},
- "version" : "2.31"
+ "version" : "2.32"
}
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/TermReadKey-2.31/META.yml new/TermReadKey-2.32/META.yml
--- old/TermReadKey-2.31/META.yml 2013-10-27 01:30:40.000000000 +0200
+++ new/TermReadKey-2.32/META.yml 2014-05-10 15:05:49.000000000 +0200
@@ -4,7 +4,7 @@
- unknown
build_requires: {}
dynamic_config: 1
-generated_by: 'ExtUtils::MakeMaker version 6.62, CPAN::Meta::Converter version 2.120921'
+generated_by: 'ExtUtils::MakeMaker version 6.64, CPAN::Meta::Converter version 2.120921'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
@@ -14,6 +14,10 @@
directory:
- t
- inc
+ file:
+ - Configure.pm
+ package:
+ - Configure
resources:
repository: https://github.com/jonathanstowe/TermReadKey.git
-version: 2.31
+version: 2.32
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/TermReadKey-2.31/Makefile.PL new/TermReadKey-2.32/Makefile.PL
--- old/TermReadKey-2.31/Makefile.PL 2013-10-27 01:17:01.000000000 +0200
+++ new/TermReadKey-2.32/Makefile.PL 2014-03-12 19:13:22.000000000 +0100
@@ -12,6 +12,10 @@
DISTNAME => 'TermReadKey',
LICENSE => 'perl',
META_MERGE => {
+ no_index => {
+ file => [qw(Configure.pm)],
+ package => [qw(Configure)],
+ },
'meta-spec' => { version => 2 },
resources => {
repository => {
@@ -45,10 +49,10 @@
$_ .= "
sgtty cchars.h: genchars.pl
- \$(PERL) -I\$(PERL_LIB) genchars.pl
+ \$(PERL) -Mblib -I\$(PERL_LIB) genchars.pl
distcc: genchars.pl
- \$(PERL) -I\$(PERL_LIB) genchars.pl dist
+ \$(PERL) -Mblib -I\$(PERL_LIB) genchars.pl dist
ReadKey.c: cchars.h
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/TermReadKey-2.31/README new/TermReadKey-2.32/README
--- old/TermReadKey-2.31/README 2013-10-27 01:24:11.000000000 +0200
+++ new/TermReadKey-2.32/README 2014-03-03 19:23:52.000000000 +0100
@@ -1,7 +1,7 @@
- Term::ReadKey 2.31 - Change terminal modes, and perform non-blocking reads.
+ Term::ReadKey 2.32 - Change terminal modes, and perform non-blocking reads.
Copyright (C) 1994-1999 Kenneth Albanowski.
- 2001-2013 Jonathan Stowe and others
+ 2001-2014 Jonathan Stowe and others
This package is dual licensed. You can either choose to license it under
the original terms which were:
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/TermReadKey-2.31/ReadKey.pm new/TermReadKey-2.32/ReadKey.pm
--- old/TermReadKey-2.31/ReadKey.pm 2013-10-27 01:10:23.000000000 +0200
+++ new/TermReadKey-2.32/ReadKey.pm 2014-03-03 19:23:04.000000000 +0100
@@ -1,4 +1,3 @@
-
package Term::ReadKey;
=head1 NAME
@@ -7,13 +6,13 @@
=head1 SYNOPSIS
- use Term::ReadKey;
- ReadMode 4; # Turn off controls keys
- while (not defined ($key = ReadKey(-1))) {
- # No key yet
- }
- print "Get key $key\n";
- ReadMode 0; # Reset tty mode before exiting
+ use Term::ReadKey;
+ ReadMode 4; # Turn off controls keys
+ while (not defined ($key = ReadKey(-1))) {
+ # No key yet
+ }
+ print "Get key $key\n";
+ ReadMode 0; # Reset tty mode before exiting
=head1 DESCRIPTION
@@ -29,30 +28,34 @@
under Win32. These keys emit xterm-compatible sequences.
Works with Term::ReadLine::Perl.
-=over 8
+=over 4
=item ReadMode MODE [, Filehandle]
-Takes an integer argument, which can currently be one of the following
-values:
+Takes an integer argument or a string synonym (case insensitive), which
+can currently be one of the following values:
+
+ INT SYNONYM DESCRIPTION
+
+ 0 'restore' Restore original settings.
+
+ 1 'normal' Change to what is commonly the default mode,
+ echo on, buffered, signals enabled, Xon/Xoff
+ possibly enabled, and 8-bit mode possibly disabled.
+
+ 2 'noecho' Same as 1, just with echo off. Nice for
+ reading passwords.
+
+ 3 'cbreak' Echo off, unbuffered, signals enabled, Xon/Xoff
+ possibly enabled, and 8-bit mode possibly enabled.
+
+ 4 'raw' Echo off, unbuffered, signals disabled, Xon/Xoff
+ disabled, and 8-bit mode possibly disabled.
+
+ 5 'ultra-raw' Echo off, unbuffered, signals disabled, Xon/Xoff
+ disabled, 8-bit mode enabled if parity permits,
+ and CR to CR/LF translation turned off.
- 0 Restore original settings.
- 1 Change to cooked mode.
- 2 Change to cooked mode with echo off.
- (Good for passwords)
- 3 Change to cbreak mode.
- 4 Change to raw mode.
- 5 Change to ultra-raw mode.
- (LF to CR/LF translation turned off)
-
- Or, you may use the synonyms:
-
- restore
- normal
- noecho
- cbreak
- raw
- ultra-raw
These functions are automatically applied to the STDIN handle if no
other handle is supplied. Modes 0 and 5 have some special properties
@@ -62,20 +65,27 @@
possible, parity will be disabled (only if not being used by the terminal,
however. It is no different from mode 4 under Windows.)
+If you just need to read a key at a time, then modes 3 or 4 are probably
+sufficient. Mode 4 is a tad more flexible, but needs a bit more work to
+control. If you use ReadMode 3, then you should install a SIGINT or END
+handler to reset the terminal (via ReadMode 0) if the user aborts the
+program via C<^C>. (For any mode, an END handler consisting of "ReadMode 0"
+is actually a good idea.)
+
If you are executing another program that may be changing the terminal mode,
you will either want to say
- ReadMode 1
+ ReadMode 1; # same as ReadMode 'normal'
system('someprogram');
ReadMode 1;
-
+
which resets the settings after the program has run, or:
$somemode=1;
- ReadMode 0;
+ ReadMode 0; # same as ReadMode 'restore'
system('someprogram');
ReadMode 1;
-
+
which records any changes the program may have made, before resetting the
mode.
@@ -88,22 +98,28 @@
-1 Perform a non-blocked read
>0 Perform a timed read
-(If the filehandle is not supplied, it will default to STDIN.) If there is
+If the filehandle is not supplied, it will default to STDIN. If there is
nothing waiting in the buffer during a non-blocked read, then undef will be
-returned. Note that if the OS does not provide any known mechanism for
-non-blocking reads, then a C can die with a fatal error. This
-will hopefully not be common.
+returned. In most situations, you will probably want to use C.
+
+I<NOTE> that if the OS does not provide any known mechanism for non-blocking
+reads, then a C can die with a fatal error. This will hopefully
+not be common.
If MODE is greater then zero, then ReadKey will use it as a timeout value in
seconds (fractional seconds are allowed), and won't return C<undef> until
-that time expires. (Note, again, that some OS's may not support this timeout
-behaviour.) If MODE is less then zero, then this is treated as a timeout
+that time expires.
+
+I<NOTE>, again, that some OS's may not support this timeout behaviour.
+
+If MODE is less then zero, then this is treated as a timeout
of zero, and thus will return immediately if no character is waiting. A MODE
of zero, however, will act like a normal getc.
-There are currently some limitations with this call under Windows. It may be
-possible that non-blocking reads will fail when reading repeating keys from
-more then one console.
+I<NOTE>, there are currently some limitations with this call under Windows.
+It may be possible that non-blocking reads will fail when reading repeating
+keys from more then one console.
+
=item ReadLine MODE [, Filehandle]
@@ -115,16 +131,19 @@
>0 Perform a timed read
If there is nothing waiting in the buffer during a non-blocked read, then
-undef will be returned. Note that if the OS does not provide any known
-mechanism for non-blocking reads, then a C can die with a fatal
-error. This will hopefully not be common. Note that a non-blocking test is
-only performed for the first character in the line, not the entire line.
-This call will probably B<not> do what you assume, especially with
-ReadMode's higher then 1. For example, pressing Space and then Backspace
-would appear to leave you where you started, but any timeouts would now
-be suspended.
+undef will be returned.
+
+I<NOTE>, that if the OS does not provide any known mechanism for
+non-blocking reads, then a C can die with a fatal
+error. This will hopefully not be common.
+
+I<NOTE> that a non-blocking test is only performed for the first character
+in the line, not the entire line. This call will probably B<not> do what
+you assume, especially with C<ReadMode> MODE values higher then 1. For
+example, pressing Space and then Backspace would appear to leave you
+where you started, but any timeouts would now be suspended.
-This call is currently not available under Windows.
+B<This call is currently not available under Windows>.
=item GetTerminalSize [Filehandle]
@@ -133,18 +152,20 @@
height of the terminal in character, the width in pixels, and the height in
pixels. (The pixel size will only be valid in some environments.)
-Under Windows, this function must be called with an "output" filehandle,
-such as STDOUT, or a handle opened to CONOUT$.
+I<NOTE>, under Windows, this function must be called with an B<output>
+filehandle, such as C<STDOUT>, or a handle opened to C.
=item SetTerminalSize WIDTH,HEIGHT,XPIX,YPIX [, Filehandle]
-Return -1 on failure, 0 otherwise. Note that this terminal size is only for
-B<informative> value, and changing the size via this mechanism will B<not>
-change the size of the screen. For example, XTerm uses a call like this when
+Return -1 on failure, 0 otherwise.
+
+I<NOTE> that this terminal size is only for B<informative> value, and
+changing the size via this mechanism will B<not> change the size of
+the screen. For example, XTerm uses a call like this when
it resizes the screen. If any of the new measurements vary from the old, the
OS will probably send a SIGWINCH signal to anything reading that tty or pty.
-This call does not work under Windows.
+B<This call does not work under Windows>.
=item GetSpeeds [, Filehandle]
@@ -152,13 +173,17 @@
value array containing the terminal in and out speeds, in B<decimal>. E.g,
an in speed of 9600 baud and an out speed of 4800 baud would be returned as
(9600,4800). Note that currently the in and out speeds will always be
-identical in some OS's. No speeds are reported under Windows.
+identical in some OS's.
+
+B<No speeds are reported under Windows>.
=item GetControlChars [, Filehandle]
Returns an array containing key/value pairs suitable for a hash. The pairs
consist of a key, the name of the control character/signal, and the value
-of that character, as a single character. This call does nothing under Windows.
+of that character, as a single character.
+
+B<This call does nothing under Windows>.
Each key will be an entry from the following list:
@@ -200,7 +225,7 @@
%cchars = GetControlChars();
@cnames = keys %cchars;
-This call does nothing under Windows.
+B<This call does nothing under Windows>.
=back
@@ -210,7 +235,7 @@
Currently maintained by Jonathan Stowe
-=item SUPPORT
+=head1 SUPPORT
The code is maintained at
@@ -219,7 +244,7 @@
Please feel free to fork and suggest patches.
-=item LICENSE
+=head1 LICENSE
Prior to the 2.31 release the license statement was:
@@ -250,7 +275,7 @@
use vars qw($VERSION);
-$VERSION = '2.31';
+$VERSION = '2.32';
require Exporter;
require AutoLoader;
@@ -289,7 +314,7 @@
$CurrentMode = 0;
-%modes = (
+%modes = ( # lowercase is canonical
original => 0,
restore => 0,
normal => 1,
@@ -301,7 +326,7 @@
sub ReadMode
{
- my ($mode) = $modes{ $_[0] };
+ my ($mode) = $modes{ lc $_[0] }; # lowercase is canonical
my ($fh) = normalizehandle( ( @_ > 1 ? $_[1] : \*STDIN ) );
if ( defined($mode) ) { $CurrentMode = $mode }
elsif ( $_[0] =~ /^\d/ ) { $CurrentMode = $_[0] }
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/TermReadKey-2.31/ReadKey.xs new/TermReadKey-2.32/ReadKey.xs
--- old/TermReadKey-2.31/ReadKey.xs 2013-10-27 01:14:53.000000000 +0200
+++ new/TermReadKey-2.32/ReadKey.xs 2014-05-10 14:33:11.000000000 +0200
@@ -1397,8 +1397,8 @@
/*warn("Mode set to %d.\n",mode);*/
if( firsttime ) {
- (void*)hv_delete(filehash,(char*)&handle,sizeof(int),0);
- (void*)hv_delete(modehash,(char*)&handle,sizeof(int),0);
+ (void)hv_delete(filehash,(char*)&handle,sizeof(int),0);
+ (void)hv_delete(modehash,(char*)&handle,sizeof(int),0);
} else {
if(!hv_store(modehash,(char*)&handle,sizeof(int),
newSViv(mode),0))
--
To unsubscribe, e-mail: opensuse-commit+unsubscribe@opensuse.org
For additional commands, e-mail: opensuse-commit+help@opensuse.org