perlpodstyle: Add proper hyperlink

bisect-runner: Fix verbatim line length

This changes the indent to the minimum necessary to trigger pod verbatim
line handling.  Doing so stops the wrapping in this file.

README.os390: Add proper hyperlink

README.os2: Fix pod

Fix how links are displayed, add some links

README.irix: Fix overlong verbatim line

perldebguts: Fix grammar

Use a real word instead of slang.

Porting/todo.pod: Use L<> link, not F<>, for link

todo.pod: Use m// instead of //

This makes it slightly easier for readers to understand, and a lot
easier for podcheck.t to understand

RMG: Use hpyerlink

podcheck.t: Treat some additional files specially

metaconfig units and plain text files aren't pod.  And lines
like Perl/perl.git aren't going to be file names.

podcheck.t: White-space, comments, typos

This does some white space changes for readability, clarifies comments
and pod.

podcheck.t: Allow dash in argument names

In addition to being able to call this with --add_link, you can now
specify --add-link, depending on your preference.

podcheck.t: Set $| to 1

This causes the output to be flushed immediately.  Without this, some
options that tried to tell you that the operation would take a while to
complete would not have that message come out until it had in fact
completed.  The message should be displayed immediately.

Amiga-Exec/Exec.pm: Fix pod

This line has a syntax error in it.  Fix it, and split into two lines so
doesn't wrap on output in an 80 column terminal window

lib/perl5db.pl: Give proper pod links

These internal references are linkable

lib/perl5db.pl: Add some S<> to pod

I added these to surround some C<...> that have spaces so that the
output construct is guaranteed to be on a single line.  These are mostly
commands to type, and it is clearer to the reader if they kept together.
I didn't bother with things that were guaranteed to be at the beginning
of a line, as they won't wrap anyway.

inline.h: Fix typo in comment

[MERGE] Refactor regen/warnings.pl

The src for this tool was a mess: it started out 20 years ago as a small
utility, then grew. Lots of badly-named global variables, no code
comments about what subs do etc. This series of commits cleans things
up, refactors, adds comments etc. In theory it makes no functional
changes, and indeed as run currently it generates exactly the same
warnings.h and lib/warning.pm files as before.

regen/warnings.pl: rename $tre to $tree

Since the global variable $tree was renamed $TREE, we can now rename all
the instances of a sub parameter $tre to '$tree'.

regen/warnings.pl: add comments about $TREE

Explain this structure, which is the input used to define all the
warnings.

regen/warnings.pl: rename filehandle variables

rename my($warn, $pm) to ($warn_h, $warn_pm) to make it easier to
see that they're the filehandles for warnings.h and warnings.pm

regen/warnings.pl: better comment what the subs do

regen/warnings.pl: eliminate broken dup check

valueWalk() checks for a duplicate warnings name. However,
1) This is also done in walk(), so is redundant.
2) It is broken. Originally it declared @list but checked %list;
%list is global and was renamed to %CATEGORIES to make it clear it was a
global (and thus unrelated to @list). So its probably never worked.

regen/warnings.pl: eliminate global %v_list var

This lexical had global scope. Instead, make it a parameter to
sub valueWalk(), since it's only used temporarily by two subs.

regen/warnings.pl: eliminate lexical var %Value

This doesn't seem to be used any more

regen/warnings.pl: uppercase 'global' lexical vars

various lexical vars like $tree, $def are populated early on, then their
values are used later in many places, including directly in subs.

Rename these vars to be uppercase and with more meaningful names, to
emphasise their globalness.

