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