Distinguish C- and perly- literals - PERLY_BRACE_CLOSE

Distinguish C- and perly- literals - PERLY_BRACE_OPEN

regardless of the fact that both have same value
their meaning is different and should not be mixed

embed.fnc: Mark gv_check as internal

The purpose of this function is to raise a parse warning; not something
something outside core should be doing.

Document SvPV_renew

Provide code example for 'my' declared in initialization of 'for' loop

For: https://github.com/Perl/perl5/issues/18260

List all programs which require regen/embed_lib.pl

newSVsv_flags is now documented

Fix Time::HiRes compile probe on VMS

The probe was checking the severity bits of the compiler exit
status and requiring the value to be 1, which is what they are
for SS$_NORMAL. But actually any true (odd) value is considered
successful. So, for example, if the compile succeeds but emits
"informational messages" that do not rise to the level of warnings
or errors, the severity bits have a value of 3, not 1. The probe
should not fail (and end up halting the build) in this case, so
allow any successful value.

Don't define Perl_regcurly in re extension

This makes the linker have to decide (or guess) which of the
identically-named symbols to include.  The VMS linker refuses
and throws a multiply-defined symbol error.

pod_rules.pl: document (in a comment) --tap

Test regexp optimizations for substrings

Better skipping for regexp optimization tests

Say why we're skipping; skip min/max tests for substrings if we didn't
get the substring; skip checking test for substrings if we didn't get
the substring we expect to be checked.

No plan for regexp optimization tests

With a varying number of tests per data line, the plan is too much work
to maintain.

Allow comments in regexp optimization tests

Add test harness for regexp optimization

Better documentation for two Porting/*.pl programs

In partial satisfaction of https://github.com/Perl/perl5/issues/18413.

Porting/pod_rules.pl: no '--test' command-line switch

As is illustrated by the following (trimmed) invocation:

        ./perl -Ilib Porting/pod_rules.pl --test
        Unknown option: test

... there is no '--test' option available for this program.  Remove
inaccurate inline documentation.

In partial satisfaction of https://github.com/Perl/perl5/issues/18413.

skip trying to constant fold an incomplete op tree

This code would try to constant fold an op tree like

  relop
    +- null
    +- constant

which would underflow the stack, potentially crashing perl.

This is intended as a quick fix rather than as a complete
solution.

Fixes #18380

Remove workaround for distros needing dot in @INC

In commit 19641fd71a (Apr 07 2017), as part of ceasing to pass '.' to
@INC in tests, we added a workaround to t/TEST for CPAN distributions
which ship with core which were not yet fully adapted to the new
regulation on @INC.

All such CPAN distributions have now been adapted.  Hence, we can remove
the workaround.

GH #18163: Stricter, cleaned up test example: (#18165)

* GH #18163: Stricter, cleaned up test example:

This just adds 'my $i' to make the test pass on strict, and it cleans
it up and provides test names for the tests.

I kept the tabs that were used.

* Use relative path

* Indent for readability

* Missing variables

* Add another reference

* Remove '&' in function calls

* Add some hints

* Normalize quoting in WriteMakeFile examples

* Remove explicit quotes

* Apply all additional suggestions

* replace tabs, make line shorter

Make DynaLoader on MacOS check library existence with dlopen

A number of system libraries no longer exist as actual files, even
though dlopen will pretend they do, so now we fall back to dlopen if
a library file can not be found.

do not look for modules under */*/{inc,t} for Module::CoreList

this avoids adding the internal modules inc::QuestionList (from perlfaq) or
Win32API::File::inc::ExtUtils::Myconst2perl (from Win32API-File)

Update ExtUtils-MakeMaker to CPAN version 7.58

  [DELTA]

7.58    Mon 21 Dec 18:16:04 GMT 2020

    No changes since v7.57_02

7.57_02 Fri 18 Dec 23:04:09 GMT 2020

    Macosx fixes:
    - Improve dlopen check on MacOS

7.57_01 Fri 18 Dec 13:30:30 GMT 2020

    Macosx fixes:
    - Use dlopen to check for library presence on Mac OS (Big Sur fix)

    Bug fixes:
    - check CPAN::Meta::Requirements capabilities rather than prereqs

Win32API::File::inc::ExtUtils::Myconst2perl is not indexed

..and Porting/corelist.pl warns about it

This is a re-application of commit cdac9b8288885
after the change was reversed a month later.

regexec.c: Silence compiler warning

POSIX.pod: Document [C99] notation

This fixes GH #18404

POSIX.xs: Remove redundant #ifdef

HAS_DUPLOCALE is implied by HAS_POSIX_2008_LOCALE; no need to mention it

globals.c: Fix typo in comment

t/test.pl: Note 2nd spelling for fcn

This makes it easier to grep for

perlapi: Note that my_strftime's result is localized

Merge branch 'perlgov' into blead

perlgov: add a missing "the" and remove a full stop

perlgov: formatting tweaks from code review

perlgov: the perl governance document

regexec.c: Fix failing CI 32-bit tests

This bug was introduced by bb3825626ed2b1217a2ac184eff66d0d4ed6e070, and
was the result of overflowing a 32 bit space.  The solution is to rework
the expression so that it can't overflow.

regen/regcharclass.pl: Mark intermediate macros as internal

The macros generated by this script may have to be split into sub-macros
to make the overall macro fit the maximum number of characters allowed
by the compiler for a macro definition.  This commit adds a trailing
underscore to the names of such intermediate macros so as to mark them
as non-API for autodoc.

Correct one misspelled variable name

Correct one other typo

perl5335delta grammar nit

perlapi: SvPVbyte_force() and kin: clarify.

perlapi: Document newSVsv_flags

embed.fnc: Mark several do_dump fcns as Core only

These appear to be helper functions for various API functions; there are
no uses of them in cpan

embed.fnc: Mark sv_2uv, etc. as Core only

There are documented macros that one is supposed to use instead for this
functionality.

embed.fnc: Mark stack_grow as Core only

This is a helper function used by such things as SSGROW; there is no
cpan usage

embed.fnc: Mark scan_num as Core only

This is used by the toker to scan a number; there is no cpan usage

embed.fnc: Mark cx_dump as Core only

This appears to be for internal debugging; there is no cpan usage

embed.fnc: Mark av_arylen_p, av_iter_p as Core only

These appear to be internal functions, and there is no cpan usage

The macro GIMME_V is what one is supposed to use for this functionality.

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