This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Make autodoc.pl write its output with UNIX style EOL's.
[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 Mac OS 7, 8, and 9, and I<not>
16 Mac OS X.
17
18
19 =head1 DESCRIPTION
20
21 The latest perl source itself builds on Mac OS, with some additional
22 pieces. Support for Mac OS is now in the perl core, and MacPerl is kept
23 in close sync with regular perl releases.
24
25 To build perl for Mac OS (as an MPW tool), you will need the addition
26 of the F<macos> subdirectory, distributed separately.  It includes extra
27 source files, config files, and make files.  It also includes extra
28 Mac-specific modules.
29
30 To build the MacPerl application, you will also need the F<macperl>
31 directory, which includes the source files for creating the
32 application itself.
33
34 All of this is available from the development site, via
35 HTTP (in the MacPerl Installer, which includes all the source
36 and binaries) and anonymous CVS.
37
38         http://dev.macperl.org/
39
40 The source is also in the main perl repository in the macperl
41 branch (the 5.6 source is in the maint-5.6/macperl branch).
42
43 You will also need compilers and libraries, all of them freely
44 available.  These are linked to from the SourceForge site. Go that site
45 for all things having to do with MacPerl development.
46
47 MacPerl 5.6.1 and later are supported on Mac OS 8.1 and later, for 68040
48 and PowerPC architectures.  The MPW tool may be used on Mac OS 7.5.5
49 and 68030 computers.
50
51 MacPerl 5.2.0r4 is also available, on the CPAN and on SourceForge.  It
52 is based on perl 5.004, and works with Mac OS 7.5.5 and 68030 computers.
53
54
55 =head1 AUTHOR
56
57 perl was ported to Mac OS by Matthias Neeracher
58 E<lt>neeracher@mac.comE<gt>.  It is currently maintained by Chris
59 Nandor E<lt>pudge@pobox.comE<gt>.
60
61
62 =head1 DATE
63
64 Last modified 2002.05.02.