This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
efbc76008bfde5bc2b4aa35cf0bbfe8b30828ae7
[perl5.git] / cygwin32 / build-instructions.READFIRST
1 This document is obsolete. Refer to README.cygwin32. However, if you want
2 to build a statically linked perl binary, then you applied the wrong patch.
3 You want perl5.005_03-static-patch, which will build "Pre-release 1"
4 according to the nomenclature in README.cygwin32.
5
6 The perl source distribution is available from 
7    http://www.cpan.org/src/index.html
8
9 For the easiest build of perl under Cygwin, do the following:
10
11 (1) read
12        *(a) README.cygwin from the perl source distribution
13        *(b) read build-instructions.charles-wilson
14         (b) read build-instructions.sebastien-barre
15         (c) read build-instructions.steven-morlock
16         (d) read build-instructions.steven-morlock2
17         (e) read build-instructions.teun-burgers
18
19 (2) prepare the source
20         (a) unpack perl source distribution in /usr/local/src
21         (b) copy perl5.005_03-static-patch into /usr/local/src/perl5.005_03/
22         (c) cd /usr/local/src/perl5.005_03
23         (d) chmod -R +w *
24         (e) patch -p1 < perl5.005_03-static-patch
25
26 (3) get ready to build
27         (a) cp cygwin32/cw32imp.h .
28         (b) cp cygwin32/gcc2 .
29         (c) cp cygwin32/ld2 .
30         (d) cp cygwin32/perlgcc .
31         (e) cp cygwin32/perlld .
32         (f) cp gcc2 /usr/local/bin
33         (g) cp ld2 /usr/local/bin
34         (h) cp hints/cygwin32.sh config.sh
35         (i) sh Configure -d 
36                 (automatically does a make depend)
37
38 (4) build and install
39         (b) make
40         (c) make test
41         (d) make install
42
43 To customize, look around in the patchfile or ignore the patch and 
44 follow the build-instructions.* directly. If you want to edit the paths 
45 in the patchfile to reflect your system, search for "/usr/" within the 
46 patchfile.
47
48 * MUST read.
49