DESCRIPTION

This is a collection of \*(C`.pl\*(C' files that have historically been bundled with the Perl core but are planned not to be so distributed with core version 5.15 or later. Relying on their presence in the core distribution is deprecated; they should be acquired from this \s-1CPAN\s0 distribution instead. From core version 5.13, until their removal, it is planned that the core versions of these libraries will emit a warning when loaded. The \s-1CPAN\s0 version will not emit such a warning.

The entire Perl 4 approach to libraries was largely superseded in Perl 5.000 by the system of module namespaces and \*(C`.pm\*(C' files. Most of the libraries in this collection predate Perl 5.000, but a handful were first introduced in that version. Functionally, most have been directly superseded by modules in the Perl 5 style. These libraries should not be used by new code. This collection exists to support old Perl programs that predates satisfactory replacements.

Most of these libraries have not been substantially maintained in the course of Perl 5 development. They are now very antiquated in style, making no use of the language facilities introduced since Perl 4. They should therefore not be used as programming examples.

LIBRARIES

The libraries in this collection are:

abbrev.pl

Build a dictionary of unambiguous abbreviations for a group of words. Prefer Text::Abbrev.

assert.pl

Assertion checking with stack trace upon assertion failure.

bigfloat.pl

Arbitrary precision decimal floating point arithmetic. Prefer Math::BigFloat.

bigint.pl

Arbitrary precision integer arithmetic. Prefer Math::BigInt.

bigrat.pl

Arbitrary precision rational arithmetic. Prefer Math::BigRat.

cacheout.pl

Manage output to a large number of files to avoid running out of file descriptors.

chat2.pl

Framework for partial automation of communication with a remote process over \s-1IP\s0. Prefer IO::Socket::INET.

complete.pl

Interactive line input with word completion. Prefer Term::Complete.

ctime.pl

One form of textual representation of time. Prefer \*(C`scalar(localtime())\*(C' or \*(L"ctime\*(R" in \s-1POSIX\s0.

dotsh.pl

Inhale shell variables set by a shell script.

exceptions.pl

String-based exception handling built on \*(C`eval\*(C' and \*(C`die\*(C'. Prefer Try::Tiny or TryCatch.

fastcwd.pl

Determine current directory. Prefer Cwd.

find.pl

Historical interface for a way of searching for files. Prefer File::Find.

finddepth.pl

Historical interface for a way of searching for files. Prefer File::Find.

flush.pl

Flush an I/O handle's output buffer. Prefer \*(L"flush\*(R" in IO::Handle.

ftp.pl

File Transfer Protocol (\s-1FTP\s0) over \s-1IP\s0. Prefer Net::FTP.

getcwd.pl

Determine current directory. Prefer Cwd.

getopt.pl

Unix-like option processing with all option taking arguments. Prefer Getopt::Std.

getopts.pl

Full Unix-like option processing. Prefer Getopt::Std.

hostname.pl

Determine host's hostname. Prefer Sys::Hostname.

importenv.pl

Import environment variables as Perl package variables.

look.pl

Data-based seek within regular file.

newgetopt.pl

GNU-like option processing. Prefer Getopt::Long.

open2.pl

Open a subprocess for both reading and writing. Prefer IPC::Open2.

open3.pl

Open a subprocess for reading, writing, and error handling. Prefer IPC::Open3.

pwd.pl

Track changes of current directory in $ENV{PWD}.

shellwords.pl

Interpret shell quoting. Prefer Text::ParseWords.

stat.pl

Access fields of a stat structure by name. Prefer File::stat.

syslog.pl

Write to Unix system log. Prefer Sys::Syslog.

tainted.pl

Determine whether data is tainted. Prefer Taint::Util.

termcap.pl

Generate escape sequences to control arbitrary terminal. Prefer Term::Cap.

timelocal.pl

Generate time number from broken-down time. Prefer Time::Local.

validate.pl

Check permissions on a group of files.

AUTHOR

Known contributing authors for the libraries in this package are Brandon S. Allbery, John Bazik, Tom Christiansen <[email protected]>, Charles Collins, Joe Doupnik <[email protected]>, Marion Hakanson <[email protected]>, Waldemar Kebsch <[email protected]>, Lee McLoughlin <[email protected]>, <[email protected]>, Randal L. Schwartz <[email protected]>, Aaron Sherman <[email protected]>, Wayne Thompson, Larry Wall <[email protected]>, and Ilya Zakharevich. (Most of these email addresses are probably out of date.)

Known contributing authors for the tests in this package are Tom Christiansen <[email protected]>, Alexandr Ciornii (alexchorny at gmail.com), Marc Horowitz <[email protected]>, Dave Rolsky <[email protected]>, and David Sundstrom <[email protected]>.

Andrew Main (Zefram) <[email protected]> built the Perl4::CoreLibs package.

COPYRIGHT

Copyright (C) 1987-2009 Larry Wall et al

Copyright (C) 2010, 2011 Andrew Main (Zefram) <[email protected]>

LICENSE

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.