1=head1 NAME 2 3Perl4::CoreLibs - libraries historically supplied with Perl 4 4 5=head1 DESCRIPTION 6 7This is a collection of C<.pl> files that have historically been 8bundled with the Perl core but are planned not to be so distributed 9with core version 5.15 or later. Relying on their presence in the core 10distribution is deprecated; they should be acquired from this CPAN 11distribution instead. From core version 5.13, until their removal, 12it is planned that the core versions of these libraries will emit a 13warning when loaded. The CPAN version will not emit such a warning. 14 15The entire Perl 4 approach to libraries was largely superseded in Perl 165.000 by the system of module namespaces and C<.pm> files. Most of 17the libraries in this collection predate Perl 5.000, but a handful were 18first introduced in that version. Functionally, most have been directly 19superseded by modules in the Perl 5 style. These libraries should not 20be used by new code. This collection exists to support old Perl programs 21that predates satisfactory replacements. 22 23Most of these libraries have not been substantially maintained in the 24course of Perl 5 development. They are now very antiquated in style, 25making no use of the language facilities introduced since Perl 4. 26They should therefore not be used as programming examples. 27 28=head1 LIBRARIES 29 30The libraries in this collection are: 31 32=over 33 34=item abbrev.pl 35 36Build a dictionary of unambiguous abbreviations for a group of words. 37Prefer L<Text::Abbrev>. 38 39=item assert.pl 40 41Assertion checking with stack trace upon assertion failure. 42 43=item bigfloat.pl 44 45Arbitrary precision decimal floating point arithmetic. 46Prefer L<Math::BigFloat>. 47 48=item bigint.pl 49 50Arbitrary precision integer arithmetic. 51Prefer L<Math::BigInt>. 52 53=item bigrat.pl 54 55Arbitrary precision rational arithmetic. 56Prefer L<Math::BigRat>. 57 58=item cacheout.pl 59 60Manage output to a large number of files to avoid running out of file 61descriptors. 62 63=item chat2.pl 64 65Framework for partial automation of communication with a remote process 66over IP. 67Prefer L<IO::Socket::INET>. 68 69=item complete.pl 70 71Interactive line input with word completion. 72Prefer L<Term::Complete>. 73 74=item ctime.pl 75 76One form of textual representation of time. 77Prefer C<scalar(localtime())> or L<POSIX/ctime>. 78 79=item dotsh.pl 80 81Inhale shell variables set by a shell script. 82 83=item exceptions.pl 84 85String-based exception handling built on C<eval> and C<die>. 86Prefer L<Try::Tiny> or L<TryCatch>. 87 88=item fastcwd.pl 89 90Determine current directory. 91Prefer L<Cwd>. 92 93=item find.pl 94 95Historical interface for a way of searching for files. 96Prefer L<File::Find>. 97 98=item finddepth.pl 99 100Historical interface for a way of searching for files. 101Prefer L<File::Find>. 102 103=item flush.pl 104 105Flush an I/O handle's output buffer. 106Prefer L<IO::Handle/flush>. 107 108=item ftp.pl 109 110File Transfer Protocol (FTP) over IP. 111Prefer L<Net::FTP>. 112 113=item getcwd.pl 114 115Determine current directory. 116Prefer L<Cwd>. 117 118=item getopt.pl 119 120Unix-like option processing with all option taking arguments. 121Prefer L<Getopt::Std>. 122 123=item getopts.pl 124 125Full Unix-like option processing. 126Prefer L<Getopt::Std>. 127 128=item hostname.pl 129 130Determine host's hostname. 131Prefer L<Sys::Hostname>. 132 133=item importenv.pl 134 135Import environment variables as Perl package variables. 136 137=item look.pl 138 139Data-based seek within regular file. 140 141=item newgetopt.pl 142 143GNU-like option processing. 144Prefer L<Getopt::Long>. 145 146=item open2.pl 147 148Open a subprocess for both reading and writing. 149Prefer L<IPC::Open2>. 150 151=item open3.pl 152 153Open a subprocess for reading, writing, and error handling. 154Prefer L<IPC::Open3>. 155 156=item pwd.pl 157 158Track changes of current directory in C<$ENV{PWD}>. 159 160=item shellwords.pl 161 162Interpret shell quoting. 163Prefer L<Text::ParseWords>. 164 165=item stat.pl 166 167Access fields of a L<stat|perldoc/stat> structure by name. 168Prefer L<File::stat>. 169 170=item syslog.pl 171 172Write to Unix system log. 173Prefer L<Sys::Syslog>. 174 175=item tainted.pl 176 177Determine whether data is tainted. 178Prefer L<Taint::Util>. 179 180=item termcap.pl 181 182Generate escape sequences to control arbitrary terminal. 183Prefer L<Term::Cap>. 184 185=item timelocal.pl 186 187Generate time number from broken-down time. 188Prefer L<Time::Local>. 189 190=item validate.pl 191 192Check permissions on a group of files. 193 194=back 195 196=cut 197 198package Perl4::CoreLibs; 199 200{ use 5.006; } 201use warnings; 202use strict; 203 204our $VERSION = "0.003"; 205 206=head1 AUTHOR 207 208Known contributing authors for the libraries in this package are 209Brandon S. Allbery, John Bazik, Tom Christiansen <tchrist@convex.com>, 210Charles Collins, Joe Doupnik <JRD@CC.USU.EDU>, Marion Hakanson 211<hakanson@cse.ogi.edu>, Waldemar Kebsch <kebsch.pad@nixpbe.UUCP>, 212Lee McLoughlin <lmjm@doc.ic.ac.uk>, <A.Macpherson@bnr.co.uk>, Randal 213L. Schwartz <merlyn@stonehenge.com>, Aaron Sherman <asherman@fmrco.com>, 214Wayne Thompson, Larry Wall <lwall@jpl-devvax.jpl.nasa.gov>, and Ilya 215Zakharevich. (Most of these email addresses are probably out of date.) 216 217Known contributing authors for the tests in this package are Tom 218Christiansen <tchrist@convex.com>, Alexandr Ciornii (alexchorny at 219gmail.com), Marc Horowitz <marc@mit.edu>, Dave Rolsky <autarch@urth.org>, 220and David Sundstrom <sunds@asictest.sc.ti.com>. 221 222Andrew Main (Zefram) <zefram@fysh.org> built the Perl4::CoreLibs package. 223 224=head1 COPYRIGHT 225 226Copyright (C) 1987-2009 Larry Wall et al 227 228Copyright (C) 2010, 2011 Andrew Main (Zefram) <zefram@fysh.org> 229 230=head1 LICENSE 231 232This module is free software; you can redistribute it and/or modify it 233under the same terms as Perl itself. 234 235=cut 236 2371; 238