Commit | Line | Data |
---|---|---|
16d20bd9 AD |
1 | ------------- |
2 | Version 5.002 | |
3 | ------------- | |
4 | ||
5 | Summary of user-visible Configure and build changes since 5.001: | |
6 | ||
7 | Yet more enhancements and fixes have been made to the Configure and | |
8 | build process for perl. Most of these will not be visible to the | |
9 | ordinary user--they just make the process more robust and likely to | |
10 | work on a wider range of platforms. | |
11 | ||
12 | This is a brief summary of the most important changes: | |
13 | ||
4633a7c4 LW |
14 | Slightly changed installation directories. See INSTALL. |
15 | ||
16d20bd9 AD |
16 | Include 5.000 - 5.001 upgrage notes :-) (see below). You might |
17 | want to read through them as well as these notes. | |
18 | ||
19 | Install documentation for perl modules and pod2* translators. You can | |
20 | now view perl module documentation with either your system's man(1) | |
21 | program or with the supplied perldoc script. | |
22 | ||
16d20bd9 AD |
23 | Many hint file updates. |
24 | ||
8e07c86e AD |
25 | Improve and simplify detection of local libraries and header files. |
26 | ||
27 | Expand documentation of installation process in new INSTALL file. | |
28 | ||
4633a7c4 LW |
29 | Try to reduce Unixisms (such as SH file extraction) to enhance |
30 | portability to other platforms. There's still a long way to go. | |
31 | ||
4aa0a1f7 AD |
32 | Upgrade Traps and Pitfalls: |
33 | ||
34 | Since a lot has changed in the build process, you are probably best off | |
35 | starting with a fresh copy of the perl5.002 sources. In particular, | |
36 | your 5.000 or 5.001 config.sh will contain several variables that are no | |
37 | longer needed. Further, improvements in the Configure tests may mean | |
38 | that some of the answers will be different than they were in previous | |
39 | versions, and which answer to keep can be difficult to sort out. | |
40 | Therefore, you are probably better off ignoring your old config.sh, as | |
41 | in the following: | |
42 | ||
8e07c86e AD |
43 | make distclean # (if you've built perl before) |
44 | rm -f config.sh # (in case distclean mysteriously fails) | |
4aa0a1f7 AD |
45 | sh Configure [whatever options you like] |
46 | make depend | |
47 | make | |
48 | make test | |
16d20bd9 AD |
49 | |
50 | ------------- | |
51 | Version 5.001 | |
52 | ------------- | |
53 | ||
54 | Summary of user-visible Configure and build changes since 5.000: | |
55 | ||
56 | A large number of enhancements and fixes have been made to the | |
57 | Configure and build process for perl. Most of these will not be | |
58 | visible to the ordinary user--they just make the process more robust | |
59 | and likely to work on a wider range of platforms. | |
60 | ||
61 | This is a brief summary of the most important changes. | |
62 | ||
63 | Configure changes: | |
64 | New and improved Configure command line options. -O now overrides | |
65 | config.sh settings. -D options can now include spaces, if | |
66 | protected in quotes (e.g. -Dcc='gcc -posix'). Type Configure -h | |
67 | for a full listing of options. | |
68 | ||
69 | Users can now turn on the defaults for the rest of Configure by | |
70 | typing &-d at any Configure prompt. This is useful if you just | |
71 | want to change one or two answers. | |
72 | ||
73 | Support on (non-Sun) SVR4 systems for dynamic loading and shared | |
74 | libperl.so | |
75 | ||
76 | Numerous new or updated hints files: PowerUnix, aix 3.x and 4.x, | |
77 | bsd386, convexos, cxux, DEC OSF, Esix, FreeBSD, HP-UX (especially if | |
78 | you're using the bundled compiler), irix 4.x, 5.x, and 6.x, Linux, | |
79 | MPE/IX, NeXT 3.0 and 3.2, Solaris, SVR4, Ultrix (especially 4.3), | |
80 | and Unicos. | |
81 | ||
82 | Improved generation of a suitable name for architecture-dependent | |
83 | library files. NOTE: This may differ from the name you had from | |
84 | your 5.000 installation. | |
85 | ||
86 | Many many portability enhancements and fixes. | |
87 | ||
88 | Build process: | |
89 | ||
90 | The process for building extensions has been extensively revised. See | |
91 | lib/ExtUtils/MakeMaker.pm for complete documentation. Basically, with | |
92 | just a simple Makefile.PL (such as the one generated by h2xs), you can | |
93 | now build an extension from anywhere on your system, even if you've | |
94 | deleted the perl source. | |
95 | ||
96 | Improved build/install documentation in README. A little. | |
97 | ||
98 | Improved dynamic loading on HP-UX. Support dynamic loading on SVR4. | |
99 | ||
100 | Installperl now gets the version correct :-) | |
101 | ||
102 | Installperl now saves the perl *.h files and the libperl.a library | |
103 | in your architecture-dependent library directory so that you can | |
104 | later build extensions without having to re-install the perl | |
105 | source. | |
106 | ||
107 | Include x2p/a2p.c generated by byacc from x2p/a2p.y. | |
108 | ||
109 | Many many portability fixes. | |
110 | ||
111 | Upgrade Traps and Pitfalls: | |
112 | ||
113 | Since a lot has changed in the build process, you are probably best | |
114 | off starting with a fresh copy of the perl5.000 sources. In particular, | |
115 | your 5.000 config.sh will contain several variables that are no longer | |
116 | needed. Further, improvements in the Configure tests may mean that some | |
117 | of the answers will be different than they were in 5.000, and which answer | |
118 | to keep can be difficult to sort out. Therefore, you are probably | |
119 | better off ignoring your old config.sh. | |
120 | ||
121 | One big change is that architecture-dependent library files may well | |
122 | be stored in a different location in 5.001. This is because the default | |
123 | name used in the 5.000 release was not sufficiently specific to | |
124 | distinguish incompatible architectures. The relevant variable is $archlib | |
125 | in config.sh. Before you run ``make install'' you should rename your old | |
126 | $archlib. Thus if your $archlib for version 5.000 was | |
127 | /usr/local/lib/perl5/foo, and your new value for 5.001 is | |
128 | /usr/local/lib/perl5/foo-bar, then you should | |
129 | mv /usr/local/lib/perl5/foo /usr/local/lib/perl5/foo-bar | |
130 | before running ``make install''. | |
131 | ||
132 | Alternatively, you could override Configure's default guess for $archlib | |
133 | either by sh Configure -Darchname='foo', or by answering 'foo' when | |
134 | prompted by Configure for the architecture name. | |
135 | ||
136 | The following is the sequence of steps to upgrade to 5.001: | |
137 | cd perl5.000 | |
138 | make realclean | |
139 | rm config.sh | |
140 | <apply 5.001 patch> | |
141 | sh Configure | |
142 | make depend | |
143 | make | |
144 | make test | |
145 | <mv old architecture-dependent library to new location, if needed> | |
146 | make install | |
147 |