perldelta: "single character" is clearer than "length one"

porting/podcheck.t: improve diagnostic

If a test fails because the number of warnings for a pod file was more
than expected, make it clear in the diag output that it was indeed
why it failed.

clarify SvPV* and SvPV_force* docs

See RT #116407.

Make it clear that SvPV(sv) does not always equal SvPVX(sv), and to use
SvPV_force() if necessary. Also, clarify that SvPV_force() will destroy
any non-string content like a reference. Then, make the other SvPV*
descriptions in general refer back to SvPV() or SvPV_force(), so that
people will spot these added caveats.

Remove PERL_ASYNC_CHECK() from Perl_leave_scope().

PERL_ASYNC_CHECK() was added to Perl_leave_scope() as part of commit
f410a2119920dd04, which moved signal dispatch from the runloop to
control flow ops, to mitigate nearly all of the speed cost of safe
signals.

The assumption was that scope exit was a safe place to dispatch signals.
However, this is not true, as parts of the regex engine call
leave_scope(), the regex engine stores some state in per-interpreter
variables, and code called within signal handlers can change these
values.

Hence remove the call to PERL_ASYNC_CHECK() from Perl_leave_scope(), and
add it explicitly in the various OPs which were relying on their call to
leave_scope() to dispatch any pending signals. Also add a
PERL_ASYNC_CHECK() to the exit of the runloop, which ensures signals
still dispatch from S_sortcv() and S_sortcv_stacked(), as well as
addressing one of the concerns in the commit message of
f410a2119920dd04:

    Subtle bugs might remain - there might be constructions that enter
    the runloop (where signals used to be dispatched) but don't contain
    any PERL_ASYNC_CHECK() calls themselves.

Finally, move the PERL_ASYNC_CHECK(); added by that commit to pp_goto to
the end of the function, to be consistent with the positioning of all
other PERL_ASYNC_CHECK() calls - at the beginning or end of OP
functions, hence just before the return to or just after the call from
the runloop, and hence effectively at the same point as the previous
location of PERL_ASYNC_CHECK() in the runloop.

perldelta: update how we talk about COW

perldelta: use v5.x rather than 5.x

Suggested by Nicholas Clark:

The text refers to perl version numbers as 5.12, 5.12.x, 5.12.3
v5.12, v5.12.3.  I think it would be best if it were consistent with
a v as either v5.12 for the series, or v5.12.3 for a particular
release.  Specifically because use 5.12.3; works, but use 5.12;
doesn't.

perldelta: we suspect no known problems..?

perldelta: typo fix

from Nicholas Clark

perldelta: use UTF-8 when we mean UTF-8

most of these changes from Nicholas Clark

perldelta: warn of more platform deprecation

perldelta: correct "new hash function" entry

perldelta: hash ordering may differ, may not

...the key is that you cannot rely on anything about it

revise hash overhaul docs

perldelta: drop a reference to a change internal to 5.17

perldelta: remove an inscrutable note, clean up another

silence warnings under NO_TAINT_SUPPORT

The are lots of places where local vars aren't used when compiled
with NO_TAINT_SUPPORT.

fix threaded NO_TAINT_SUPPORT build errors

NO_TAINT_SUPPORT incorrectly called Perl_croak without aTHX_.

To fix this, change Perl_croak to Perl_croak_nocontext, since it is
slightly more efficient in instruction size than Perl_croak.

dump.c: avoid compiler warning under -Dmad

this fix was already applied to the non-MAD branch; apply it to
the similar MAD / xml-dump code.

