perldelta: Nits

perldelta: Add a bunch of C<> and S<>

It also removes some C<> that were in verbatim sections; reorders some
wording

perldelta: Minor consistency / grammar fixes.

perldelta: Reword entry about double-diamond operator.

perldelta: Update release order for consistency

Fix a few perldelta typos

perldelta - Fill in missing rt.perl.org links

perldelata: consolate PERL_OP_PARENT stuff

The PERL_OP_PARENT stuff was introduced in 5.21.2, updated in 5.21.7, then
considerably revised in 5.21.11. Consolidate the three sets of perldelta
entries into one coherent whole.

perlhist: add the release data for 5.22

Some of this may change, but nothing significantly.

perlapi: Use UVCHR_SKIP not UNI_SKIP

This new name is more consistent with other uses in the API.

perlfunc: Slight clarification

PATCH: [perl #125145] perlrun: Fix typo

perlperf: fix some apostrophes and add a C<>

Do not use bareword TERM or KILL in kill() call in test watchdog process

perlebcdic: Document v5.22 EBCDIC bugs

perlunicode: Fix small misstatement

perlapi: Add 2 links to other parts of the pod

perldelta: Fix some podcheck pedantic errors

perlport: Add notes about EBCDIC

podcheck: add known link target Devel::Spy

Bump perl version to v5.22.0-RC0

perldelta: Devel-Spy known to be broken

bump version of overload in corelist

document that we may add more overloaded ops over time

perldelta: prefer "CPAN" to "cpan"

perldelta/perldiag: make a pod cross-reference pass tests

Why is this change needed?

describe errors with no description, delete obsolete warnings

perldelta is now the perl5220delta

corelist for v5.22.0

bump version: make regen

...but actually we are RC0

bump version to v5.22.0 with Porting/bump-perl-version

POSIX.pm: bump version

POSIX: revert exported functions to 5.20.2 state

This patch does 3 things. For the purposes of bisectability it is
unfortunately not feasible to split them up into separate patches.
They are as follows:

1. Revert the list of default exports in t/export.t to what it was
   in the commit tagged v5.20.2, but take the opportunity to retab
   it since the blame log is messed up anyway. (This can be verified
   with a whitespace-ignoring diff.) Then add the new exports in new,
   separate sections.

2. In POSIX.pm, remove the new fenv_h tag from default exports and
   revert the math_h and stdlib_h tags to their state in Perl 5.20.2.

3. Add infrastructure for adding export tags that will not automatically
   get added into @EXPORT when it is generated, and use this to add new
   tags for the stuff added since 5.20.2. Since tags named after math_h
   and stdlib_h already exist, duplicate them as stdlib_h_c99/math_h_c99
   with their new additions included.

Add note to EBCDIC README's, asking for input

I asked on perl-mvs for help in updating these files, but got no advice;
so noting in the files themselves that they are out-of-date, and asking
any reader for help.

allow undef as an arg to '&' prototype

RT #123475

Commit e41e9865be5555 (to fix [perl #123062]) restricted the types of
args allowed for a function with a '&' prototype - previously it allowed
array refs and the like. It also removed undef, so this was now a
compile-time error:

    sub foo (&) {...}
    foo(undef)

However, some CPAN code used the idiom register_callback(undef) to
explicitly disable a registered callback.

So re-allow an explicit undef.

perlop: Don't use bitwise string ops on UTF-8

The behavior is likely to change

perlop: Make correction

This recipe has the same result under both EBCDIC and ASCII

perlguts: Add links to perlunicode

perlunicode: Revamp

I've always had problems understanding the point of some of the
discussion of this pod, so I've finally rewritten parts to bring it
up-to-date with modern Unicode support and clarify things.

In particular the "byte" vs "character" semantics didn't make sense to
me.  Perl has always used character semantics (outside of a few places
noted in both pod versions); it's just that the advent of Unicode made
'byte' and 'character' no longer synonymous.  So I've split that section
of the old pod, with the added section entitled "ASCII rules vs Unicode
rules", which I think is more clear.

perlunicode: Nits, minor fixes

perluniintro: Add note

Unicode ranges don't currently work in tr///

perlunitut: Add note

perlrun: Note existence of -DL

perlrebackslash: Note \b{sb} is subject to change

The Unicode algorithm has big issues, and may change.

perlebcdic: Move text from perlunicode

This consolidates the EBCDIC problems into one place

perlapi: Clearer wording in intro

perlapi: Add intro text to Unicode section

perlunicode: Refer to perlguts for XS handling

Don't redescribe things here.  Also refer to perlapi.

perlguts: Add/update text about handling Unicode

perlguts: Add EBCDIC info

perlguts: Nits, corrections and clarifications

perlapi: Document some functions

These are mentioned in some other pods.  It's best to bring them into
perlapi, and refer to them from the other pods.

utf8.h: Add a #define

The name UVCHR... parallels the usage of various functions uvchr...
It's less confusing to keep the same name form for the same type of
functionality

Add a missing word in perlobj

POSIX: discourage use of default exports

POSIX/t/math.t: skip fpclassify where unsupported

POSIX: document the new C99 math constants

Fix unixify when beginning with current directory.

VMS::Filespec::unixify has been truncating its return value and
returning early when the input begins with [] meaning the current
directory.  If there was nothing else, we've been getting the right
answer:

    [] --> ./

but if there was a file portion of the name it's been getting
omitted:

    []foo.txt --> ./

which is now fixed.  Looks like it's been broken since inception
in 5.002, though only with the specific [] case and not if there
was an explicit device or directory name.

perlvar: Mention literal cntrls are deprecated in var names

Merge branch 'perldelta' into blead

perldelta: sort changed warnings

perldelta: sort new warnings

perldelta: sort new errors

perldelta: minor fixes, XXX-removal, etc.

perldelta: combine and sort the various perldoc updates

perldelta: minor reordering of optimizations

perldelta: remove modules-to-be-removed section

I do not think we will be needing it either.

perldelta: remove Notice section

I do not think we will be needing it.

perldelta: import changes from perl52111delta

perldelta: import changes from perl52110delta

perldelta group core enhancements by topic area

perldelta: remove unneeded placeholders

also, two minor tweaks: remove note of grok_atou, which is
gone; fix the invocation for acknowledgements.pl

perldelta: import changes from perl5219delta.pod

perldelta: import changes from perl5218delta.pod

perldelta: import changes from perl5217delta.pod

perldelta: import changes from perl5216delta.pod

perldelta: import changes from perl5215delta.pod

perldelta: import changes from perl5214delta.pod

perldelta: import changes from perl5213delta.pod

perldelta: import changes from perl5212delta.pod

perldelta: import changes from perl5211delta.pod

What about perl5210delta, you ask?  It had no changes of note beyond
module changes.

fix weird comment in cop.h blurb

The original blurb which I added to the top of cop.h had an ambiguous
statement in it that sometime later got "corrected" into the wrong
meaning.

null ptr deref in Perl_cv_forget_slab

RT #124385

Parsing following a syntax error could result in a null ptr dereference.

This commit contains a band-aid that returns from Perl_cv_forget_slab() if
the cv arg is null; but the real issue is much deeper and needs a more
general fix at some point.

Basically, both the lexer and the parser use the save stack, and after an
error, they can get out of sync.

In particular:

1) when handling a double-quoted string, the lexer does an ENTER, saves
most of its current state on the save stack, then uses the literal string
as the toke source. When it reaches the end of the string, it LEAVEs,
restores the lexer state and continues with the main source.

2) Whenever the parser starts a new block or sub scope, it remembers the
current save stack position, and at end of scope, pops the save stack back
to that position.

In something like

    "@{ sub {]}}  }}}"

the lexer sees a double-quoted string, and saves the current lex state.
The parser sees the start of a sub, and saves PL_compcv etc. Then a parse
error occurs. The parser goes into error recovery, discarding tokens until
it can return to a sane state. The lexer runs out of tokens when toking
the string, does a LEAVE, and switches back to toking the main source.
This LEAVE restores both the lexer's and the parser's state; in particular
the parser gets its old PL_compcv restored, even though the parser hasn't
finished compiling the current sub. Later, series of '}' tokens coming
through allows the parser to finish the sub. Since PL_error_count > 0, it
discards the just-compiled sub and sets PL_compcv to null. Normally the
LEAVE_SCOPE done just after this would restore PL_compcv to its old value
(e.g. PL_main_cv) but the stack has already been popped, so PL_compcv gets
left null, and SEGVs occur.

The two main ways I can think of fixing this in the long term are
1) avoid the lexer using the save stack for long-term state storage;
in particular, make S_sublex_push() malloc a new parser object rather
than saving the current lexer state on the save stack.
2) At the end of a sublex, if PL_error_count > 0, don't try to restore
state and continue, instead just croak.

