better comment what regen/mg_vtable.pl does

This automates the generating of a lot of perl magic tables and macros,
but it was very opaque as to how it did it.

generate_uudmap.c: add comments and headers

Add some comments at the top of this file to explain what it does.

Also make it add comment headers at the tops of the three files it
generates (uudmap.h bitcount.h mg_data.h) which explain that the file
is auto-generated and what its purpose is.

document PerlIO::scalar's behavior for read-only scalars

fixes #17971

remove leaky warnings.t skip

Two tests used to skip under ASan because they were known to leak.
This has since been fixed

cop.h: remove obsolete comment

The macro which the comment describes is long gone, but the comment got
missed.

pp_multiconcat(): tweak a const

Remove a bit of a hack done by me 2 years ago to shut up a compiler warning
which did a cast to RW of a constant string.

Since the field which the const string is assigned to is never modified,
just make that field const instead.

t/perf/benchmarks: tweak mixed arithmetic

The benchmarks which test adding an int to a num weren't measuring
correctly because, after the first iteration, the PVIV var got upgraded
to a PVNV - thus causing the optimised 'both args NV' path to be chosen
after that.

Make the benchmark recreate the integer variable on each iteration

perlre: Fix some links

perlapi: Don't display certain flag values

These were not intended to go into perlapi, but the flag indicating so
was mistakenly left off.

Document vnewSVpvf

not only system and library calls can set errno

Unfortunately I don't remember the ticket, but I remember one
complaining that code like C<print $fh "..."> would set $!
when $fh wasn't an open filehandle, so cover that case here too.

clarify that errno can be set to non-zero on success

S_lossless_NV_to_IV(): skip Perl_isnan

This inline function was added by v5.31.0-27-g3a019afd6f to consolidate
similar code in several places, like pp_add(). It also avoided undefined
behaviour, as seen by ASan, by no longer unconditionally trying to cast
an NV to IV - ASan would complain when nv was -Inf for example.

However that commit introduced a performance regression into common
numeric operators like pp_and(). This commit partially claws back
performance by skipping the initial test of 'skip if Nan' which called
Perl_isnan(). Instead, except on systems where NAN_COMPARE_BROKEN is
true, it relies on NaN being compared to anything always being false,
and simply rearranges existing conditions nv < IV_MIN etc to be
nv >= IV_MIN so that any NaN comparison will trigger a false return.

This claws back about half the performance loss. The rest seems
unavoidable, since the two range tests for IV_MIN..IV_MAX are an
unavoidable part of avoiding undefined behaviour.

add new autodie test file to 'TEST -deparse' skips

autodie tests generally fail the 'deparse and run the test file'
round trip due to stringified references in %^H. Add this newish test
file to the list of excluded test files.

Improve documentation grammar

Stop implying "." belongs in $ENV{PATH}

Instead, use an arbitrary path that has less chance of encouraging
people to allow the current directory in their path.

This was prompted by #16951 and attached as a patch to that issue which
was mistakenly closed without fixing the problem.

Fix typos in comments

Document DEFSV DEFSV_set SAVE_DEFSV

sort { return foo() } ...

GH #18081

A sub call via return in a sort block was called in void rather than
scalar context, causing the comparison result to be discarded.

This because when a sort block is called it is not a real function
call, even though a sort block can be returned from. Instead, a
CXt_NULL is pushed on the context stack. Because this isn't a sub-ish
context type (unlike CXt_SUB, CXt_EVAL etc) there is no 'caller sub'
on the context stack to be found to retrieve the caller's context
(i.e. cx->cx_gimme).

This commit fixes it by special-casing Perl_gimme_V().

Ideally at some future point, a new context type, CXt_SORT, should be
added. This would be used instead of CXt_NULL when a sort BLOCK is
called. Like other sub-ish context types, it would have an old_cxsubix
field and PL_curstackinfo->si_cxsubix would point to it. This would
eliminate needing special-case handling in places like Perl_gimme_V().

Document vform

Document a bunch of foo_nocontext functions

These just refer to foo's pod, with an explanation of 'nocontext'

Change vwarn pod to be in terms of plain warn

run_multiple_progs: option to abort on first failure

Setting PERL_TEST_ABORT_FIRST_FAILURE to a true value
while running a test usinng run_multiple_progs stop
on the first failure.

This provides a mechanism to debug step by step
these tests.

On failure a hint to use PERL_TEST_ABORT_FIRST_FAILURE
is advertised.

run_multiple_progs: advertise file and line number on failures

This is helping identify test failures from run_multiple_progs
by providing the source file and line number.

run_multiple_progs: auto tag test when name is mising

When running a run_multiple_progs give each test a name
when missing.

Guard the change against running more than once

Why only comment what nobody sees, where it is easy to check it

perlvar: Remove PERL_VERSION... apidoc entries

This is no longer the place where these deprecated macros are considered
to be documented

toke.c: Use SvPV_shrink_to_cur

which is what it is doing, instead of the more general SvPV_renew.

Document re_dup_guts

Document SvOOK_off

Document SvVSTRING_mg

cop.h: Comments, white space

Document INTMAX_C, UINTMAX_C

Note that PERL_UINT_MIN is documented