dump.c:2663:57: warning: comparison of constant 85 with expression of type
      'svtype' is always false [-Wtautological-constant-out-of-range-compare]
    else if (sv == (const SV *)0x55555555 || SvTYPE(sv) == 'U') {

toke.c/MAD: silence a couple of warnings

A couple of vars are set but not used under -Dmad.
The easiest way to silence the warnings is to use PERL_UNUSED_VAR()
rather than try to #ifdef away all the places the vars appear under mad.

Minor touch-ups to VMS section of perldelta.

spelling, punct fixes for perldelta

Officially deprecate stdio/sfio builds of perl

Quick fixes to Yves' hash randomization documentation

perldelta: Typos, grammar

Change some perldelta text

This removes things that aren't applicable except to intra-5.17
releases, and rewords some poorly worded text.

Use 'was' not 'is' to describe fixed regressions

'is' implies it still is extant, contrary to the meaning of the text.

perldelta: mention non-blocking sockets on VMS

perldelta: mention PERL_NO_INLINE_FUNCTIONS in delta

perldelta: use Pod, not asterisks, for emphasis

perldelta: document PERL_PERTURB_KEYS

Restore the warning previously issued by (-l $fh)

This is a partial reversion of 433644eed8, which removed a
secondary, short-circuiting behavior when the warning was issued.

Now, the warning is issued, but the normal behavior (treat the
handle as a string) is maintained.  This work was done after
subsequent refactoring to doio.c, so it couldn't be just a
reversion with the "return" statement removed.

add various HASH defines to perl -V output

5.18 contains lots of new build knobs to control hash randomisation.
Add them to the perl -V output.

INSTALL: fix a couple of typos

release_managers_guide: fix typo

bisect-runner.pl: clarify -D,-U,-A args in docs

Based on http://www.perlmonks.org/?node_id=1032501, these arguments could
be confusing.

pod/perldelta: Add in some deprecations; fix a typo

Feel free to improve the wording of these.

bump dist/IO/lib/IO/Handle.pm version to 1.34

[perl #117791] Clarify that write does not match the C 'write' semantics

document and improve hash algorithm randomization related build options

Install was a copy of other material, made heavy reference to 5.8.x and
and didnt really document what it should have. I reworked it to be more
up to date.

cleanup and test PERL_PERTURB_KEYS environment variable handling

remove the 5.17 deltas, update for 5.18

put the perldelta we had been working on in place

update perldiag with new warnings

regenerate uconfig.h and META.json

Bump version to 5.18.0-RC0

This was done with:

  ./perl -Ilib Porting/bump-perl-version -i 5.17.12 5.18.0

Followed by two tiny manual edits: INSTALL and patchlevel.h

The URL for the dist source repo changed

RMG: say that for maint there are two RMG versions

RMG: add note about maint and Module::CoreList

RMG: maint perlhist: change from push to pull

When creating a new maint release, rather than copying its perlhist entry
into every other branch just after release, instead just copy it into
blead; then when creating a new maint release, just pull the latest
perlhist file from blead.

RMG: maint perldeltas: change from push to pull

When creating a new maint release, rather than copying its perldelta into
every other branch just after release, instead just copy it into blead,
then when creating a new maint release, copy any newer perldeltas from
blead.

add PERL_NEW_COPY_ON_WRITE to perl -V output

hoping this works finally. gcc is too permissive with my build options

document Hash::Util::hash_traversal_mask()

It still needs tests. But I figured it would be easier to test
by someone else if I documented it. (Ill try to get tests done for it
soon).

fix build issue with picky compilers

Ensure -DUSE_PERLIO gets into Config's ccflags when using dmake on Windows

The -DUSE_PERLIO flag was being used to build perl itself, but amazingly
didn't end up in Config's ccflags, potentially causing trouble later when
building XS extensions. (The problem isn't new: it's been this way ever
since PerlIO support for Windows was added by e601c439, way back in
November 2000.)

Make it possible to disable and control hash key traversal randomization

Adds support for PERL_PERTURB_KEYS environment variable, which in turn allows one to control
the level of randomization applied to keys() and friends.

When PERL_PERTURB_KEYS is 0 we will not randomize key order at all. The
chance that keys() changes due to an insert will be the same as in
previous perls, basically only when the bucket size is changed.

When PERL_PERTURB_KEYS is 1 we will randomize keys in a non repeatedable
way. The chance that keys() changes due to an insert will be very high.
This is the most secure and default mode.

When PERL_PERTURB_KEYS is 2 we will randomize keys in a repeatedable way.
Repititive runs of the same program should produce the same output every
time. The chance that keys changes due to an insert will be very high.

This patch also makes PERL_HASH_SEED imply a non-default
PERL_PERTURB_KEYS setting. Setting PERL_HASH_SEED=0 (exactly one 0) implies
PERL_PERTURB_KEYS=0 (hash key randomization disabled), settng PERL_HASH_SEED
to any other value, implies PERL_PERTURB_KEYS=2 (deterministic/repeatable
hash key randomization). Specifying PERL_PERTURB_KEYS explicitly to a
different level overrides this behavior.

Includes changes to allow one to compile out various aspects of the
patch. One can compile such that PERL_PERTURB_KEYS is not respected, or
can compile without hash key traversal randomization at all. Note that
support for these modes is incomplete, and currently a few tests will
fail.

Also includes a new subroutine in Hash::Util::hash_traversal_mask()
which can be used to ensure a given hash produces a predictable key
order (assuming the same hash seed is in effect). This sub acts as a
getter and a setter.

NOTE - this patch lacks tests, but I lack tuits to get them done quickly,
so I am pushing this with the hope that others can add them afterwards.

Removed confusing reference to new in ties perlfunc entry

improve unpackstring() API docs

See ticket RT #116366 for the full discussion

Revert "Update docs to concur with $`,$&,$' changes"

This reverts commit d78f32f607952d58a998c5b7554572320dc57b2a.

Since COW has now not been enabled by default for 5.18, revert the
documentation changes which say that that $' etc no longer have a
performance penalty, etc.

make /(?p:...)/ keep RXf_PMf_KEEPCOPY flag

RT #117135

The /p flag, when used internally within a pattern, isn't like the
other internal patterns, e.g. (?i:...), in that once seen, the
pattern should have the RXf_PMf_KEEPCOPY flag globally set and not
just enabled within the scope of the (?p:...).

Use PTR2IV() instead of casting a pointer to IV, to avoid warnings.

The cast to IV was added to avoid problems on platforms where pointers are
larger than longs. However, the change instead generates warnings on
platforms where IVs are larger than pointers. Instead, use the PTR2IV()
macro provided by perl.h to make everyone happy.

Also change the type of the variable on that line, because it is cast to
STRLEN the first time it is used, and then passed to a macro that assigns it
to an int regardless.

Improve the logic in regen_perly.pl for manually generating token macros.

Without this fixup the build breaks on Win32. Previously it was enabled using
a second regular expression to parse the bison version string. This
effectively duplicates the first regular expression that parses the bison
version string to determine if the version of bison found can be used.

The second regular expression could get missed when changing the first, as
happened with commit f5cf236ddbe8e24e. So refactor the code to extract the
bison version once, and then use this later as a simple numeric comparison.

With this change, we can actually use bison 2.7 to regenerate perly.*

Fix non-blocking sockets on VMS.

It turns out sockets on VMS (just like Windows) are blocking by
default, but the same code already in IO::Socket::blocking for
Windows that uses ioctl to set non-blocking works just fine on VMS.

This is part of [perl #116433] as the deficieny was exposed by
tests in IO::Socket::IP.

Merge perldelta for 5.18, work from past weeks

perldelta: split change is incompatible

perldelta: "corrupts"

perldelta: singular agreement

perldelta: "no" missing

perldelta: unwanted comma removed

The sense is "matching no longer excludes", which can't take a comma (even
though the qualifiers on "matching" are quite long)>

perldelta: mark $_ as code in header

perldelta: "continuation of"

Not "for".

perldelta: fatal error is an error, not a warning

"(F)" removed, since everything in the 'New Errors' section is obviously
an error, and none of the other errors in there are marked as such.

perldelta: semicolon there isn't code

perldelta: extraneous word removed

perldelta: join sentence fragment

perldelta: avoid comma splice

perldelta: short-circuit cross-reference chain

perlre/(?[ ]) just says to see perlrecharclass/Extended Bracketed
Character Classes, so may as well point people there in the first place.

perldelta: DTrace probes as bullet list

It was a definition list, but with only terms (no definitions), and hence
no indentation.

perldelta: spelling fix

perldelta: an env var doesn't do anything itself

perldelta: missing parenthetical comma

"in hex" is parenthetical

perldelta: "order" is intended word

warn of more things to be removed

carry forward future deprecations from 5.16 delta

perldelta: mention the removal of BeOS

perldelta: the selected bugs

perldelta: miscellaneous editing in the middle parts

perldelta: deprecations section

perldelta: the incompatible changes section

perldelta: finish reordering and first pass through Core Enh.

experimental feature warning categories have ::

perldelta: collect hash changes

perldelta: tweak/fix "earlier changes" section

import perl51710delta content to perl5180delta

import perl5179delta content to perl5180delta

import perl5178delta content to perl5180delta

import perl5177delta content to perl5180delta

import perl5176delta content to perl5180delta

import perl5175delta content to perl5180delta

import perl5174delta content to perl5180delta