/src/ports/README

 1CPAN/ports/README
 2
 3	You are probably looking for a binary distribution of Perl.
 4	If so, go directly to
 5
 6		http://www.perl.com/CPAN/ports/index.html
 7
 8	The rest of this file tells is more detail about the
 9	contents of this directory (http://www.perl.com/CPAN/ports/)
10	but in principle, the above URL should be all you need.
11
12CONTENTS
13
14	This directory contains ports (or pointers to such) of Perl
15
16	(1) to platforms that the Perl standard source code distribution (S)
17	    does not (yet) support, such as Tandem Guardian.
18
19	(2) to platforms where a C compiler is an exception, not the rule,
20	    like for example the Windows platforms and OS/2.
21
22	(3) some of the directories here are empty and just contain pointers
23	    back to (S).  These are Perl source code archaeology in action:
24	    once upon a time these platforms were not supported in the (S),
25	    but they are now.  Examples include Amiga, BeOS, and MPE/iX.
26
27	(S) Either
28
29		http://www.perl.com/CPAN/src/stable.tar.gz
30
31	   or
32
33		http://www.perl.com/CPAN/src/stable.zip
34
35	Grab that, unpack it, start off by reading the README.
36
37BUILDING PERL FROM SOURCE
38
39	To build from the (S) you will need a full C compiler and
40	some sort of compilation environment ('make' or some similar
41	build tool).  If you have a UNIX-like shell environment
42	(Bourne shell and the usual UNIX utilities like 'tr', 'sed',
43	and so on), so much the better.
44
45	Because Perl's roots are in the UNIX world in general any
46	UNIX platform should be supported in the (S).  If this isn't
47	the case, please send email to perlbug@perl.com and tell in
48	excruciating detail what is your UNIX platform.  For example
49	the output of "uname -a" or similar would be handy.
50
51	Beware: some platforms which the vendors call UNIX do not
52	have a full C compiler -- or if they have a 'bundled' one,
53	it's severely crippled, supplied mainly for compiling the
54	kernel/device drivers.
55
56	Perl requires more than that.
57
58	Such crippled platforms include HP-UX and Solaris.  Either
59	you will have to pay for the full C compiler or find
60	yourself the GNU C compiler (gcc) as a binary distribution.
61	If you don't know where to start, locate the FAQ for your
62	platform.  If you don't know what that is or where to get
63	that, use the search engines.  If you don't know what those
64	are, consult your local information systems support.  If
65	they don't know what all the above means, fire them.
66
67-- 
68cpan@perl.org