Document PERL_USE_GCC_BRACE_GROUPS

Document PTR2foo

Document ibcmp_utf8, and move to like-fcns hdr

lib/Symbol.t: Exercise qualify_to_ref()

Symbol::qualify_to_ref() has not previously been exercised in this test
file.  Do so.  Also, exercise certain usages of qualify() that are
documented in SYNOPSIS but were also previously unexercised.

Bring test file into compliance with stricture.

Correct typo in 'die' message.

Document EXTERN_C macros

util.c: Comment fix-up

Merge Configure changes for z/OS and AIX

Thank you Karl!

Refactor rninstr()

This function finds a needle in a haystack.

If memrchr() is available, use it to find the final byte in the needle;
If the needle is length 1, that's all we need, and this is special
cased.  Otherwise it uses memEQ of the other bytes of the needle, from
where the needle would have to start, and if no match, repeats.

If no memrchr(), it emulates that by just looking backward from the end
until it finds the needle's final byte; then proceeds as above.

Add missing boundary check to grok_infnan

The grok_infnan() function was walking past the end of the string
while skipping over trailing '0' characters. This is another
variation of #17370.

Add Merijn's new email address to Porting/checkAUTHORS.pl

die_unwind(): global destruction

Fix #18063

During global destruction make sure we preserve
the string by using mortalcopy.

This is an update on 8c86f0238ecb5f32c2e7fba36e3edfdb54069068
change which avoided sv_mortalcopy in favor of sv_2mortal.

Make getverlist inside Configure strict/warnings safe and correctly sorted

Remove 5005threads vestiges from Configure and friends

See https://github.com/Perl/metaconfig/pull/66/

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

..and Porting/corelist.pl warns about it

add new Module::CoreList entries

canonicalize more committer names and emails

bump Module::CoreList version

Bump the perl version in various places for 5.33.2

new perldelta for 5.33.2

tick off 5.33.1 release

fix version in release announcement template

commit epigraph for 5.33.1 release

add new release to perlhist

finalize perldelta for 5.33.1

Update Module::CoreList for 5.33.1

perldelta: add missing =over/=item/=back around perldebguts entry

regcomp.c: Silence compiler warning

This commit goes back to using av_top_index to silence the
signed/unsigned comparison warning.  Other methods could have been used,
but the signed variable is actually used to fetch the array index, so I
decided to go this route.

fix broken perldelta links introduced in 5238875cf10

perldelta for 3134649473, 64ca16b728, fc5f3468dc, 89341f87f9, 8a2562bec7

Use av_top_index() instead of av_tindex()

I was never happy with this short form, and other people weren't either.
Now that most things are better expressed in terms of av_count, convert
the few remaining items that are clearer when referring to an index into
using the fully spelled out form

pp_ctl.c: Convert to use av_count()

Typemap.xs: Convert to use av_count()

mro.xs: Convert to use av_count()

APItest.xs: Convert to use av_count()

Hash-Util-FieldHash: Convert to use av_count()

pp.c: Convert to use av_count()

PERL_FILTER_EXISTS: Convert to use av_count()

os2.c: Convert to use av_count()

Porting/makerel: Add a create EBCDIC option

So that the .gz and .xz files can be unpacked on EBCDIC platforms
without any muss or fuss

perldelta: Add missing =item lines

Add entry for fixing #16529

pod/perldelta: Improve formatting for dual life modules

Add perldelta entry for perldebguts ${"_<$filename"} fix

See commit 6e764e36cf6a7c109e74ca4ccafbba27a0b422cd

perldelta: alphabetise document list

Note customized ExtUtils-Constant test

Commit 67b5e820b9462a832786fae47188b044c8fd42fb adjusted the test file
to avoid an indirect method call, but failed to update
Porting/Maintainers.pl and t/porting/customized.dat.

Remove obsolete custimized.dat entry for Pod-Usage test

Commit b9ab2ffe309876b1749351c4276565e2289c82ac updated Pod-Usage to
v1.70, which includes the test change, but failed to remove it from
t/porting/customized.dat.

Add perldetla entries for my_rpeep and range op

Changes for 39f7bd8a2f and f4941eebb5

Add perldelta entries for dual life modules

add new rjbs email

Add perldelta entry for Intel compiler detection fix

See commit 8ffcbbbe4a4411bb0971e61a39fa2608a4ef5145

perldelta: Note GH #18019 is fixed

perldelta: Note more doc changes

perldelta update for commit 3aa74965c0

whitespace fixes only

vms.c: Convert to use av_count()

universal.c: Convert to use av_count()

sv.c: Convert to use av_count()

regcomp.c: Convert to use av_count()

pp_sys.c: Convert to use av_count()

pp.h.c: Convert to use av_count()

perl.c: Convert to use av_count()

doio.c: Convert to use av_count()

pp_hot.c: Convert to use av_count()

Add av_count()

This returns the number of elements in an array in a clearly named
function.

av_top_index(), av_tindex() are clearly named, but are less than ideal,
and came about because no one back then thought of this one, until now
Paul Evans did.

perldelta: Plan9 and 9front i386

Relates: #17891

Add perldelta entry for Plan9 and 9front.