# Term::ANSIColor -- Color screen output using ANSI escape sequences.
-# $Id: ANSIColor.pm,v 1.5 2002/06/28 22:49:01 eagle Exp $
+# $Id: ANSIColor.pm,v 1.7 2003/03/26 07:00:51 eagle Exp $
#
# Copyright 1996, 1997, 1998, 2000, 2001, 2002
# by Russ Allbery <rra@stanford.edu> and Zenin <zenin@bawdycaste.com>
# Don't use the CVS revision as the version, since this module is also in Perl
# core and too many things could munge CVS magic revision strings.
-$VERSION = 1.06;
+$VERSION = 1.07;
##############################################################################
# Internal data structures
garbage.
Jean Delvare provided the following table of different common terminal
-emulators and their support for the various attributes:
+emulators and their support for the various attributes and others have helped
+me flesh it out:
clear bold dark under blink reverse conceal
------------------------------------------------------------------------
dtterm yes yes yes yes reverse yes yes
teraterm yes reverse no yes rev/red yes no
aixterm kinda normal no yes no yes yes
+ PuTTY yes color no yes no yes no
+ Windows yes no no no no yes no
+ Cygwin SSH yes yes no color color color yes
-Where the entry is other than yes or no, that emulator interpret the given
-attribute as something else instead. Note that on an aixterm, clear doesn't
-reset colors; you have to explicitly set the colors back to what you want.
-More entries in this table are welcome.
+Windows is Windows telnet, and Cygwin SSH is the OpenSSH implementation under
+Cygwin on Windows NT. Where the entry is other than yes or no, that emulator
+displays the given attribute as something else instead. Note that on an
+aixterm, clear doesn't reset colors; you have to explicitly set the colors
+back to what you want. More entries in this table are welcome.
Note that codes 3 (italic), 6 (rapid blink), and 9 (strikethrough) are
specified in ANSI X3.64 and ECMA-048 but are not commonly supported by most
=head1 SEE ALSO
ECMA-048 is available on-line (at least at the time of this writing) at
-L<http://www.ecma.ch/ecma1/STAND/ECMA-048.HTM>.
+L<http://www.ecma-international.org/publications/standards/ECMA-048.HTM>.
ISO 6429 is available from ISO for a charge; the author of this module does
not own a copy of it. Since the source material for ISO 6429 was ECMA-048
+2003-03-25 Russ Allbery <rra@stanford.edu>
+
+ * ANSIColor.pm: Version 1.07 released.
+
+ * ANSIColor.pm: Add PuTTY, Windows telnet, and Cygwin OpenSSH
+ information to the terminal emulators table, and update the URL to
+ the ECMA standard.
+
+2002-12-09 Russ Allbery <rra@stanford.edu>
+
+ * ANSIColor.pm: Version 1.06 released to synchronize the version
+ on CPAN with the version in Perl core.
+
+ * ANSIColor.pm: Fix typo in L<> link in documentation.
+
+2002-06-28 Russ Allbery <rra@stanford.edu>
+
+ * ANSIColor.pm: Version 1.05 released.
+
+ * ANSIColor.pm: Update the formatting style, add a pointer to the
+ module web site, use L<> for URLs, and use naked <>s where
+ permissible rather than E<lt> and E<gt>. Renamed LICENSE to
+ COPYRIGHT AND LICENSE.
+
+2002-02-14 Russ Allbery <rra@stanford.edu>
+
+ * ANSIColor.pm: Added a mention of the specific Windows consoles
+ that don't work with this module.
+
2001-07-10 Russ Allbery <rra@stanford.edu>
* ANSIColor.pm: Version 1.04 released.
- Term::ANSIColor version 1.04
- (A simple ANSI text attribute control module)
+ Term::ANSIColor version 1.07
+ (A simple ANSI text attribute control module)
- Copyright 1996, 1997, 1998, 2000, 2001 Russ Allbery <rra@stanford.edu>
- and Zenin <zenin@bawdycaste.org>. This program is free software; you
- may redistribute it and/or modify it under the same terms as Perl
- itself.
+ Copyright 1996, 1997, 1998, 2000, 2001, 2002
+ Russ Allbery <rra@stanford.edu> and Zenin <zenin@bawdycaste.org>. This
+ program is free software; you may redistribute it and/or modify it under
+ the same terms as Perl itself.
+
+ I welcome bug reports and patches for this package at rra@stanford.edu.
+ However, please be aware that I tend to be extremely busy and to get a
+ lot of mail. I'll save your mail and get to it as soon as I can, but
+ depending on how busy I am it may take me a couple of months.
INTRODUCTION
While ANSI color escape codes are fairly simple, it can be hard to
remember the codes for all of the attributes and the code resulting from
hard-coding them into your script is definitely difficult to read. This
- module is designed to fix those problems, as well as provide a convenient
- interface to do a few things for you automatically (like resetting
- attributes after the text you print out so that you don't accidentally
- leave attributes set).
+ module is designed to fix those problems, as well as provide a
+ convenient interface to do a few things for you automatically (like
+ resetting attributes after the text you print out so that you don't
+ accidentally leave attributes set).
Despite its name, this module can also handle non-color ANSI text
- attributes (bold, underline, reverse video, and blink). It uses either of
- two interfaces, one of which uses "constants" for each different attribute
- and the other of which uses two subs which take strings of attributes as
- arguments.
+ attributes (bold, underline, reverse video, and blink). It uses either
+ of two interfaces, one of which uses "constants" for each different
+ attribute and the other of which uses two subs which take strings of
+ attributes as arguments.
+
+ The most recent version of this module is available at its web site:
+
+ <http://www.eyrie.org/~eagle/software/ansicolor/>
See the POD documentation for complete details, features, and usage.
+ This module is distributed as part of the Perl core distribution as of
+ Perl 5.6.0. You only need to install this module if you want a newer
+ version than came with Perl or if you have an old version of Perl.
+
INSTALLATION
Follow the standard installation procedure for Perl modules, which is to
type the following commands:
- perl Makefile.PL
- make
- make test
- make install
+ perl Makefile.PL
+ make
+ make test
+ make install
You'll probably need to do the last as root. If instead you wish to
- install the module by hand, simply copy it into a directory named Term in
- your Perl library directory.
+ install the module by hand, simply copy it into a directory named Term
+ in your Perl library directory.
Note that make install, for Perl 5.6.0 or later, will replace the
Term::ANSIColor that came with Perl. You may wan to save a backup copy
To Rani Pinchuk for the idea of ANSI_COLORS_DISABLED and an initial
implementation.
- To Larry Wall, as always, for Perl.
+ To ATricket for the information about what PuTTY, Windows telnet, and
+ OpenSSH under Cygwin support.
- Russ Allbery
- rra@stanford.edu
+ To Larry Wall, as always, for Perl.
projects / platform / upstream / perl.git / commitdiff