NAME

       Perl4::CoreLibs - libraries historically supplied with Perl 4

DESCRIPTION

       This is a collection of ".pl" files that were bundled with the Perl core until core
       version 5.15.1.  Relying on their presence in the core distribution is deprecated; they
       should be acquired from this CPAN distribution instead.  From core version 5.13.3 until
       their removal, the core versions of these libraries emit a deprecation warning when
       loaded.  The CPAN version does 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 ".pm" 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 predate
       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 IP.
           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 "scalar(localtime())" or "ctime"
           in POSIX.

       dotsh.pl
           Inhale shell variables set by a shell script.

       exceptions.pl
           String-based exception handling built on "eval" and "die".  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 "flush" in IO::Handle.

       ftp.pl
           File Transfer Protocol (FTP) over IP.  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 <tchrist@convex.com>, Charles Collins, Joe Doupnik
       <JRD@CC.USU.EDU>, Marion Hakanson <hakanson@cse.ogi.edu>, Waldemar Kebsch
       <kebsch.pad@nixpbe.UUCP>, Lee McLoughlin <lmjm@doc.ic.ac.uk>, <A.Macpherson@bnr.co.uk>,
       Randal L. Schwartz <merlyn@stonehenge.com>, Aaron Sherman <asherman@fmrco.com>, Wayne
       Thompson, Larry Wall <lwall@jpl-devvax.jpl.nasa.gov>, 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
       <tchrist@convex.com>, Alexandr Ciornii (alexchorny at gmail.com), Marc Horowitz
       <marc@mit.edu>, Dave Rolsky <autarch@urth.org>, and David Sundstrom
       <sunds@asictest.sc.ti.com>.

       Andrew Main (Zefram) <zefram@fysh.org> built the Perl4::CoreLibs package.

COPYRIGHT

       Copyright (C) 1987-2009 Larry Wall et al

       Copyright (C) 2010, 2011, 2017 Andrew Main (Zefram) <zefram@fysh.org>

LICENSE

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