From: Rafael Garcia-Suarez Date: Thu, 19 Jul 2007 07:44:19 +0000 (+0000) Subject: Suggestion and fixes to the hash seed docs by Paul Johnson X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=09885f8292459868adaef452a613def47a463f54;p=p5sagit%2Fp5-mst-13.2.git Suggestion and fixes to the hash seed docs by Paul Johnson p4raw-id: //depot/perl@31631 --- diff --git a/pod/perlrun.pod b/pod/perlrun.pod index 73850f3..06649b8 100644 --- a/pod/perlrun.pod +++ b/pod/perlrun.pod @@ -1258,11 +1258,11 @@ PERL_ENCODING environment variable is consulted for an encoding name. =item PERL_HASH_SEED X -(Since Perl 5.8.1.) Used to randomise Perl's internal hash function. +(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 not always be ordered the same between different -runs of Perl. +things, that hash keys will always have the same ordering between +different runs of perl. Most hashes return elements in the same order as Perl 5.8.0 by default. On a hash by hash basis, if pathological data is detected during a hash @@ -1270,10 +1270,10 @@ key insertion, then that hash will switch to an alternative random hash seed. 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 +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 +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. B. Hashes are