perldelta: Clarified perlhack entry

perldelta: Reordered split() so most important is 1st

perldelta: Clarify seek() entry

perldelta: Move dtrace ticket number

I believe this makes it clearer that it applies to all the fixes in the
list

perldelta: Remove duplicate entry

This is an exact copy of another entry for [perl #129090]

pod/perldelta: Reword #129903 description

I looked at the ticket to understand better how to clarify this.

pod/perldelta: Reword #130010 description

I looked at the commits and ticket to clarify this

perldelta: Add missing =item

perldelta: Nit fixes

This has what I believe are non-controversial changes, missing or extra
words, typos and punctuation, plus a couple of clarifications and
cautions.

perldelta: Standardize on ticket #'s being at ends

Bug fixes are hereby standardized so the ticket number appears at the
end of the entry, instead of some being at the beginning.

podcheck: Module::Signatures is known correct.

perldelta: Add pod formatting codes

This adds mostly C<>, but some F<>, B<>, I<> as well.  Fixed an S<> to
C<>

perldelta: Fix overlooked C<.>

This is turned into C<".">.  It should have been done as part of
df48f9a40b9a0dd18a1e55dffe80ba98b5e5a99c

perldelta: Fix link displays

This fixes the displays of some links.  Most of this fix is
that one shouldn't say

C<L<foo/bar>>

This is because it translates to 'bar in foo' entirely in the
fixed-width font.  And 'in foo' shouldn't be in fixed width.  (I will
bring this up to see if Pod::Simple should change, or it should be
flagged by Pod::Checker.)

Instead one should currently write

L<C<bar>|foo/bar>

perldelta: Standardize references to Perl

There is a mixture of saying Perl "5.foo" and "v5.foo".  This
standardizes to the two most common variants.  When the word "Perl"
precedes the version number, the "v" is omitted.  Perl is capitalized.
When the number stands alone, the "v" is added.

However, the NAME section must say 'perl v5.26.0' as that form is
expected from Porting/pod_lib.pl

Fix various POD issues

Correct POD formating error detected by t/porting/podcheck.t.

The text in the link lacked the open- and close-double quotes found in the
section head being linked to.

perldelta: Note new test scripts

I went through the commits since 5.24.1, and found these added scripts
that were missing from perldelta.  This entailed rewriting the existing
entry on APItest, as a bunch of test files were split.

perldelta: Fix some single char C< >

Some characters that should have been in C< > weren't.

Single character C< > should instead be C<" "> (where the space is any
character).  This is how they are displayed anyway in non-gui devices,
and in gui, the single character really doesn't stand out as distinct,
whereas longer strings tend to.  Though, I did add quotes around the
range operator "..", as that wasnt very distinct without them.

I removed the C<> from C<1>, as the 1 is a generic value.

perldelta: Collapse "Removed Deprecations"

I just added this section in 1f81bc188d3574dfda690659ebeed2bdc92a42d6,
but on further contemplation, I think it makes more sense to just have
the "Deprecations" section deal with anything regarding deprecations.
It is short, and undeprecating something is rare, and I have revised the
entry so it makes sense being in the plain "Deprecations" section.

perldelta: tweak SV flags; eliminate hv_fetchs

Expand the section on SV flags: they have been eliminated rather than just
changed.

And remove this entry:

    Change C<hv_fetch(…, "…", …, …)> to C<hv_fetchs(…, "…", …)>

    The dual-life dists all use Devel::PPPort, so they can use this
    function even though it was only added in 5.10.

which appears to be just an implementation detail.

perldelta: expand Unicode/utf8 API changes

Move all the Unicode/utf8 API changes into a separate bulleted
sub-section, and add mentions of every macro/function added to the API.
Previously there was just a vague "Several macros and functions have been
added to the public API" without enumerating them.

perldelta: sort the "Internal Changes" section.

Group entries that have similar themes such as unicode API or optree

No changes apart from cut-n-paste of whole =item entries.

perldelta: move an entry from Internal to Bug Fixes

perldelta: remove some "Internal Changes" entries

In general we don't list internals changes unless it affects the API or is
very visible (e.g. performance enhancement). So I've deleted the following
entries:

    Several new internal C macros have been added that take a string
    literal as arguments, alongside existing routines that take the
    equivalent value as two ...

AFAKT, this is referring to:

    strEQs() and strNEs()
    _memEQs() and _memNEs

which aren't listed as part of the API, so we don't (yet?) want to
advertise them.

    The code in F<gv.c> that determines whether a variable has a special
    meaning to Perl has been simplified.

which is great, but isn't visible AFAIKT.

    Use C<my_strlcat()> in C<locale.c>.  While C<strcat()> is safe in this
    context, some compilers were optimizing this to C<strcpy()> causing a
    porting test to fail that looks for unsafe code.  Rather than fighting
    this, we just use C<my_strlcat()> instead.

Perhaps this should be reported as bug fix instead?

perldelta: re-order "Core Enhancements" entries

... based subjectively on importance. I've put new language features
first, followed by unicodey-stuff.

There have been no edits - purely cut-n-pasting an entire entry as-is to a
new location.

