embed.fnc: Mark doing_taint as Core only

This appears to be for internal use, and there are no cpan usages

embed.fnc: Mark cxinc as Core only

The macro CXINC is what one is supposed to use for this functionality.
(though it is currently undocumented)

embed.fnc: Mark moreswitches as Core only

This is an internal function used to parse command line options; there
are no cpan uses.

embed.fnc: Mark runops_debug, runops_standard as Core only

These are internal functions to run the program; there are no cpan uses

embed.fnc: Mark regnext as Core only

This is used internally by the regex engine; there is one use in cpan,
an internals module, Devel::RegExp by Ilya Zakharevich, with nothing
dependent on it, and last updated in 1995.

embed.fnc: Mark cx_dup as Core only

Similar cx functions are supposed to be called with a macro for their
functionality, but no such macro exists for this, and there are no uses
on CPAN

perlapi: Document and consolidate SvPV functions

POSIX::asctime pod: Note it always returns English

And give locale's alternative

perlfunc: Improve localtime entry

This rearranges some paragraphs that really belong together, and
clarifies the result is always in English

regexec.c: Link to github issue in comment

Prepare Module::CoreList for 5.33.6

Bump version to 5.33.6

new perldelta for 5.33.6

Update release schedule

Update epigraphs.pod with quote from Max Weber

Merge branch 'release-5.33.5' into blead

# Conflicts:
# pod/perldelta.pod

add new release to perlhist

Update Module::CoreList for 5.33.5

Finalize perldelta for 5.33.5

Finalise perldelta for 5.33.5

Fix broken PERL_MEM_LOG under threads

This fixes GH #18341

There are problems with getenv() on threaded perls wchich can lead to
incorrect results when compiled with PERL_MEM_LOG.

Commit 0b83dfe6dd9b0bda197566adec923f16b9a693cd fixed this for some
platforms, but as Tony Cook, pointed out there may be
standards-compliant platforms that that didn't fix.

The detailed comments outline the issues and (complicated) full solution.

Add GETENV_LOCK

get_env() needs to lock other threads from writing to the environment
while it is executing.  It may need to have an exclusive lock if those
threads can clobber its buffer before it gets a chance to save them.
The previous commit has added a Configure probe which tells us if that
is the case.  This commit uses it to select which type of mutex to use.

Add Configure probe for getenv() buffer race

Most implementations do not have a problem with two getenv()'s running
simultaneously in different threads.  But Posix doesn't require such
good behavior.  This adds a simple probe to test the current system.

perl.h: Add capability for many-reader ENV mutex locking

There are several places where there could be a problem in the
environment were changed by another thread when a function is executing,
but otherwise if another thread were reading the environment at the same
time, there isn't a problem.  This adds mutex for that situation.
Future commits will take advantage of it.

Make many-reader mutexes more resilient

These mutexes rely on a counter being accurate to work.  If for some
reason that I can't imagine happening, the count goes below 0, this
commit resets it to zero, which may be enough to cause the program to
continue.

regexec.c: White-space, comments only

Mostly indent because the prior commit created a new block

regexec.c: Revamp S_setup_EXACTISH_ST() loop end conditions

Consider the pattern /A*B/ where A and B are arbitrary.  The pattern
matching code tries to make a tight loop to match the span of A's.  The
logic of this was not really updated when UTF-8 was added.  I did
revamp it some releases ago to fix some bugs and to at least consider
UTF-8.

This commit changes it so that Unicode is now a first class citizen.
Some details are listed in the ticket GH #18414

regexec.c: Change name of static function

The new name reflects its new functionality coming in future commits

regexec.c: Trim trailing blanks

regcharclass.pl: Get code point folding to a seq

Previously regcharclass.pl could tell if an input string was a
multi-character fold of some Unicode code point.  This commit adds the
ability to return what that code point is.  This capability will be used
in a later commit.

regen/regcharclass.pl: Rmv special case

This avoided checking for optimizations.  Whatever its original use, it
doesn't do any good, and the optimizations are actually useful.

ext/POSIX/t/waitpid.t: Correct one typo

MANIFEST: Add ext/POSIX/t/iv_const.t

ext/POSIX: Added tests to check integer constants are defined as IV

ext/POSIX: Change integer constants to IV.

Some floating-point related constants, such as (FLT|L?DBL)_DIG,
FLT_RADIX, FP_*, etc. had been defined as NV, but these are
actually integer constants.

This change should not affect the behaviour of user programs.

perldelta for edd16cfcff

Add pod/perldocstyle.pod

Satisfies https://news.perlfoundation.org/post/grant_proposal_documentation_standards_perl7

Committer: Adding a new file underneath pod/ entails adding (i) an entry for that file
in pod/perl.pod and (ii) entries in win32/pod.mak.