N.B. the test that this commit adds to lex.t doesn't actually trigger the
SEGV, since the bad code is wrapped in an eval which (for reasons I
haven't researched) avoids the SEGV.

[perl #124187] don't call pad_findlex() on a NULL CV

perlunicode: Update nonchars discussion for Unicode 7.0

Unicode 7.0 changed the prohibition of noncharacters to merely "not
recommend" their use.  Perl continues to forbid them in strict input
checking (otherwise security issues could arise), but the discussion
about them needs to be updated to correspond with their new status.

The message raised when they are used probaby should change
correspondingly, but it is too late for 5.22 for that.

This commit deletes some text elsewhere about the noncharacter code
points.  This text really wasn't germane to a discussion about UTF-8
(wherein it appeared), as the encoding is irrelevant to these code
points.  They're not recommended in any UTF format.

Unicode spells the term "noncharacter" without a hyphen.  This pod
changes to follow that spelling.

POSIX: Regeneralize export.t to non-ASCII platforms

This reverts commit 2da5b9bef2ef557a6978ec45042e29fa38e9bade and solves
the problem by sorting the expectation data instead, to make sure it is
consistent with the sort order of the comparison data. This removes the
need to depend on another file.

PATCH: [perl #124348] re/pat_advanced solaris failure

Tony Cook traced this down to a compiler bug.  But it's easy to change
the code to avoid the problem.  The expression evaluates to 0; and was
only in the form that caused the failure to document what was going on.
Now, instead the failed form is shown in comments, and 0 is used
directly.

avoid uninit read in re_op_compile()

Some code in this function examines the first two nodes in the regex to
set suitable flags etc. Part of the code accesses the second node
by using regnext(first), other parts by NEXTOPER(first). The second method
only works when the node is the same size as a basic node. I *think*
that the code only makes use of this second value in situations where
the node *is* basic, but nevertheless, it makes valgrind unhappy when
the first node is an EXACT node, and reading the second node's
supposed type field is actually reading the padding bytes at the end of
the EXACT string, which are uninitialised.

So just use regnext() only.

Something as simple as /x/ on non-debugging builds was enough to make
valgrind complain. (On debugging builds, the program buffer is initially
zero-filled.)

Also restore the index entry for $OLD_PERL_VERSION

This was missed in d2578154934acc58c35260d46623962e12848748.

add back documentation that $OLD_PERL_VERSION is an alias for $]

move the documentation for $] out of the deprecated section

op_sibling_splice(): handle custom ops

op_sibling_splice() decides whether a parent op has an op_last field
that needs updating based on the op's class. However, it it didn't
handle OP_CUSTOM ops.

Spotted by Zefram.

perlhacktips: Add character set portability tip

perlhacktips: Nit, clarification

[perl #123737] Fix assertion failure with 0$#{

This is a follow-up to FC's 488bc579589, which stopped assertion
failures on parsing 0${. A similar code path still failed with
0$#{.

The fix is similar to the previous fix, although I suspect a more general
fix is needed - perhaps moving the fixes into S_no_op() - but not this
close to the 5.22 release.

correct the deprecation data in Module::CoreList

perlapi: Wrap long verbatim lines to 79 columns

Regen podcheck db

Recent commits have caused it to fail under -i-pedantic

CoreList: eliminate trailing spaces from some versions

reported by perlancar, [perl #124364]