(Ideally they really ought to be local and passed as arguments to all
the subs that use them, but that's more work.)

regen/warnings.pl: remove a block scope

A block of code no longer declares any lexical variables, so remove the
block. Apart from removing a '{' and '}', this is a whitespace-only
change.

regen/warnings.pl: remove unused lexical variable

$offset was added in 2000, but hasn't actually been used for a long while

regen/warnings.pl: move boilerplate text to end

Move a couple of large chunks of <<'EOF' code text to the end of the file
(but before __END__) to make the flow of code easier to see.

The output generated is unchanged.

Bump IO to 1.50 after production release to CPAN

perlapi: Consolidate (Copy|Move|Zero)D?

This commit consolidates the D form of each function in perlapi with the
plain form.

autodoc.pl: Rmv redundant text

When different functions are grouped together in a single entry, some or
all of them may be deprecated or experimental.  Prior to this commit
each such was listed individually as a separate paragraph.  It is
shorter to say "All forms" if all are of the same ilk, or list just the
individual ones in a single sentence, otherwise.

autodoc.pl: Allow 'x' flag in apidoc_item entries

The only flags allowed are those affecting the display in perlapi and
perlintern.  The 'x' flag previously omitted, fits this.

autodoc: Don't require space after =apidoc_item

The flags column is optional, and so no space is needed to delimit it.

embed.fnc: Add, clarify comments

perlapi: Consolidate load_module(_nocontext)?

autodoc.pl: Include thread context in arg calculation

When several different functions are grouped together into one entry,
only the signature of the first one is output provided that all have the
same signature (except for the function name).

Until this commit, whether or not there was a hidden thread context
parameter was not considered in this calculation.  This could lead to
confusion.

autodoc.pl: Clarify comment

perlapio: Nits

autodoc.pl: perlxs items default to XS section

perlapi: Fix misspelling

autodoc.pl: A source is perlxs.pod

This was meant to be looked at, but wasn't.  It's skipping cpan, dist,
and ext, which it really should be, because we don't have much control
over those.

The comments indicated it expected to get generated files from
lib/ instead, but those wouldn't be in MANIFEST, so weren't getting
looked at.  And it's not a good idea to look for them anyway, as one
could get relicts.  Instead create an exception list of pods that could
have API elements that are documented.

The only current file on that list is what becomes lib/perlxs.pod

Document CvDEPTH

perlapi: Consolidate entries for Perlio functions

Group all these together to make for a more compact and clear
representation.

Sort PerlIO entries in pod, embed.fnc

This has no effect on any code or pod display, but makes it easier to
find them for maintenance, and makes the next commit have a smaller
difference listing

Maintainers.pl: comment customized removal criteria

Document PERLIO_FUNCS_(DECL|CAST)

update const sub docs for stuff that now croaks

GH #19664

Some types of constant sub candidates emitted deprecation warnings
from 5.22 onwards, and croaked from 5.32 onwards. The perlsub docs knew
about the warnings; this commit updates them for the croaks.

At the same time, change the code examples to no longer use the RT
ticket number of the original issue. For one thing, RT numbers are
obsolete, and for another, it was being too cute - setting a variable to
one less than the RT number, then showing that the constant value
hadn't been incremented by the $x++. And using the number for the sub
names. The examples just became noisy with random 5-digit numbers
everywhere.

lib/experimental.pm is no longer customized

perlapi: Document SvPVXtrue

Note various symbols are documented in perlhacktips

perlapi: Rmv duplicate entries

These entries that are minor variants of each other were consolidated
into one over-arching entry, but the individual ones were inadvertently
retained, leading to duplicate information.

perlembed: Note various symbols are documented here

Put back the words about no VERSION not undoing feature bundles, which got lost in the earlier reärrangement

Use signatures in perlunicook example

use signature in perlthrtut to further tidy the example, while we're there anyway

Point directly to L<...|perlfunc/use VERSION> when mentioning the syntax in other docs

Replace 'use strict; use warnings;' with 'use VERSION' in docs code examples

Replace docs examples of 'use NUMBER' with proper v-strings

More wording in perldsc.pod about 'use VERSION'

Point out that 'indirect' is only availble before 'use v5.36'

Add some wording about 'use VERSION' to perlstyle.pod

Mention that 'use VERSION' enables strict + warnings + others in perlintro.pod

Split docs for 'use VERSION' into its own section of perlfunc.pod

Also add more wording

regcomp.c - silence build warning under NO_TAINT_SUPPORT

The variable 'oldtainted' is unused when NO_TAINT_SUPPORT is defined.
This patch ifdefs it out of the compiled code.

This should resolve GH Issue #19654
See: https://github.com/Perl/perl5/issues/19654

Revert "Porting/makerel Make EBCDIC files writable"

This reverts commit ecef3a65d2c34ab6acbc8d1e8e17f5f41e307729.

This commit stems from an earlier mechanism for creating EBCDIC
releases, but no longer makes sense, leaving all files user-writable.
The intent was to do so just on EBCDIC builds, as at one time all files
were translated into EBCDIC on the destination box.  But nowadays, the
translation is done in makerel itself, before the creation of the tar.

After this commit, files are read-only except for those on the internal
exception list.

Spotted by Steve Hay.

regen/mph.pl - make sure the author of _squeeze() has a commit in the log

This commit is actually by the committer, and is intended to ensure that
someone looking for what the author wrote can find it. It took me a while
to get a email address for him or I would have done this in eda35008b17e739922
which is where his work on the _squeeze() split key algorithm was added.
Credit where credit is due and all of that. Thanks Ilya.

Fix SHA256 digests produced by Porting/makerel on Windows

Prepare Module-CoreList for 5.35.12

Bump version for 5.35.12

New perldelta for 5.35.12

Tick off release

Add epigraph for 5.35.11

epigraphs.pod: Correct 5.35.10 version and add link

5.35.11 today

Finalize perldelta

Update Module-CoreList for 5.35.11

perldelta - Update for 5.35.11

Fix typos in perlfunc

skip 2 tests if built with DEBUGGING and no taint support

fixed typo in taint_support comments, shoulda been "with" not "without"

Fix Porting\updateAUTHORS.pl to not output CRLFs on Windows

Add/correct/delete notes of CUSTOMIZED files in blead

Added perldelta entry on support for building a taint-free perl

Doc changes to reflect that perl might not support taint

The central doc change is in perlsec.pod. This not only explains
that you can build a perl that doesn't support taint,
but shows how you can check whether your perl supports taint or not.
The other doc changes are mainly to note that taint might not
be supported, and to refer the reader to perlsec for more details.

changes to core module tests to handle perl that doesn't support taint

changes to perl tests to handle perl without taint support

Add Configure question for taint support

This adds a Configure question for whether you want taint support.
It defaults to "yes", so that ./Configure -des will build a perl
which supports taint in the usual way.
If you say "no", then perl is compiled with -DSILENT_NO_TAINT_SUPPORT
so that taint features silently do nothing.

I've submitted a separate pull request on perl/metaconfig,
which adds the underlying metaconfig unit for this question,
which was used to build this Configure script.

Revert "dist/PathTools - add missing entries to Changes"

This reverts commit 33349b53c2e4df3292c79435e54fc98824e4cba8.

This should have been pushed to a branch not to blead. Fat fingers.
Sorry folks.

Revert "mg.c, Cwd.pm - Empty path is the same as "." which is forbidden under taint"

This reverts commit 5ede4453c4877110eb5214ff400c173210b101b1.

I messed up and pushed it to blead not to the PR branch I meant to push
it. Thanks to xenu for noticing. This needs a smoke before it should be
applied.

Normalize: Use ppport.h

This commit changes Unicode::Normalize to use ppport.h.

All modules that convert from UTF-8 should be using the latest ppport.h,
so that they get the latest security checking available, which ppport.h
backports to 6.1.

This commit converts the module to use the utf8_to_uvchr_buf() method of
translation from UTF-8, instead of a method that allows one to pass
flags as to what code points to not accept.  Since the flags parameter
it was passing was zero, this is equivalent to utf8_to_uvchr_buf().

Socket: getnameinfo() behaves differently on z/OS

POSIX says at least one of the parameters must be non-NULL.  z/OS
requires both to be.

It would be better to have a Configure probe for this, but this is the
first non-conforming OS we have found, and at this stage, there aren't
likely to be any others that Perl might eventually be ported to.  Should
some come along, a probe could be added at that time.

libnet: os390 isn't necessarily EBCDIC

It turns out that z/OS (the new name for os390) can run in ASCII mode.
Therefore the test for EBCDIC must not be based on the OS itself, but
the character set in use.

podlators: Fixes for EBCDIC

podlators: z/OS isn't necessarily EBCDIC

(nor is EBCDIC necessarily z/OS).  Fix conditional

handy.h: space isn't graph

hints/os390.sh: #define os390

This OS has some unique qualities that are hard to test for in
Configure, and aren't likely to go away.

mg.c, Cwd.pm - Empty path is the same as "." which is forbidden under taint

Having a relative path, including ".", is forbidden under taint. On *nix
an empty PATH or an empty PATH component is equivalent to a PATH of ".",
so they should be forbidden as well.

Note that on Windows the current working directory is ALWAYS checked
first if you try to execute something that does not specify its path,
regardless of the PATH.

I do not know what happens on VMS and I do not have access to a
VMS environment to test. There are totally different codepaths for
VMS as well. This patch does not (or rather should not) change
behavior for VMS.

Note this includes a version bump for all modules in dist/PathTools

dist/PathTools - add missing entries to Changes

Versions 3.82 through 3.84 were not document in Changes.

mg.c - move const initialization out of loop

The path_sep is not going to change per iteration of the loop, so just
move it out of the loop.