(i) In turn requires, figuring out an appropriate category within
perl.pod in which to place the new file.  The entry should match that in
MANIFEST and be consistent with the style of entries in MANIFEST.

(ii) Requires running Porting/pod_rules.pl so that entries in
win32/pod.mak are also generated for the corresponding *.man, *.html and
*.tex files.

Supersedes https://github.com/Perl/perl5/pull/18275.

Update Config::Perl::V to 0.33

Merge branch 'thibaultduponchelle-fix_rt_number_in_perl5260delta' into blead

Merge branch 'fix_rt_number_in_perl5260delta' of https://github.com/thibaultduponchelle/perl5 into thibaultduponchelle-fix_rt_number_in_perl5260delta

Fix RT number in perl5260delta.pod

Update ExtUtils-Install to CPAN version 2.20

  [DELTA]

2.20

- Exercise _is_prefix() method more in tests
- Optimisations for file comparisons
- Optimisations for directory creation
- Typo fix in POD
- Optimisations for tree traversal

Also update Maintainers.pl with the updated PerlIO::via::QuotedPrint version

Update PerlIO::via::QuotedPrint from 0.08 to 0.09

This should be picked up by the auto-generated perldelta

Update Text::Balanced from 2.03 to 2.04

No entry in Perldelta because that will be generated automatically

Correctly set LC_CTYPE back in POSIX/t/time.t

t/lib/croak/toke: Correct test label

The RT ticket number cited in the test's label is wrong.  The body of
the commit message for commit 7259f4194f3131957240f6b3dba47b74f53ac660
shows the correct RT number.  Provide GH number as well.

autodoc.pl: Adjust max permissible line length

perldoc takes up 4 column indent, not 7.

podcheck.t: Combine duplicated code into a sub

podcheck.t: perldoc standard indent is 4.

Before, it was using an expected nroff indent of 7.  But current perldoc
places the =head1 lines at the left margin, and the text within them
indented by 4.

perlapi: 'ie' should be 'i.e.', and italicized

bump $XS::APItest::VERSION

consistently parenthesise the RW lock macro arguments

and fix the mixed up pointer vs non-pointer use of the mutex
argument.

Without the parentheses (or without the new tests in the previous
commit) for code like;

 PERL_WRITE_LOCK(&PL_some_mutex);

the MUTEX_LOCK(mutex.lock) in that code would expand to:

  MUTEX_LOCK(&PL_some_mutex.lock);

and happen to work,  even though the next line has:

  if ((mutex)->readers_count)

treating the mutex parameter as a pointer.

With the parentheses the MUTEX_LOCK(mutex.lock) becomes:

  MUTEX_LOCK((&PL_some_mutex).lock);

which as expected fails to compile in a similar way to the pointer
test code in the previous commit.

build test for the read/write mutex macros

This fails to compile

perl.h: White-space only

Properly indent some nested #defines

perlapi: Remove duplicate text

This came about in a rebasing error

Document and consolidate SvPV..force functions

Consolidate and document all get_cvFOO() variants

many-reader mutexes: Change structure element name

The old name did not encompass all the possible reasons for the
mutex signal condition to be invoked

PERL_WRITE_UNLOCK: add missing condition signal

The mutex is locked, and any contenders are awaiting a signal, which
until this commit was missing.

dist/threads/t/libc.t: Add timer to avoid deadlock

This test file can deadlock if there are bugs.  Add a timeout to keep
the test from hanging indefinitely.

locale.c: Work around a z/OS limitation/feature

Without per-thread locales, a multi-thread application is inherently
unsafe.  IBM solves that by allowing you to set up the locale any way
you want, but after you've created a thread, all future locale changes
are ignored, and return failure.

But Perl itself changes the locale in a couple of cases.  Recent changes
have surfaced this issue in one case, leading to a panic.  And this
commit works around it, so that messages will be displayed in the locale
in effect before the threads were created.

The remaining case requires further investigation.  Nothing in our suite
is failing.

perlapi: Add markup

Combine the two separate smoke test sections

Simplify the release management instructions

Getting access to GitHub issues and commit privileges takes one action,
not two, so merge the separate sections.

dromedary no longer has a public_html directory

The old users.perl5.git.perl.org machine has been offline for some time.
A replacement exists at dromedary.p5h.org, but this does not provide
per-user public_html directories for sharing files.

Synch with CPAN distribution libnet-3.12

Correct POD formatting error

Implement SAVEt_STRLEN_SMALL

Most uses of SAVEt_STRLEN actually store small values; often zero.
Rather than using an entire U64-sized element for these values, it saves
space to use the same "SMALL" mechanism as other numerical values, like
SAVEt_INT_SMALL.

Fix freebsd/netbsd builds

These have an inconsistent configuration in which several functions exist
for thread-safe locales, but the crucial one doesn't show up in our
Configure probe.  The code this commit fixes assumed that all or nothing
would be present.

