This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update Changes.
[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 =head1 SYNOPSIS
10
11 This document briefly describes perl under Mac OS (Classic).
12 If you are running perl under Mac OS X, you don't want to be
13 here (unless you are in the Classic environment under Mac OS X).
14
15 When we say "Mac OS" below, we mean pre-Mac OS X, which includes
16 Mac OS 7, 8, and 9.
17
18 =head1 DESCRIPTION
19
20 The perl 5.6.1 source itself builds on Mac OS, with some additional
21 pieces. Support for Mac OS is now in the perl core, and MacPerl will be
22 able to, in the future, keep in closer sync with regular perl releases.
23
24 At this time, though, it is very buggy, and is under development.  An
25 alpha release is available, with work progressing toward a beta.
26
27 To build perl for Mac OS (as an MPW tool), you will need the addition
28 of the "macos" subdirectory, distributed separately.  It includes extra
29 source files, config files, and make files.  It also includes a lot of
30 extra Mac-specific modules.
31
32 To build the MacPerl application, you will also need the "macperl"
33 directory, which includes the source files for creating the
34 application itself.
35
36 All of this is available from the development site, via
37 HTTP 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.2.0r4 is available on the CPAN and on SourceForge.  It
49 is based on perl 5.004.
50
51 =head1 AUTHOR
52
53 perl was ported to Mac OS by Matthias Neeracher
54 E<lt>neeracher@mac.comE<gt>.  It is currently maintained by Chris
55 Nandor E<lt>pudge@pobox.comE<gt>.
56
57 =head1 DATE
58
59 Last modified 2001.07.19.