X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=INSTALL;h=1daef23f9d5ac91d0a12899954811e92963905d9;hb=c4af86f5b3084bfb0d5b6e7a06b8875b723ab49e;hp=24013313e6645282233816750df3aeb69d1a4393;hpb=54c46bd52029aba6a165e4e0063096edcadd1150;p=p5sagit%2Fp5-mst-13.2.git diff --git a/INSTALL b/INSTALL index 2401331..1daef23 100644 --- a/INSTALL +++ b/INSTALL @@ -42,7 +42,7 @@ If you have problems, corrections, or questions, please see L<"Reporting Problems"> below. For information on what's new in this release, see the -pod/perl5110delta.pod file. For more information about how to find more +pod/perl5116delta.pod file. For more information about how to find more specific detail about changes, see the Changes file. =head1 DESCRIPTION @@ -75,10 +75,10 @@ directory. =head2 Changes and Incompatibilities -Please see pod/perl5110delta.pod for a description of the changes and +Please see pod/perl5116delta.pod for a description of the changes and potential incompatibilities introduced with this release. A few of the most important issues are listed below, but you should refer -to pod/perl5110delta.pod for more detailed information. +to pod/perl5116delta.pod for more detailed information. B This version is not binary compatible with prior releases of Perl. If you have built extensions (i.e. modules that include C code) @@ -93,7 +93,7 @@ The standard extensions supplied with Perl will be handled automatically. On a related issue, old modules may possibly be affected by the changes in the Perl language in the current release. Please see -pod/perl5110delta.pod for a description of what's changed. See your +pod/perl5116delta.pod for a description of what's changed. See your installed copy of the perllocal.pod file for a (possibly incomplete) list of locally installed modules. Also see CPAN::autobundle for one way to make a "bundle" of your currently installed modules. @@ -524,9 +524,9 @@ The directories set up by Configure fall into three broad categories. =item Directories for the perl distribution -By default, Configure will use the following directories for 5.11.0. +By default, Configure will use the following directories for 5.11.5. $version is the full perl version number, including subversion, e.g. -5.11.0 or 5.9.5, and $archname is a string like sun4-sunos, +5.11.5 or 5.9.5, and $archname is a string like sun4-sunos, determined by Configure. The full definitions of all Configure variables are in the file Porting/Glossary. @@ -932,7 +932,8 @@ only if it is able to find the gdbm library. To disable certain extensions so that they are not built, use the -Dnoextensions=... and -Donlyextensions=... options. They both accept -a space-separated list of extensions. The extensions listed in +a space-separated list of extensions, such as C. The extensions +listed in C are removed from the list of extensions to build, while the C is rather more severe and builds only the listed extensions. The latter should be used with extreme caution since @@ -1282,7 +1283,7 @@ various other operating systems. If you plan to port Perl to a new architecture, study carefully the section titled "Philosophical Issues in Patching and Porting Perl" -in the file Porting/pumpkin.pod and the file Porting/patching.pod. +in the file Porting/pumpkin.pod and the file pod/perlrepository.pod. Study also how other non-UNIX ports have solved problems. =back @@ -1315,25 +1316,9 @@ process or the Perl build process will not help you with these. =head2 suidperl -suidperl is an optional component, which is normally neither built -nor installed by default. From perlfaq1: - - On some systems, setuid and setgid scripts (scripts written - in the C shell, Bourne shell, or Perl, for example, with the - set user or group ID permissions enabled) are insecure due to - a race condition in the kernel. For those systems, Perl versions - 5 and 4 attempt to work around this vulnerability with an optional - component, a special program named suidperl, also known as sperl. - This program attempts to emulate the set-user-ID and set-group-ID - features of the kernel. - -Because of the buggy history of suidperl, and the difficulty -of properly security auditing as large and complex piece of -software as Perl, we cannot recommend using suidperl and the feature -should be considered deprecated. - -Instead, use a tool specifically designed to handle changes in -privileges, such as B. +suidperl was an optional component of earlier releases of perl. It is no +longer available. Instead, use a tool specifically designed to handle +changes in privileges, such as B. =head1 make depend @@ -1851,7 +1836,7 @@ If make test bombs out, just cd to the t directory and run ./TEST by hand to see if it makes any difference. If individual tests bomb, you can run them by hand, e.g., - cd t ; ./perl -MTestInit op/groups.t + ./perl -MTestInit t/op/groups.t Another way to get more detailed information about failed tests and individual subtests is to cd to the t directory and run @@ -2351,9 +2336,9 @@ won't interfere with another version. (The defaults guarantee this for libraries after 5.6.0, but not for executables. TODO?) One convenient way to do this is by using a separate prefix for each version, such as - sh Configure -Dprefix=/opt/perl5.11.0 + sh Configure -Dprefix=/opt/perl5.11.5 -and adding /opt/perl5.11.0/bin to the shell PATH variable. Such users +and adding /opt/perl5.11.5/bin to the shell PATH variable. Such users may also wish to add a symbolic link /usr/local/bin/perl so that scripts can still start with #!/usr/local/bin/perl. @@ -2366,13 +2351,13 @@ seriously consider using a separate directory, since development subversions may not have all the compatibility wrinkles ironed out yet. -=head2 Upgrading from 5.10.x or earlier +=head2 Upgrading from 5.11.0 or earlier -B Perl modules having binary parts (meaning that a C compiler is used) will have to be recompiled to be -used with 5.11.0. If you find you do need to rebuild an extension with -5.11.0, you may safely do so without disturbing the older +used with 5.11.5. If you find you do need to rebuild an extension with +5.11.5, you may safely do so without disturbing the older installations. (See L<"Coexistence with earlier versions of perl 5"> above.)