Win32: add lstat(), fetch st_dev and st_ino and fetch st_nlink for fstat

We need lstat() for various modules to work well with symlinks,
and the same modules often want to check for matches on the device
and inode number.

The values we're using for st_ino match those that the Python and Rust
libraries use, and Go uses the same volume and file index values for
testing if two stat objects refer to the same file.

They aren't entirely unique, given ReFS uses 128-bit file ids, but
the API used to check for this (GetFileInformationByHandleEx() for
FileIdInfo) is only available on server operating systems, so I can't
directly test it anyway.

Account for 'less' reserving an extra column

After decades of stability, the 'less' pager project decided to claim an
extra column for its own use when called with certain common options.

This commit changes some of the auto-generating tools to wrap one column
earlier to compensate, and changes podcheck to also whine on wide
verbatim text one column less.  But it changes the podcheck data base
to grandfather-in all the many existing places that exceed that amount.
That means only changes made to pods after this commit will be held to
the stricter value.

Of course, what this means is those pods will wrap or truncate in these
places on an 80 column window, making them harder to read, when used
with 'less' and when it is called with the options that reserve those
two columns.  Patches welcome.

I haven't seen the wrapping problem with perldoc, and haven't
investigated much.

Document various CopFILEfoo functions

opcode.h: Restrict scope of internal variables to core

Document SvSHARED_HASH

bump version of ExtUtils::ParseXS

restore compatibility with old versions of ExtUtils::ParseXS

ExtUtils::ParseXS used to include a function called "errors", which was
documented. In was renamed to report_error_count in version 3.01 (perl
5.15.1) although the documentation wasn't fixed until 3.21 (perl 5.19.2).
As a documented function, this is a backwards compatibility issue.

It is possible for this to lead to errors when installing modules from
CPAN. If you are using the version of ExtUtils::ParseXS that comes with
core, between running the Makefile.PL and make, fulfilling prereqs can
result in upgrading ExtUtils::ParseXS. When Makefile.PL is run, the
generated Makefile gets the full path to xsubpp saved in it. Then when
upgraded from CPAN, ExtUtils::ParseXS and xsubpp will be in a new
location (site_perl or a local::lib). Running make will run the old
xsubpp, but it will then try to use the new ExtUtils::ParseXS which has
broken compatibility.

Restore the errors function as a compatibility shim to fix this.

cop.h: Extend core-only portion

This encloses some #defines in a PERL_CORE section, as their only use is
in the macro immediately following, already confined to core.

INSTALL: Fix grammar/typos

perlapi: Consolidate svREFCNT_dec-ish entries

DynaLoader: use PerlEnv_getenv()

Doing so invokes thread-safe guards

op.h: Restrict to core certain internal symbols

so that they aren't accessible to XS code and won't be picked up by
autodoc

perlapi: Consolidate SvPVX-ish entries

Add -negative import args for 'use warnings'

perlapi: Consolidate SvREFCNT_INC-ish entries

add extra language in the quotemeta() docs for embedded \ and $

One paragraph was lifted from perlop.pod, and the other from perlre.pod.

perlvar - clarify that paragraph mode also discards a single leading newline

Avoid deadlock with PERL_MEM_LOG

This fixes GH #18341

The Perl wrapper for getenv() was changed in 5.32 to allocate memory to
squirrel safely away the result of the wrapped getenv() call.  It does
this while in a critical section so as to make sure another thread can't
interrupt it and destroy it.

Unfortunately, when Perl is compiled for debugging memory problems and
has PERL_MEM_LOG enabled, that allocation causes a recursive call to
getenv() for the purpose of checking an environment variable to see how
to log that allocation.  And hence it deadlocks trying to enter the
critical section.

There are various solutions.  One is to use or emulate a general semaphore
instead of a binary one.  This is effectively what
PL_lc_numeric_mutex_depth does for another mutex, and the code for that
could be used as a template.

But given that this is an extreme edge case which requires Perl to be
specially compiled to enable this feature which is used only for
debugging, a much simpler, if less safe if it were to ever be used in
production, solution should suffice.  Tony Cook suggested just avoiding
the wrapper for this particular purpose.

