X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlrun.pod;h=d8ed107ac797debe432b72231508e7009b70364f;hb=a5365663f59d38ce50a53f9b46b25daa36d5ab17;hp=85d3bdf7b4de57eb71b5b55e5a30219b4860f704;hpb=18aba96f40a877297fb70961dbd4be7bc6f1c199;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlrun.pod b/pod/perlrun.pod index 85d3bdf..d8ed107 100644 --- a/pod/perlrun.pod +++ b/pod/perlrun.pod @@ -14,7 +14,8 @@ B S<[ B<-sTtuUWX> ]> S<[ B<-x>[I] ]> S<[ B<-i>[I] ]> S<[ B<-e> I<'command'> ] [ B<--> ] [ I ] [ I ]...> - S<[ B<-C [I] >]> ]> + S<[ B<-A [I] >]> + S<[ B<-C [I] >]> =head1 DESCRIPTION @@ -126,7 +127,7 @@ as the first line in C<*.cmd> file (B<-S> due to a bug in cmd.exe's =item MS-DOS Create a batch file to run your program, and codify it in -C (see the F file in the source +C (see the F file in the source distribution for more information). =item Win95/NT @@ -253,6 +254,12 @@ format: C<-0xHHH...>, where the C are valid hexadecimal digits. (This means that you cannot use the C<-x> with a directory name that consists of hexadecimal digits.) +=item B<-A [I]> + +Activates the assertions given after the switch as a comma-separated +list of assertion names. If no assertion name is given, activates all +assertions. See L. + =item B<-a> turns on autosplit mode when used with a B<-n> or B<-p>. An implicit @@ -887,11 +894,13 @@ used. =item PERL5LIB -A colon-separated list of directories in which to look for Perl library +A list of directories in which to look for Perl library files before looking in the standard library and the current directory. Any architecture-specific directories under the specified locations are automatically included if they exist. If PERL5LIB is not -defined, PERLLIB is used. +defined, PERLLIB is used. Directories are separated (like in PATH) by +a colon on unixish platforms and by a semicolon on Windows (the proper +path separator being given by the command C). When running taint checks (either because the program was running setuid or setgid, or the B<-T> switch was used), neither variable is used. @@ -1055,7 +1064,7 @@ and Win32 approximate equivalent: =item PERLLIB -A colon-separated list of directories in which to look for Perl library +A list of directories in which to look for Perl library files before looking in the standard library and the current directory. If PERL5LIB is defined, PERLLIB is not used. @@ -1099,6 +1108,30 @@ references. See L for more information. If using the C pragma without an explicit encoding name, the PERL_ENCODING environment variable is consulted for an encoding name. +=item PERL_HASH_SEED + +(Since Perl 5.8.1.) Used to randomise Perl's internal hash function. +To emulate the pre-5.8.1 behaviour, set to an integer (zero means +exactly the same order as 5.8.0). "Pre-5.8.1" means, among other +things, that hash keys will be ordered the same between different runs +of Perl. + +The default behaviour is to randomise unless the PERL_HASH_SEED is set. +If Perl has been compiled with C<-DUSE_HASH_SEED_EXPLICIT>, the default +behaviour is B to randomise unless the PERL_HASH_SEED is set. + +If PERL_HASH_SEED is unset or set to a non-numeric string, Perl uses +the pseudorandom seed supplied by the operating system and libraries. +This means that each different run of Perl will have a different +ordering of the results of keys(), values(), and each(). + +See L for more information. + +=item PERL_HASH_SEED_DEBUG + +(Since Perl 5.8.1.) Set to "1" to display (to STDERR) the value of +the hash seed at the beginning of execution. + =item PERL_ROOT (specific to the VMS port) A translation concealed rooted logical name that contains perl and the @@ -1111,7 +1144,8 @@ L and in F in the Perl source distribution. In Perls 5.8.1 and later. If set to C the pre-Perl-5.8.0 signals behaviour (immediate but unsafe) is restored. If set to -C the safe (or deferred) signals are used. See L. +C the safe (or deferred) signals are used. +See L. =item PERL_UNICODE