Perl4::CoreLibs(3pm)

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, TryCatch, or the core "try"/"catch" facility on Perl 5.33.7 or later.

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, 2023 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.