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 - [email protected] + +- 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 <[email protected]> + * : Merge pull request #2 from jacquesg/warnings Fix some warnings + 2014-03-09 Jonathan Stowe <[email protected]> + * Configure.pm, META.yml, Makefile.PL: Don't index Configure.pm + 2014-03-03 Jonathan Stowe <[email protected]> + * 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 <[email protected]> + + * Makefile.PL: Makefile.PL more specific + +2014-05-10 Jonathan Stowe <[email protected]> + + * : Merge pull request #2 from jacquesg/warnings Fix some warnings + +2014-03-09 Jonathan Stowe <[email protected]> + + * Configure.pm, META.yml, Makefile.PL: Don't index Configure.pm + +2014-03-03 Jonathan Stowe <[email protected]> + + * Changes, README, ReadKey.pm: Added documentation patch as per + Chris Marshall Bumped version + +2013-10-28 Jonathan Stowe <[email protected]> + + * README: Some changes to README + +2013-10-28 Brian Wightman <[email protected]> + + * 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 <[email protected]> + + * Makefile.PL, README, ReadKey.pm, ReadKey.xs, genchars.pl: Change + licensing Fix some warnings + +2013-10-26 Jonathan Stowe <[email protected]> + + * ReadKey.pm: Applied patch from rt #35669 + +2013-10-26 Jonathan Stowe <[email protected]> + + * Makefile.PL, ReadKey.xs: Applied change from rt #26235 Also fixed + repo name + +2013-10-26 Jonathan Stowe <[email protected]> + + * ReadKey.pm: Patch from rt #35671 + +2013-10-26 Jonathan Stowe <[email protected]> + + * ppport.h: Updated ppport.h as per #78831 + +2013-10-26 Jonathan Stowe <[email protected]> + + * Makefile.PL: Changed distname per RT #87885 Added additional + metadata + +2013-10-26 Jonathan Stowe <[email protected]> + + * ReadKey.pm: Added changes for RT #86584 + +2013-10-26 Jonathan Stowe <[email protected]> + + * ReadKey.pm: Added patch from [email protected] for RT #88266 + +2011-04-19 Jonathan Stowe <[email protected]> + + * Changes: Added Changes + +2011-04-19 Jonathan Stowe <[email protected]> + + * : commit 40ba6a2a80ae495b921ab416f6b024014daac25e Author: Stas + Grabois <CENSORED> Date: Tue Jun 24 01:57:37 2008 -0800 + +2006-01-13 jonathan <jonathan@d4a3e428-c23c-0410-a93a-b1ce904c0fb3> + + * 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 <[email protected]> + + * 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 <jonathan@d4a3e428-c23c-0410-a93a-b1ce904c0fb3> + + * 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 <jonathan@d4a3e428-c23c-0410-a93a-b1ce904c0fb3> + + * ReadKey.pm: Fixed POD git-svn-id: http://jstowe.googlecode.com/svn/trunk/TermReadKey@52 + d4a3e428-c23c-0410-a93a-b1ce904c0fb3 + +2005-01-11 jonathan <jonathan@d4a3e428-c23c-0410-a93a-b1ce904c0fb3> + + * 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 <jonathan@d4a3e428-c23c-0410-a93a-b1ce904c0fb3> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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 <[email protected]> + + * 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<ReadKey -1> can die with a fatal error. This -will hopefully not be common. +returned. In most situations, you will probably want to use C<ReadKey -1>. + +I<NOTE> that if the OS does not provide any known mechanism for non-blocking +reads, then a C<ReadKey -1> 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<ReadLine 1> 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<ReadLine 1> 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<CONOUT$>. =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 <[email protected]> -=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: [email protected] For additional commands, e-mail: [email protected]