Add mutex locking for many-reader/1-writer

The mutex macros already in perl are sufficient to allow us to emulate
this type of locking, which may also be available natively, but I don't
think it is worth the effort to use the native calls.

locale.c: Move comment to better place

perlsub - indicate version requirement for "delete local"

perlapi: PL_sv_yes and kin are read-only

perlapi: Remove per-thread section; move to real scns

Instead of having a grab bag section of all interpreter variables, move
their documentation to the section that they actually fit under.

perlapi: Move PL_dowarn to Warnings section

perldelta updates for the SysV IPC changes

Various updates and fixes to some of the SysV IPC ops and their tests

io/shm.t: make runnable as ./perl io/shm.t

and give editors a hint

shmwrite: treat the string as bytes

msgrcv: properly downgrade the receive buffer

If the receive buffer started with SVf_UTF8 on, the received message
SV would stay flagged, corrupting the result.

msgsnd: handle an upgraded MSG parameter correctly

perlfunc/msgsnd: the supplied MSG doesn't have a length field

The length of the message is derived from the length of the MSG
less the size of the type field.

fix UTF-8 handling for semop()

As with semctl(), the UTF-8 flag on the passed in opstring was ignored,
which meant that the upgraded version of the same string would
cause an error.

Just use SvPVbyte().

io/sem.t: eliminate warnings

This eliminates some warnings that semctl() (or other *ctl()) calls
might generate, and some warnings specific to io/sem.t:

- for IPC_STAT and GETALL, the current value of ARG is overwritten
  so making an undefined value warning for it nonsensical, so don't
  use SvPV_force().

- for other calls, ARG is either ignored, or in a behaviour
  introduced in perl 3 (along with the ops), treats the supplied
  value as an integer which is then converted to a pointer.  Rather
  than warning on an undef value which is most likely to be ignored
  we treat the undef as zero without the usual warning.

- always pass a number for SEMNUM in the test code

I didn't try to eliminate warning for non-numeric/undefined SEMNUM,
since while we know it isn't used by SETALL, GETALL, IPC_STAT and
IPC_SET, it may or may not be used by system defined *ctl() operators
such as SEM_INFO and SHM_LOCK on Linux.

fixes #17926

*ctl: test that we throw on a code point above 0xff

These functions expect a packed structure of some point
representing bytes from the structure in memory.

*ctl: test we handle the buffer as bytes

Previously this had the "unicode bug", an upgraded string would
be treated as the encoding of that string, rather than the raw
bytes.

*ctl: ensure the ARG parameter's UTF-8 flag is reset

If the SV supplied as ARG had the SVf_UTF8 flag on it would be left
on, which would effectively corrupt the returned buffer.

Only tested with shmctl(), since the other *ctl() functions only have
more complex structures with indeterminate types that would require
more effort to test.

perl - update usage data to match perlrun

John Karr is now a perl author

fix typo in comp/parser.t

3 similar tests eval a sub with a list of variables, $r is repeated at the
end of the list, but the errors that are being checked have nothing to do with
the repeated variable. This causes a warning enabled.

comp/parser.t count two lines that were being tested to see if they crashed
parser as tests (PASS if the test file is still running after the lines).

bump $Carp::VERSION

fix context of caller call in Carp

Carp's CARP_NOT variable is meant to have package names. caller in list
context returns the calling file and line in addition to the package
name.

Enforce scalar context on the call to caller to fix this.

perlapi: Document UVf, as deprecated

perlapi: Note proper rplcemnt for pad_compname_type

add a brief introduction to the IO SV type

Confine scope of SV_CONST to core

as well as the constants it uses.  This is unused in cpan

Add a usage note about the "l" modifier.

win32: remove support for disabling USE_LARGE_FILES

It was enabled by default on all compilers. I don't think it ever
makes sense to disable it.

Restrict scope/Shorten some very long macro names

The names were intended to force people to not use them outside their
intended scopes.  But by restricting those scopes in the first place, we
don't need such unwieldy names

embed.fnc: Mark reginitcolors as Core only

This is used for internal initialization, and there are no uses on cpan

