Commit | Line | Data |
16d20bd9 |
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 |
14 | Slightly changed installation directories. See INSTALL. |
15 | |
16d20bd9 |
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 |
23 | Many hint file updates. |
24 | |
8e07c86e |
25 | Improve and simplify detection of local libraries and header files. |
26 | |
27 | Expand documentation of installation process in new INSTALL file. |
28 | |
4633a7c4 |
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 |
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 |
43 | make distclean # (if you've built perl before) |
44 | rm -f config.sh # (in case distclean mysteriously fails) |
4aa0a1f7 |
45 | sh Configure [whatever options you like] |
46 | make depend |
47 | make |
48 | make test |
16d20bd9 |
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 | |