pod cleanup

Some copyediting perldelta. Pulled in .11.5 delta

Revive threaded builds for AIX

If random_r is disabled, so should srandom_r be. Changes in a distant
caused errors like:

"reentr.h", line 773.16: 1506-007 (S) "struct random_data" is undefined.

In Perl_sv_compile_2op(), remove a suggestion to merge code with pp_entersub.

Add a comment explaining the problems with this function.

Use POD references to documentation when possible.

Use simpler language.

Use POD-style references in the "SEE ALSO" section.

Use POD-style references

Tighten the ropes on sGMTIME_min for HP-UX 11.00

The original long-running test had a tighter limit for
sGMTIME_min and sLOCALTIME_min than the 2**47-1 limit
that was now hardcoded. Take the safe route.

[perl# 73490] Bump Time::Piece to a devel release that's newer than what
was in Blead but is old than the current updated CPAN release. Comment
out a now deprecated 'use UNIVERSAL' line to prevent warnings from
production code. It's bad form to ship software that deprecates things
and then keeps using them and warning. Thanks to xdg++ for the spotting.

Clarify that patching deprecate.pm is intended to facilitate a staged transition.

Describe the limitations and pitfalls of @DB::args.

Fix stringification assumption bug in overload.t, revealed by ia64-linux-ld.

Specifically:
1: / returns and NV where possible, only returning an integer if the dividend
   is an integer larger than an NV can represent accurately, and integer
   division is exact (ie no fractional part/remainder).
2: The test is performing $ref/1, intending it to be an identity operation
   on the numeric value of the reference.
3: The test assumes that the return result of the division will be a number
   that stringifies identically to the integer value of the reference.

The fails if both:

1: The system memory map is such that addresses are very large (ia64 does)
2: NVs are large enough to hold these addresses

because then the address becomes converted to an NV which has sufficient
decimal digits that stringification defaults to scientific notation.

Itanium Linux users the world over will be cheering because they can now
compile Perl with long doubles with confidence that all tests pass.

remove gv_try_downgrade from the public API

it's a recently added function, so removing it now does no harm.

Limit HP-UX 11.00 time to 48 bit in 64bit mode

Re-TODO one more Deparse test

(was missing from 0fa4a26596a4646f9aae1dcd199a2f30933e6f01)

Note that can be warned on implicit utf8 upgrade

The module encoding::warnings can be used to warn when two strings are
concatenated where one is utf8 and the other is not and contains
non-ASCII.

Note the existence of this in the pod documentation.

revert const deparsing in Deparse.pm

The code was added in 5.11.0 by
    2990415a4519bc3988d7224ae15100c3e9e901ee
    805b10112885d8868f21f8e860792d65e1e6c19d
but causes a big slowdown on most deparsing, due to the need
to walk the entire package tree looking for constant subs.

For more details, see
    [perl #73052] Storable considerably slower at storing coderefs

[perl #72740]: Blead breaks LEMBARK/LinkedList-Single-0.99.1.tar.gz

f7461760003db2ce68155c97ea6c1658e96fcd27 improved the PL_check hook for
bareword subs, but broke the above module. This is Zefram's followup:

The issue is that speculative function lookups were leaving detritus
consisting of empty GVs in the stash.  These didn't affect normal
functioning, but code that looks inside the stash could see them, and
code that makes unreliable assumptions about the format of the stash
can be broken.  This is the same general mode of failure that we saw
with namespace::clean.

LinkedList-Single's failing test was using direct stash access poorly,
in a way that made for a poor test, quite apart from making too many
assumptions about stash structure.  In the latest version of the package,
0.99.6, the test has been changed to a much better form, which actually
tests what it meant to and incidentally doesn't read the stash at all.

Although they don't affect normal functioning, the empty GVs shouldn't
be there.  It's much like the upgraded constant subs, which we concluded
ought to be downgraded when the upgraded form is no longer required,
in order to save memory.  The solution here is similar: delete the
empty GV when it is detected that a real GV is no longer required.
The present patch does this at the same time as checking for constant-sub
downgradability.

In comments, correct two instances of SVf_PADSTALE to SVs_PADSTALE.

add makerel option to skip tarball creation

Fix comments about @INC ordering

list undocumented API and internal functions in perlapi.pod and perlintern.pod

List any functions from embed.fnc that don't have documentation in
their own section of perlapi/perlintern as a reminder to either
document them, remove them or perhaps flag them as undeserving of
documentation.

Support cygwin-1.7 mount

Add perlintern.pod documentation docatch + prescan_version

docatch - perl run-time exception handling

Document that there are bugs with EBCDIC and regexes

Bump Safe to version 2.25

Further improvements to the security fix in 16ac9e9a4185d3315152ade5286d4dd3d25bff32

- Destroy all stash entries at once to avoid race conditions.
- For that we save away reference to stashes entries (not
  stash entries themselves like previously, to avoid trigerring
  tie methods)
- Don't skip sub-packages that might be named "main::"

Revert "Upgrade to IPC::SysV 2.02" - We're frozen. This will be great when we unfreeze

This reverts commit 8a720e6ba3939d5db4327226c93348d5acf35145.

Revert "Upgrade to Devel::PPPort 3.19_02" - we're frozen. This will be great when we unfreeze

This reverts commit bfc37ff708b737d2490a23505b932c94f1898073.

Merge remote branch 'origin/blead' into blead

Upgrade to IPC::SysV 2.02

Only define PERL_PATCHNUM when either git or the .patch file is available

This patch also make PERL_GIT_UNCOMMITTED_CHANGES useful and thus avoids
always adding the "*" to the 'perl -v' output.

Upgrade to Devel::PPPort 3.19_02

Moduule::Build test tweaks for VMS.

More complete fix available upstream at:

http://rt.cpan.org/Public/Bug/Display.html?id=55288

ExtUtils-CBuilder test tweak for VMS.

Idential to upstream fix at https://rt.cpan.org/Ticket/Display.html?id=55236

Merge branch 'dual/Safe' into blead

Bump version to 2.24 and update Changes

Clean the stashes from the Safe compartment after evaluation of code.

This way, objects created from inside the Safe compartment won't be
able to call transparently code compiled in the Safe compartment,
without the restrictions being anymore in place.

Fix an example for LC_COLLATE in POSIX.pod that actually sets LC_ALL

Spotted by Olivier Raginel.

Revert "Forbid labels with keyword names"

This reverts commit f71d6157c7933c0d3df645f0411d97d7e2b66b2f.

Revert "Add new error "Can't use keyword '%s' as a label""

This reverts commit 28ccebc469d90664106fcc1cb73d7321c4b60716.

Setup @INC at compile time because commit ec34a119 needs to load utf8.pm

'.' needs to remain in @INC because the test also loads comp/hints.aux
at compile time too.

[perl #73174] swash_init() wasn't saving %^H

fetching from e.g. github requires a repo name

Skip Pod::Parser's find.t on VMS for now.

Pending integration of https://rt.cpan.org/Ticket/Display.html?id=55121

Don't scrub DCL$PATH unless it's there.

It's optional and this was causing test failures when it didn't exist.

Cannot portably split on $Config{path_sep} -- use quotemeta($Config{path_sep}).

Broken in fc5e5837c991d3d3224259ff5c1d728d4e0636e2.

On VMS we were getting:

$ perl -"MConfig" -e "print join('+',split $Config{path_sep}, 'foo|bar|baz');"
f+o+o+|+b+a+r+|+b+a+z

which is a *lot* more pieces than we want.  What was intended was:

$ perl -"MConfig" -e "print join('+',split quotemeta($Config{path_sep}), 'foo|bar|baz');"
foo+bar+baz

No version bump as this is test infrastructure and 1.55 has not been
released outside of development releases of blead.

Un-TODO warning test

Note this doesn't work: $re = "\\N{...}"; /$re/

Document some re bugs in perlre.pod

Document 5.8 regression #72998 in delta

Document parsing changes for [perl #56444] patch

Revise wording about /x caveats

Mention \N{U+...} documentation in delta

Add statement about UTF-8 and \N{} to delta

Document Unicode case-insensitive [] range bug

Quote a code example

Add deprecation of non-name \N{foo} to delta pod

Revise notes on /x modifier

Mark \N meaning [^\n] as experimental

Mention there are places /x modifier is ineffective

Clarify perlrebackslash.pod

Note existence (and warn against using) \N{U+c1.c2...}

Note that \N{U+...} forces character semantics

Document \N{U+...}

Mention \N{U+...} in perlunicode.pod

Update documentation

List known bugs, mention new meaning of \N

Update pods for \N changes

Update charnames documentations for \N changes, bugs

\N has a possible new meaning, and mention bug reports filed against
charnames

Clarify sv.c API wording.

fix for [perl #72604] @DB::args and win32 fork

A previous fix for [perl #66108] (7fa38291524c327a3cb23bfe94979e1537743cac)
stopped cloning PL_dbargs, on the grounds that it was usually filled with
garbage (it contains an un-refcounted copy of @_'s elements; once the
function has returned, these may have been freed or reassigned). However,
the fix instead recreated PL_dbargs as a new empty AV that *wasn't* then
associated with the DB::args glob; so modifications to PL_dbargs weren't
seen via @DB::args.

The fix is to simply set it to null when cloning; pp_caller() will
recreate it again if necessary when it is needed.

bytes.pm: downgrade DEPRECATED to NOTICE

Remove unused variable, spotted by Alex Hunsaker

Add methods wrap_code_ref and wrap_code_refs_within

Typo fix

more prose fixups to bytes.pm deprecation warning

(suggested by Dr.Rudd)

Also share SWASHGET in perls < 5.10, before it was translated from perl to C

Add more version::vxs routines to the default share

This is probably not completely sufficient yet, but with those,
Miyagawa reports all tests passing on 5.10.0 plus version 0.80.

Teach bump-perl-version about additional perl511 references in makedef.pl.

The previous version also missed 2 instances in win32/makefile.mk because
they were written as "perl511$(a)" instead of "perl511.o".

Regression test for 34394ecd - SVs that were only on the tmps stack leaked.

Symbol S_no_symref_sv should be static (local to the compilation unit).

Teach bump-perl-version about perl511.dll, perl511.lib and perl511s.lib

Update the release managers' guide: don't push the tag too soon!

Remind release managers not to push a new tag until the indexing of
the new uploads has been successful. A problem with indexing 5.11.5
meant that we nearly ended up with 5.11.6 instead, since the 5.11.5
tag had already been pushed.

Add new test in Safe's MANIFEST

Bump version to 2.23

Add some symbols from version::vxs to the default share

It appears that the core version.pm works with Safe, but that the
CPAN-upgraded version does not. This will need more investigation
and test coverage, but for now, share the minimal set of symbols
needed to load version.pm in a Safe compartment. This covers
only the XS version of version.pm, not the pure perl alternative.

[perl #72942] Can't perform unicode operations in Safe compartment

The fix is to make Safe load utf8.pm (and ensure utf8_heavy.pl is run)
so it can always share utf8::SWASHNEW.

Install Safe in "site" instead of "perl" for perls > 5.10

That way it will override the Safe distributed with the core
without actually overwriting it, thanks to the @INC reordering.

fix prose from previous lib/bytes.pm doc update

Better explain utf8::upgrade/downgrade/encode/decode

Try to make it clear what each does, and the fact that upgrade/downgrade
don't change the logical string value while encode/decode do.

deprecate bytes.pm

Bram pointed out the new tests hang if the fix for #72878 isn't in place.
This commits traps the recursion and throws an exception.

Another minor update to the release managers' guide

Don't multiply define Perl_regcurly in core and the re extension.

Broken in ff3f963aa0f95ea53996b6a3842b824504b57c79.

stop skipping ext/Fcntl/t/syslfs.t

Since the module reorganisation and now that tests run cd'ed to
ext/Fcntl, expecting to run ../perl no longer works.
Also, for the benefit of future generations, make the inability
to find perl a failure rather than a skip, with a more relevant error
message.

stop cpan/Memoize/t/tie_ndbm.t being skipped

Back in 2006, 0b40f9f8cf631862db10aed9706454c7518fef19 added a skip check
for $ENV{TMP} being writeable. This test failed if $TMP wasn't set, but
also, since then this test script has been updated to write its temp files
to the current dir rather than /tmp, so the TMP check is redundant, and is
now removed.

stop op/groups.t skipping on Linux

My linux (with selinux) includes a "context=" field as part of the
output of "id -a". Make the extraction of the "groups=(.+)" entry
of "id -a" more robust in the presence of unpredictable (in name and
ordering) fields, by splitting on fieldname=(.*), then looking for a field
name of 'groups'.

Sys-Syslog/t/constants.t couldn't find macros.all

The move from ext/ to cpan/ hadn't been reflected in the pathname
of macros.all. However, since tests are now run from the src dir,
the whole $ENV{PERL_CORE} bit is no longer necessary.
(Note that this line has already been modified from the CPAN version,
so a further change to it doesn't really matter as regards maintaining
sync with CPAN).

Update Porting/release_managers_guide.pod and Porting/makerel

In the course of releasing perl-5.11.5 I found a few things that are not
quite correct or no longer relevant:

- Add comments on the problems with doing this on Win32
- There are no longer Roman numerals in README.vms (since eb505c2afb6b5ac2aaba7935878ae6494d44732a)
- Note that Module::CoreList's Changes and META.yml files need updating too
- Fix Porting/makerel's null device redirection

One bigger problem remains to be resolved: when run in a normal cmd.exe
shell on Win32, the Porting/makerel script currently generates tarballs
containing world-writable files and directories, which the PAUSE indexer
then rejects as a possible security risk.

Fix the NAME in two old perlXYZdelta.pod files