perlapi: Consolidate Sv{INU]VX-ish entries

Update gitignore files to reflect files in repo

fix splittree.pl ignore to only apply to root

There is a real splittree.pl in NetWare/, which may be copied to the
root. Ignore the file in the root, but not the file in NetWare/.

remove ignore for perlvms.pod, which is a real file now

move ignore for re into its own dists gitignore

move ignore for XS-APItest into dists own gitignore

remove ignore for Test-Harness directory which no longer exists

remove ignore for dl_win32.xs, since it is a real file now

add gitignore exclusions for files in git

There are a number of files excluded using gitignore rules that are
included in the repository. This can lead to confusion if something
other than git tries to read the ignore files.

Add rules to the gitignore files so that these files won't be ignored.

sv.h: Add comments

regcharclass.h: Simplify some expressions

The regen script was improperyly collapsing two-element ranges into two
separate elements, which caused extraneous code to be generated.

Slience compiler warnings for NV, [IU]V compare

These were occurring on FreeBSD smokes.

warning: implicit conversion from 'IV' (aka 'long') to 'double' changes value from 9223372036854775807 to 9223372036854775808 [-Wimplicit-int-float-conversion]

9223372036854775807 is IV_MAX.  What needed to be done here was to use
the NV containing IV_MAX+1, a value that already exists in perl.h

In other instances, simply casting to an NV before doing the comparison
with the NV was what was needed.

This fixes #18328

perlapi: Consolidate sv_vsetpvf-ish entries

perlapi: Consolidate sv_catpv-ish entries

Document dTHXa, dTHXoa

Document isGV_with_GP

Document NUM2PTR

or at least lead people to use something better

Mark despatch_signals as core only

sv.c: Add missing pod markup

The item referred to in a L<> is in perlapi, so should be marked as
internal to the same pod.

perlapi: Consolidate sv_vcatpvf-ish entries

perlapi: Consolidate sv_catpvf-ish entries

perlapi: Consolidate sv_setpvf-ish entries

perlapi: Consolidate sv_setpviv-ish entries

Note down all future releasers for this cycle

Various COPHH macros have a non-const parameter

The pod says these are const, but they won't compile if actually called
with one.

perlapi: Consolidate newSVsv-ish entries

perlapi: Consolidate sv_inc-ish entries

fix perlfaq version in perldelta

Fix documentation grammar

Replace "Frees the all the" with "Frees all the".  The original wording
was introduced in c2217cd33590ef654 and a4395ebabc8655115.

Prepare Module::CoreList for 5.33.5

Bump version to 5.33.5

Create new perldelta for 5.33.5

Post-release tasks for 5.33.4

5.33.4 today

Finalise perldelta for 5.33.4

Update Module::CoreList for 5.33.4

perldelta: Note ongoing perlapi work

Update ExtUtils-MakeMaker to CPAN version 7.56

  [DELTA]

7.56    Thu 19 Nov 19:57:05 GMT 2020

    No changes since v7.55_01

7.55_01 Wed 18 Nov 18:23:19 GMT 2020

    Bug fixes:
    - RT#133762 Explicitly print to STDOUT in EUMM.pm

perldelta: the FAQ was updated in 09e51a95

perldelta updates

Make API some C99 typedef work-arounds

I added these some releases ago, but kept them private.  No untoward
things have happened, so I'm now making them API.

re/fold_grind.pl: Test a couple more code points

These add tests for checking that the revised folding in a future commit
works in some edge cases that previously weren't an issue.

Update Pod-Simple to CPAN version 3.42

embed.fnc: Mark 3 sighandler fcns as Core only

These appear to be for internal use, with no cpan usage found

perlapi: Document memzero

Remove PERLIO_FUNCS_CONST

As the comment said, this was temporary until vtables got to be all
const

Move regcurly to regcomp.c (from inline.h)

This function is called only at compile time; experience has shown that
compile-time operations are not time-critical.  And future commits will
lengthen it, making it not practically inlinable anyway.

perlapi: Consolidate sv_catsv-ish entries

perlapi: Consolidate sv_catpvn-ish entries

Limit the number of lines in IRC notification