embed.fnc: Note functions that have documentation

A bunch of functions actually were documented, but this fact was omitted
in embed.fnc.

numeric.c: Fix typo in pod

embed.fnc: Fix typo in comment

pad.h: Parameters to many functions are ptrs

The apidoc entries for 22 functions forgot that the parameters were
pointers to the type.  Since these are macros, this error wasn't caught
until Devel::PPPort tried to generate a test case for them.

autodoc.pl: Fix typo in comment

Fix typo in STORE_LC_NUMERIC_SET_TO_NEEDED_IN docs

[perl #134172] perldelta

[perl #134172] Avoid multiple checks of IN_LC(LC_NUMERIC)

This adds new API macros STORE_LC_NUMERIC_SET_TO_NEEDED_IN and
WITH_LC_NUMERIC_SET_TO_NEEDED_IN that accept a precalculated value
for the hints checks of IN_LC(LC_NUMERIC).

[perl #134172] restrict scope of locale changes during sprintf

In some environments we must hold a mutex for the duration of a temporary
locale change, so we must ensure that mutex is released appropriately.
This means intervening code must not croak, or otherwise bypass the
unlock.

In sv_vcatpvfn_flags(), that requirement was violated when attempting
to avoid multiple temporary locale changes by collapsing them into
a single one. This partially undoes that to fix the problem, while
still attempting to retain some of the benefits by caching the
expensive hints check.

perldelta for 8348ac19a3c3

(perl #134310) don't confuse S_no_op()

This code could previously set PL_bufptr so it points after the
returned s pointer, which S_no_op() asserts on for the test case.

Since setting PL_bufptr here is useful when producing the error
message, just make sure we restore it.

Recommend chdir after chroot more strongly

On Thu, Jul 25, 2019 at 09:35:44AM -0600, Theo de Raadt wrote:
> It is mandatory because otherwise a program-user can arrange for cwd
> to be outside the jail, and utilize that fact to pivot, and in some
> program path utilizations the chroot then becomes not just pointless..
> it is worse than normal, because it creates a dual-namespace view of
> the filesystem, that is a condition that program and libraries are not
> prepared to operate in.

https://marc.info/?l=openbsd-misc&m=156406908805913&w=2

vms/vms.c: fix unused relational comparison result

Closes [perl #134307].

Configure: reuse "cached" value of "none" for dir

When value of a directory (i.e. man1dir) is set to "none" because of:
- '-D' option set on cmdline (i.e. -Dman1dir=none) OR
- because value is reused from previous configure run

And when the prefix is different from the previous configure run(*) then
keep the value of "none". predefined/cached value does not contain the
old prefix so there is no harm in keeping it.

(*): due to another bug this also happens when prefix ends with a
     trailing slash

See https://rt.perl.org/Ticket/Display.html?id=134284

Remove trailing '/' from prefix

Change how/when the trailing '/' from a prefix is removed.

The original code had two problems:

1) it only stripped the trailing slash when value was predefined
   (either from -Dprefix=/foo/bar/ or from a previous configure run)
2) when it did strip the value then it also caused 'oldprefix' to
   be set. This in turns causes other predefined (/cached) paths to
   be ignored.

See https://rt.perl.org/Public/Bug/Display.html?id=134284

embed.fnc: foldEQ has documentation

embed.fnc: Certain fcns don't have Perl_ prefix

This fixes embed.fnc to match the reality.

embed.fnc: Fix wrong comment

embed.fnc: Clarify wording

An 'A' flagged element is accessible everywhere.  I think that is
clearer than the previous 'Available'

Document my_sprintf as deprecated

It turns out that Devel::PPPort needs a documentation entry for this
function in order to not have to special case it.  So, add a brief
explanation as to why its deprecated.

handy.h: Add missing character classification synonym

This should complete the set.

perldelta for 43e5ab2e34fe

I don't think f670c2bb3dd57 needs a perldelta entry.

avoid synthesizing locale names with newlines in them

while debugging some strange behaviour on Win32 I tried dumping
locale names in _trylocale() and saw names go past like:

sv_fi.15
          <-- newline added at the end
sv_fi.15
.UTF-8
sv_fi.15
.65001
sv_fi.15
.ACP
sv_fi.15
.OCP
sv_fi.15
.1252

Win32: set FOO lists values for all variables starting with FOO

I'd been testing setting FOOBAR to Unicode values, so this test was
failing due to the extra variable.

Fix obsolete mention if is_sig in S_pending_ident comment

Commit 49fb862041f1f74fafbc91afa553624c43078261 replaced the parameter
with a pseudo-keyword value KEY_sigvar in PL_in_my, but forgot to
update the comment.

[perl #132474] Add function for parsing sub signatures

This exposes a GRAMSUBSIGNATURE top-level production from perly.y for
toke.c to consume, which parses a subroutine signature, inside the
parens.

This needed a small change to the existing rules, to pull out a rule
that handles all of the insides of the parens but not the parens
themselves.

(h/t to ilmari for the suggestion)

perldelta for e3f4f3212908, 33617017c38f, cfb8d85df6eb

bump $File::Find::VERSION

for the win32 test change

bump $Devel::PPPort::VERSION

for the mktests change

File-Find/t/find.t: reindent after adding a SKIP block

writing to the root directory requires elevated privileges

on modern Win32, and testing might be done without such elevation.

I'll re-indent in the next commit

ensure mktests.PL produces the same output cross-platform

With the change to always generate the tests, this was producing
modified files on Win32, with the path in the header and the line
endings changing.

perldelta for 85d4e0a35b2d

(perl #134291) propagate non-PVs in $@ in bare die()

add perlweb update to RMG

e.g. as done at https://github.com/perlorg/perlweb/pull/289

perldelta for 6b62d97b14ca2894417d0297a435c63e056e31fe

Fix pod formatting

&gt; is an HTML entity, not pod.

Committer: increment $VERSION

For: RT # 134300

Update next major release number in Porting/todo.pod

update 'say' docs to better represent reality

Get dist/Devel-PPPort/t/uv.t passing

Module::CoreList 5.20190720 is now on CPAN

Update Module::CoreList for 5.31.3

Bump version to 5.31.3

Create new perldelta for 5.31.3

Tick off 5.31.2

Add epigraph for 5.31.2

5.31.2 today

Finalize perldelta

Update Module::CoreList for 5.31.2

perldelta tidy-ups

VC6 support is likely to be removed soon

perldelta - Document a couple more changes

No need to list CUSTOMIZED files for anything but upstream=>CPAN modules

The vast majority of upstream=>BLEAD modules having modifications over the
given CPAN release aren't listed in Maintainers.pl. Net::Ping was the only
anomaly, and was out of date too -- t/001_new.t and t/010_pingecho.t are
also modified but weren't listed.

Revert the Module::CoreList part of 7872aa47f6

5.31.1 contained B::Op_private 5.031001 and Module::CoreList* 5.20190620

Revert the Module::CoreList part of e01077d94e

5.15.0 contained CGI::Util 3.53
5.21.7 contained File::Spec 3.53
5.31.1 contained Devel::PPPort 3.53

perldelta - Remove boilerplate stuff

perldelta - Documentation and Diagnostics

perldelta - Modules and Pragmata

Document known problems on Windows

Fix upgrade notes in INSTALL

Each BLEAD release is potentially not binary compatible with the previous
release.

RMG - Fix a couple of typos

Config::Perl::V is ahead of CPAN

Correct an epigraph link

Fill in missing epigraphs links

(perl #134221) MSVC doesn't define O_ACCMODE

perldelta for ae73d7ec2329, 0424723402ef, 74b421cc877e

(perl #134221) preserve O_APPEND for open ... undef calls.

For most systems this means switching from mkstemp() to mkostemp(),
which Zefram helpfully added an emulation for.

For Win32 the append seems to happen in the POSIX emulation, not in
WriteFile(), so we can simply supply the flags to _open_osfhandle().

After some discussion with Craig Berry, the VMS version of the code
now uses largely the same mkostemp() code, with some special code in
the mkostemp() emulation to allow marking the file to be deleted
automatically when closed.

(perl #134221) support O_APPEND for open ..., undef on VMS

VMS doesn't allow you to delete an open file like POSIXish systems
do, but you can mark a file to be deleted once it's closed, but
only when you open it.

Since VMS doesn't (yet) have mkostemp() we can add our own flag to
our mkostemp() emulation to pass the necessary magic to open() call
to delete the file on close.

(perl #134221) support append mode temp files on Win32 too

(perl #134221) support append mode for open .. undef

Update IPC-Cmd to CPAN version 1.04

  [DELTA]

1.04 Sat Jul 13 10:08:08 BST 2019

  Bug fixes:
  - Fixed usage of setsid()

Support Bison version 3.1 through 3.4

No significant changes in the generated code since 3.0.

PerlIO-encoding/t/encoding.t: improve test skip

One test is skipped if $PERL_DESTRUCT_LEVEL is set and its a DEBUGGING
build, as it produces a spurious "Unbalanced string table" warning.

However, this warning is emitted on non-DEBUGGING builds too: It's just
that until a couple of weeks ago, $PERL_DESTRUCT_LEVEL wasn't honoured
on non-DEBUGGING builds, so this was never spotted.

threads::shared: fix leak

When assigning a shared reference value to a variable containing a
shared string, the PV buffer in the shared space was leaked. For
example:

    my $s :shared = "foo";
    my $t :shared  = shared_clone(\"bar");
    $s = $t; # "foo" in shared space leaked

This was showing up as failed smokes under ASan.

Correct typo in POSIX.pod

For RT #134272, as suggested by Paul Townsend.

avoid SEGV with uninit warning with multideref

RT #134275

When the 'uninitialized warning' code in S_find_uninit_var() comes
across an OP_MULTIDEREF node, it scans it to see if any part of that op
(e.g. the indices or the returned value) could have been the source of
the uninitialized value which triggered the warning.  Unfortunately when
getting an AV or HV from a GV, it wasn't checking whether gp_av/gp_hv
contained a NULL value. If so, it would SEGV.

The test code is a bit contrived; you have to "pull the rug" from under
the GV at just the right moment with *foo = *bar, then trigger an uninit
warning on an op whose subtree includes an OP_MULTIDEREF.

Allow -Uusedtrace / -Dusedtrace=false / -Dusedtrace=no

pp_sys.c: fix the position of HAS_SETNETENT definement

Else, DIE() will bever be executed.

perldelta for 2773b4f50f99

Revert "postpone perl_parse() exit(0) bugfix"

This reverts commit 857320cbf85e762add18885ae8a197b5e0c21b69,
re-instating the [perl #2754] fix, which was reverted in late
2017 to allow Module::Install based distributions to update or
re-work per [perl #132577].

# Conflicts:
# t/op/blocks.t

make apidoc error reporting a little more explicit

(perl #120841) document some errno macros for internal use

(perl #120841) document ERRSV and CLEAR_ERRSV()

perldelta for fb81daf0179f, 66ff4fb58270

use hex for the call_*()/eval_sv() flag definitions

while I expect most C programmers have these powers of two engraved
into their brains, using hex makes this more obvious

(perl #134177) add G_RETHROW flag to eval_sv()

and update eval_pv() to use it.

Commit df09255f was by new contributor

Update AUTHORS to keep make test_porting happy.

PVS-Studio: fixed warning in ternary operator.

(from https://github.com/Perl/perl5/pull/17)

make variable names consistent in this example

..as suggested by Andre Schultz at https://github.com/OpusVL/perldoc.perl.org/issues/57

Fix "it it" typos

And regen affected files

Update META.json following JSON::PP update

Update Pod::Simple from version 3.38 to 3.39

Update JSON::PP from version 4.02 to 4.04

perldelta: fix typo

perldelta entry for v5.31.1-101-g5c696bd319

Print a more helpful UNREACHABLE message when NOT_REACHED assertion fails

utf8_to_uvchr_buf() make behavior match docs

For well formed input, there is no change.  But for malformed it wasn't
returning the documented length when warnings were enabled, and not
always the documented value when they were disabled.

This is implemented as an inline function, called from both the macro
and the Perl_ form.

Devel::PPPort has sufficient tests for this.

perl.h: Add a comment about tainting

(perl #134187) how do we know it's a Turkic locale

Not by name.

perldelta for c0ad3f089909e