Fix cygwin build

A macro name changed, and I didn't see it in the grep

bump perl5db.pl's $VERSION

jkahrman is now a perl author

test - and . at beginning of debugger alias name

Allow debugger aliases that start with '-' and '.'

Since the '.' and '-' commands don't take any arguments and don't run if any are provided, don't treat commands starting with these characters as the single commands '.' and '-'. Restores behavior that existed prior to https://github.com/Perl/perl5/commit/7fdd4f080863703d44282c6988834455d129040 (v5.27) at least back to v5.8.8

https://github.com/Perl/perl5/commit/7fdd4f080863703d44282c6988834455d129040

locale.c: Remove some unnecessary mutex locks

These aren't necessary as the called function has its own lock until
done copying into the local structure.

And these were breaking blead on Windows, as they are no longer defined.
The smoke I ran included more commits beyond the breaking one, so I
didn't catch it.

locale.c: Unlock mutex before croaking

These cases aren't supposed to happen, but unlock the mutex first;
we could get into deadlock in trying to output the death message.

Name individual locale locks

These locks for different functions all use the same underlying mutex;
but that may not always be the case.  By creating separate names
used only when we think they will be necessary, the compiler will
complain if the conditions in the code that actually use them are the
same.  Doing this showed a misspelling in an #ifdef, fixed in
9289d4dc7a3d24b20c6e25045e687321ee3e8faf

Refactor locale mutex setup

This was prompted by my realization that even on a locale thread-safe
platform, there are functions we call that may not be thread-safe in
that they return their results in an internal static buffer, which may
be process-wide instead of per-thread.  Tomasz Konojacki++ briefly
looked at Windows source code for localeconv() and this indeed did
appear to be the case.

If we thought a platform was thread-safe, no locale mutexes were set up,
and instead the calls in the code to lock were no-oops.  This would lead
to potential races, the most likely candidate being localeconv().  None
have been reported, at least as far as we know.  Likely that function
isn't called frequently.  This would be true on both Posix 2008 and
Windows platforms, except possibly for FreeBSD, which may be the only
platform that we support that has a localeconv_l() function, which is
supposed to be immune from this issue..

The solution adopted here is to test for all the possible functions that
the Perl core uses that may be susceptible to this, and to set up the
mutex if any are found.  Thus there won't be no-ops where there should
be a lock.

Change name of mutex macro.

This macro is for localeconv(); the new name is clearer as to the
meaning, and this preps for further changes.

locale.c: Add debugging info to panic message

duplocale() is part of Posix 2008 locales

Thus if we know we have the Posix versions, we have duplocale(), and
hence don't need to test separately for it.

Fix up many-reader mutex typedef

This previously worked on some compilers, but not others.

Add author name in alphabetically correct place

Update the Xcode version in the testsuite.yml workflow

Xcode v12 is now the default Xcode version: https://github.com/actions/virtual-environments/issues/2056

Use macOS-10.15 explicitly

Add Jae Bradley as an Author

Explicitly use Catalina when running the test with Xcode 11

Remove empty "#ifdef"s

Here be camels

perly.y: avoid <0 test on unsigned value

Coverity CID 313707

Moving to a newer version of Bison has changed how the YYTRANSLATE()
macro is defined: in particular it now has a <0 test, which
Coverity is complaining about, since the arg is an unsigned value.

This commit just casts the arg back to a signed value. In more detail:
we formerly had:

    yytoken = YYTRANSLATE(NATIVE_TO_UNI(parser->yychar));

yychar is of type int, but NATIVE_TO_UNI returns a UV. So just cast the
result back to an int:

    yytoken = YYTRANSLATE((int)NATIVE_TO_UNI(parser->yychar));

perldelta.pod: Document new "0o" octal syntax.

perlfunc.pod: add a description for octal strings for oct()

These sentences are borrowed from the description for hex().

perldata.pod: mention new octal integer format (0o12_345).

pp.c: oct() now skips "0o" and "o" prefix.

t/op/oct.t: Add test for oct() with 0o and o prefix.

toke.c: Eliminate temporary variables base, Base and max.

These variables are only used on emitting diagnostic messages.
Calculating them on-demand will make the code slightly faster
on normal cases.

Note: previously bases[], Bases[] and maxima[] may be completely
optimized out by fusing array accesses into if-brances.
Now they become real arrays, and will slightly increase the number
of dynamic relocations on PIC build.

toke.c: Preserve "0o" prefix on warnings and strings passed to overload hook.

toke.c: Recognize "0odddd" octal literals.

t/base/num.t: Add some test for "0odddd" octals.

Use GNU Bison's named references

Usage of Bison's named references makes actions little bit easier
to read and maintain.

Raise minimal supported GNU Bison version to 2.5

which added support for named references