perldelta: fix some issues raised by Karl

moved utf8_hop_safe() to Internals;

removed
    A regression from the previous development release, 5.23.3, where
    compiling a regular expression could crash the interpreter has been
    fixed. [perl #128686].

since that was a typo - it was 5.25.3, and since the bug appeared, and was
fixed in, the same development branch, doesn't need mentioning.

perldelta: Fix some issues raised by Ævar

See http://nntp.perl.org/group/perl.perl5.porters/244357

perldelta: update @INC blurb in Notice

The original text got mangled when applied; I've readded the missing
sentence, and reworded things slightly to be a more informative initial
mention of what the issue is (like mentioning that the change is for
security reasons).

This should hopefully cover anything that was missed in the text removed
by 2c4393cceb72ac358b.

Time-HiRes: fix a do/@INC issue in Makefile.PL

The code assumed that File::Spec->catfile(".", ...) would create a
"./" prefix in the pathname that is fed to do(), but it turns out
catfile() doesn't work like that.

This didn't affect perl builds since Makefile.PL is normally run by
miniperl, which *does* have '.' in @INC. But it you tried to build
Time-HiRes manually, it would fail.

[ This commit is half of a diff proposed by James E Keenan - I decided the
File::Spec part  could wait till after 5.26.0 ]

perldelta: Add a C<> formatting code.

perldelta: Cleanup documentation changes section

I looked at all the files in /pod for their changes since 5.24.  I think
this action should be added to the RMG.  I removed the changes that are
described elswhere in perldelta, adding boiler plate to that effect.
I removed the changes I thought would not be useful for someone reading
this, but added significant numbers of substantive changes that had been
omitted.

perldelta: Add a section for undeprecations

and populate it.

perldelta: Note that utf8_hop_safe is for XS code

I actually don't think this should be here.  I think it should be in
Internal Changes.  Note that there were a bunch more functions added
for XS code, and these are there.  Perhaps there should be some separate
sections there, with one for enhancements.

perldelta: remove the @INC blurb I added

Remove the @INC blurb I added in commit 90ed3b64f9 ("perldelta:
clarify what '.' and @INC is about", 2017-05-16).

I wrote this independently before seeing the RT bug that had a much
more complete overview, which I applied in commit 89853d76c8 ("Add
more extensive information about @INC changes into
perldelta (RT#131304)", 2017-05-17).

As a result we now have this section, and then right below it another
section authored by Dominic Hargreaves.

This needs to be resolved before release. As noted in 89853d76c8 some
things could arguably be salvaged from my section as it's more brief,
but I can't think of a good way to rewrite this, so just remove it.

More perldelta tweaks.

Streamline or omit some of the VMS changes.  No need to mention
minor test refactorings or other tiny bits of work product that
don't represent notable user-visible changes from 5.24.  And fix
one comma splice in the OS X section.

perldelta: Note that part of perlre was rewritten

perldelta: Fix wording about literal "{"

This clarifies the wording and corrects the various messages raised
about it.

perldelta: Nits

This adds missing words, links, space, and format controls

perldelta: Make version numbers more consistent

This removes unnecessary .0 from version numbers, and removes the intial
'v' for those following the word 'Perl'

perldelta: tweaks to obituaries

perldelta: Use two spaces after sentences.

perldelta: Various nits.

Treat e.g. and i.e. Uniformly;
add some missing words;
spelling, commas, dashes.

perldelta: don't dollar-quote an env variable like $ENV, should be ENV

The way it was before made it appear that perhaps we meant a Perl
variable.

perldelta: This file is for 5.26, not 5.24

perldelta: Rmv entry that applies just to a devel release

This is not applicable to someone upgrading from any prior stable
release.

perldelta: Don't mention development release numbers

We have agreed in previous years that this is distracting detail to
someone reading the stable release notes.

There is still one left, but I ran out of time tonight to figure out
what to say.

perldelta: Add unescaped "{" to Notice

On irc, we agreed that this is important enough to be highighted there.

perldelta: Move some alleged 'enhancements' to 'incompatible changes'

I reordered the latter section so the most important things in my view
were earlier in it.

I also extensively reworded the unescaped { section to hopefully better
explain it.

I think the enhancements section should be reordered by importance.  For
example I don't think /xx is the most important enhancement in 5.26.
But I'll let others decide.

perldelta: Improve wording about Unicode scx property

perldelta: Move section adjacent to similar one

These two sections about @INC and dot need to be combined into one,
and should be in Security.

I'll let someone else take a stab at that.

perldelta: Remove duplicate entry

Fix another perldelta link

Fix perldelta link

Remove documentation of 5.25.4 fix in 5.26.0 delta

Fix git conflict indicator

Extra commas

Add more extensive information about @INC changes into perldelta (RT#131304)

This mainly takes existing text written by Dave Mitchell, Kent Fredric,
Sawyer X and James E Keenan.

[Ævar: I applied this from RT #131304. It had conflicts which I
resolved to the best of my ability.

The submitted patch removed the "'.' and @INC" section which I rewrote
in 90ed3b64f9 ("perldelta: clarify what '.' and @INC is about",
2017-05-16). I resolved the conflict to keep it.

Maybe this was the wrong move. We're now mentioning the removal of "."
in 3 prominent places, at the top in "Notice", "Core Enhancements",
and "Security".

Maybe the best move here is to remove the section I wrote, although as
noted in my commit I think one redeeming factor it if is the plain
language describing the change (i.e. not assuming knowledge of
variables like @INC right off the bat), but obviously I'm biased
there].

perldelta: Fix broken link

perldelta: clarify what '.' and @INC is about

The existing section we had here was totally misleading. I couldn't
understand "now provides a way to build" and "if you want it turn X
on" differently than meaning that '.' was still in @INC by default and
you had to compile perl with some optional switch to turn it on.

It turns out[1] that the exact opposite of that is the case. This is
on by default. Rewrite the entire section to make that clear to the
reader.

While I'm at it dumb it down a bit to be understandable to someone
who's just upgrading Perl. Not everyone knows what @INC is offhand,
but describing how we now load libraries is understandable to
everyone.

Then cover PERL_USE_UNSAFE_INC=1 and how it's set by various toolchain
modules now, and finally avoid talking about both
DEFAULT_INC_EXCLUDES_DOT and -Ddefault_inc_excludes_dot in the context
of a build option, just consistently mention only
-Ddefault_inc_excludes_dot.

We could go into much more detail here. See the "[RFC] We need prose
for perl526delta about "." in @INC removal" thread[2]. I think
including something like that probably makes sense later in the
document, but this should suffice for an intro section, and I'll let
others who proposed more detailed updates send their own patches for
further clarifying this feature.

1. "Re: Perl 5.26.0-RC1 is now
   available!" (<CAATnKFABh0PjQK0WLqC-MTugj==O22zjwRgDapfb1EHvLr0tKw@mail.gmail.com>"
2. <CAATnKFCSeGh6Lcwux1CsGP=6pQSQtG7_bViZRGji3Soa5b=1ow@mail.gmail.com>
   (http://www.nntp.perl.org/group/perl.perl5.porters/2017/03/msg243763.html)

perldelta: clarify how undeffing HV/AV is faster now

There were better notes in the change that introduced this[1]. Copy
the performance numbers from there, and say "arrays and
hashes". instead of "AV and HV". Better to use the more familiar names
than the internal struct names which are mostly only familiar to core
devs.

1. be98855787 ("speed up AV and HV clearing/undeffing", 2016-10-26)

perldelta: clarify what these new capture variables are for

[Ævar: I originally had a worse patch for this, but Yves had a better
one to fixup into mine. See "Re: Perl 5.26.0-RC1 is now available!"[1]
on list for context.].

1. <CANgJU+Uh0Kg_fS=3Ux5WvZtskOcOQT2Gjvy8tgYHjCTd0-d90Q@mail.gmail.com>

perldelta: move the note about utf8_hop() to the bottom

A note about a relatively obscure internal API function really doesn't
belong so high up in the "Core Enhancements", before core visible user
changes.

Move this to the bottom, all of the other things in this section are
things normal Perl programmers might actually use/encounter/care
about, whereas this change is only relevant for some XS maintainers.

perldelta: remove "maybe this won't be in 5.26" note about PERL_USE_UNSAFE_INC

This was originally added in commit 8bbdbfcb89 ("Perldelta updates in
prep for tomorrows release", 2016-11-19), we're now at RC1 so it's
pretty clear that this will be in the release.

perldelta: mention when lexical_subs were introduced

Doesn't take up much space, and makes you aware that if you e.g. are
using 5.18 already you can now use this in all your code without fear.

perldelta: 'for slightly more detail' -> 'for more details'

There's no need to inject "slightly" there, that documentation section
looks pretty complete to me.

perldelta: grammar fix: "[process] do not function well" -> "does not ..."

fixed couple of compilation failures with g++ (JHI)

Restore _test make target

Fix META.json

Add epigraph

Merge branch 'release/5.26.0-RC1' into blead

disarm RCnnn bump

Regenerate last-second acknowledgements

Add missing commas to perlfunc

perldeprecation: Add imminent XS deprecations

The deprecated XS functions that have been scheduled to be removed did
not make it into this pod.

Add missing commas to perlfunc

perldeprecation: Add imminent XS deprecations

The deprecated XS functions that have been scheduled to be removed did
not make it into this pod.

Update META files

bump version to RCnnn

add new release to perlhist

Fix link

Pod fixes

Finalize perldelta with acknowledgements and updated modules

avoid a memory wrap in sv_vcatpvfn_flags()

RT #131260

When calculating the new size of PL_efloatbuf, avoid wrapping 'need'.

reorder

Correct links

Sorted with cool trickery help by arc

Manually replace 52513 with 5260 perldelta filename

For now it's just perldelta.pod

Cleanups

Reorder section

Merge perl52512delta.pod

Merge perl52511delta.pod

Merge perl52510delta.pod

Merge perl5259delta.pod

Merge perl5258delta.pod

Merge perl5257delta.pod

Merge perl5256delta.pod

Merge perl5255delta.pod