perldelta: remove mention of comp.lang.perl.misc

perldelta: move an entry from 'Errata'

'Errata From Previous Releases' contained a fix from 5.25.1 only reported
in perl5253delta. This still counts as fixed in the current release from
5.26.0's viewpoint.

perldelta: remove 'Known Problems' section.

All the entries in it appear to be copied from perl5250delta.pod and are
likely no longer relevant.

perldelta: davem's 2nd half proofreading

From "Utility Changes" to "Selected Bug Fixes" inclusive

A lot of the bug fix descriptions were very opaque - often just the subject
line from a commit message.

epigraphs.pod: Adding announcement email link

regenerate META

Update epigraph, link forthcoming

disarm RCnnn bump

Update perlhist

perldelta: fix some POD

Update META files

bump version to RCnnn

add new release to perlhist

Remove the leading dot in the file name from the do example so it does not confuse readers

perldelta: add extra changed diag entry

Thanks to Ilmari for the correct pod escape voodoo.

perldelta: Diagnostics fixups

I did a diff of the 5.24.0 and current perldiag.pod's
and used it to fix up the new/changed diagnostics sections.

In particular: for changed diagnostics, I added a short description of
*what* had changed. I also moved some entries between sections, deduped,
added missing entries etc.

more perldelta fixups.

This is my reading from the start of the file through to the start of
=head1 Documentation

* the new 'do' warning isn't mandatory (but merely enabled by default)

* make it clear that the -Di cmd-line switch is new

* remove some optimisations that are trivial or not really optimisations.

* For modules, remove descriptions of bug fixes which are obscure/trivial

* I don't know how the "Compatibility with 5.8 has been restored" text
for threads came about - it was added in the 5.25.1 perldelta, but no
commits around that time seem to support this. So I removed it.

* a few typos etc

* I also added an Internals entry for OP_SPLIT/OP_PUSHRE.

perldelta: Add missing messages to list

I went through perldiag, and copied over links to these messages that
had failed to get placed into perldelta.

perldelta: Convert warning to standard form

It turns out that this message isn't a generic one, but quite specific,
so convert to that and move to sorted position in list.

perldelta: Sort new warnings section

alphabetically, after having standardized the entry format

perldelta: Add 2 blank lines

for readability.

perldelta: Sort new errors section

alphabetically, after having made the entries uniform.

perldelta: move the description of 128095 where it belongs

perldelta: the :utf8 handle warning is now on by default

perldelta: re-word the entry for 130335

perldelta: Make links to ticket numbers

Spotted by Tony Cook.

I did not verify that all these links work; if there was already a typo
in the ticket number, the link will fail.

perldelta: Use '#' for ticket number

Tony Cook spotted that we sometimes say [perl 000] and sometimes
[perl #000].  Make them consistent.

perldelta: Provide a reference to new feature

This pod discusses the new experimental feature listed in the
diagnostics section.  Refer to that.

perldelta: Provide links for changed diagnostics

perldelta.pod: Move diagnostic in file

This description applies to multiple diagnostics.  Move it to the area
where others like it are.

perldelta: Move some bug fixes to proper section

Somehow these ended up under changed diagnostics, though one could argue
they kinda sorta might belong under diagnostics.

perldelta: Fix up "Experimental %s on scalar" msg

This is changed to the format of the other entries that describe a
single message, and moved to the list of those, sorted alphabetically.

perldelta: Collapse :utf8 handle entries

There were two entries dealing with this.

perldelta: Add some C<>

These were overlooked in earlier commits

perldelta: Rmv duplicate entry

perldelta: It was perlmod that changed

Not perlmodinstall

perldelta: Fix link.

Spotted by Dan Book

perldelta: Add link for more expanation

The link explains unescaped "{" more.

perldelta: Clarify -Di switch entry

I didn't understand this, and looked at the actual commits to figure it
out.

perldelta: Add missing links

All API functions mentioned as new are now linked to, as well as various
other things that should be linked to.

perldelta: Rmv entry that applied only to 5.25 dev release

perldelta: Clarify entry for [perl #129106]

perldelta: Clarify a utf8 decode entry

This clarifies that the changes listed here apply to several of the
decode function variants, not just one.

perldelta: Clarify about when isFOO_utf8 now die

perldelta: perlop changes

This adds a new item, and clarifies the existing one

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