This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
The test needs perlio.
[perl5.git] / README.macos
1 If you read this file _as_is_, just ignore the funny characters you see.
2 It is written in the POD format (see pod/perlpod.pod) which is specially
3 designed to be readable as is.
4
5 =head1 NAME
6
7 README.macos - Perl under Mac OS (Classic)
8
9
10 =head1 SYNOPSIS
11
12 This document briefly describes perl under Mac OS (Classic).
13 If you are running perl under Mac OS X, you don't want to be
14 here (unless you are in the Classic environment under Mac OS X).
15
16 When we say "Mac OS" below, we mean Mac OS 7, 8, and 9, and I<not>
17 Mac OS X.
18
19
20 =head1 DESCRIPTION
21
22 The latest perl 5.6 source itself builds on Mac OS, with some additional
23 pieces. Support for Mac OS is now in the perl core, and MacPerl will be
24 able to, in the future, keep in closer sync with regular perl releases.
25
26 To build perl for Mac OS (as an MPW tool), you will need the addition
27 of the F<macos> subdirectory, distributed separately.  It includes extra
28 source files, config files, and make files.  It also includes extra
29 Mac-specific modules.
30
31 To build the MacPerl application, you will also need the F<macperl>
32 directory, which includes the source files for creating the
33 application itself.
34
35 All of this is available from the development site, via
36 HTTP (in the MacPerl Installer, which includes all the source
37 and binaries) and anonymous CVS.
38
39         http://dev.macperl.org/
40
41 The source is also in the main perl repository in the maint-5.6/macperl
42 branch.
43
44 You will also need compilers and libraries, all of them freely
45 available.  These are linked to from the SourceForge site. Go that site
46 for all things having to do with MacPerl development.
47
48 MacPerl 5.6.1 and later are supported on Mac OS 8.1 and later, for 68040
49 and PowerPC architectures.  The MPW tool may be used on Mac OS 7.5.5
50 and 68030 computers.
51
52 MacPerl 5.2.0r4 is also available, on the CPAN and on SourceForge.  It
53 is based on perl 5.004.
54
55
56 =head1 AUTHOR
57
58 perl was ported to Mac OS by Matthias Neeracher
59 E<lt>neeracher@mac.comE<gt>.  It is currently maintained by Chris
60 Nandor E<lt>pudge@pobox.comE<gt>.
61
62
63 =head1 DATE
64
65 Last modified 2002.02.28.