This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perl5.git
4 years agoUpdate epigraph, link forthcoming
Sawyer X [Wed, 24 May 2017 00:49:13 +0000 (02:49 +0200)]
Update epigraph, link forthcoming

4 years agodisarm RCnnn bump
Sawyer X [Tue, 23 May 2017 23:25:35 +0000 (01:25 +0200)]
disarm RCnnn bump

4 years agoUpdate perlhist v5.26.0-RC2
Sawyer X [Tue, 23 May 2017 19:52:20 +0000 (21:52 +0200)]
Update perlhist

4 years agoperldelta: fix some POD
Sawyer X [Tue, 23 May 2017 19:32:47 +0000 (21:32 +0200)]
perldelta: fix some POD

4 years agoUpdate META files
Sawyer X [Mon, 22 May 2017 21:19:48 +0000 (23:19 +0200)]
Update META files

4 years agobump version to RCnnn
Sawyer X [Mon, 22 May 2017 21:19:36 +0000 (23:19 +0200)]
bump version to RCnnn

4 years agoadd new release to perlhist
Sawyer X [Mon, 22 May 2017 21:16:25 +0000 (23:16 +0200)]
add new release to perlhist

4 years agoRemove the leading dot in the file name from the do example so it does not confuse...
Todd Rinaldo [Tue, 23 May 2017 14:48:00 +0000 (09:48 -0500)]
Remove the leading dot in the file name from the do example so it does not confuse readers

4 years agoperldelta: add extra changed diag entry
David Mitchell [Tue, 23 May 2017 16:43:18 +0000 (17:43 +0100)]
perldelta: add extra changed diag entry

Thanks to Ilmari for the correct pod escape voodoo.

4 years agoperldelta: Diagnostics fixups
David Mitchell [Tue, 23 May 2017 15:41:20 +0000 (16:41 +0100)]
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.

4 years agomore perldelta fixups.
David Mitchell [Tue, 23 May 2017 10:35:34 +0000 (11:35 +0100)]
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.

4 years agoperldelta: Add missing messages to list
Karl Williamson [Tue, 23 May 2017 07:05:13 +0000 (01:05 -0600)]
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.

4 years agoperldelta: Convert warning to standard form
Karl Williamson [Tue, 23 May 2017 07:03:02 +0000 (01:03 -0600)]
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.

4 years agoperldelta: Sort new warnings section
Karl Williamson [Tue, 23 May 2017 05:57:09 +0000 (23:57 -0600)]
perldelta: Sort new warnings section

alphabetically, after having standardized the entry format

4 years agoperldelta: Add 2 blank lines
Karl Williamson [Tue, 23 May 2017 05:56:24 +0000 (23:56 -0600)]
perldelta: Add 2 blank lines

for readability.

4 years agoperldelta: Sort new errors section
Karl Williamson [Tue, 23 May 2017 05:47:52 +0000 (23:47 -0600)]
perldelta: Sort new errors section

alphabetically, after having made the entries uniform.

4 years agoperldelta: move the description of 128095 where it belongs
Tony Cook [Tue, 23 May 2017 05:47:44 +0000 (15:47 +1000)]
perldelta: move the description of 128095 where it belongs

4 years agoperldelta: the :utf8 handle warning is now on by default
Tony Cook [Tue, 23 May 2017 05:46:27 +0000 (15:46 +1000)]
perldelta: the :utf8 handle warning is now on by default

4 years agoperldelta: re-word the entry for 130335
Tony Cook [Tue, 23 May 2017 05:43:04 +0000 (15:43 +1000)]
perldelta: re-word the entry for 130335

4 years agoperldelta: Make links to ticket numbers
Karl Williamson [Tue, 23 May 2017 05:23:44 +0000 (23:23 -0600)]
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.

4 years agoperldelta: Use '#' for ticket number
Karl Williamson [Tue, 23 May 2017 05:09:17 +0000 (23:09 -0600)]
perldelta: Use '#' for ticket number

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

4 years agoperldelta: Provide a reference to new feature
Karl Williamson [Tue, 23 May 2017 05:04:13 +0000 (23:04 -0600)]
perldelta: Provide a reference to new feature

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

4 years agoperldelta: Provide links for changed diagnostics
Karl Williamson [Tue, 23 May 2017 04:58:55 +0000 (22:58 -0600)]
perldelta: Provide links for changed diagnostics

4 years agoperldelta.pod: Move diagnostic in file
Karl Williamson [Tue, 23 May 2017 04:47:13 +0000 (22:47 -0600)]
perldelta.pod: Move diagnostic in file

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

4 years agoperldelta: Move some bug fixes to proper section
Karl Williamson [Tue, 23 May 2017 04:33:15 +0000 (22:33 -0600)]
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.

4 years agoperldelta: Fix up "Experimental %s on scalar" msg
Karl Williamson [Tue, 23 May 2017 04:27:26 +0000 (22:27 -0600)]
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.

4 years agoperldelta: Collapse :utf8 handle entries
Karl Williamson [Tue, 23 May 2017 03:45:57 +0000 (21:45 -0600)]
perldelta: Collapse :utf8 handle entries

There were two entries dealing with this.

4 years agoperldelta: Add some C<>
Karl Williamson [Tue, 23 May 2017 03:29:17 +0000 (21:29 -0600)]
perldelta: Add some C<>

These were overlooked in earlier commits

4 years agoperldelta: Rmv duplicate entry
Karl Williamson [Tue, 23 May 2017 03:26:21 +0000 (21:26 -0600)]
perldelta: Rmv duplicate entry

4 years agoperldelta: It was perlmod that changed
Karl Williamson [Mon, 22 May 2017 23:48:45 +0000 (17:48 -0600)]
perldelta: It was perlmod that changed

Not perlmodinstall

4 years agoperldelta: Fix link.
Karl Williamson [Mon, 22 May 2017 22:33:53 +0000 (16:33 -0600)]
perldelta: Fix link.

Spotted by Dan Book

4 years agoperldelta: Add link for more expanation
Karl Williamson [Mon, 22 May 2017 22:23:19 +0000 (16:23 -0600)]
perldelta: Add link for more expanation

The link explains unescaped "{" more.

4 years agoperldelta: Clarify -Di switch entry
Karl Williamson [Mon, 22 May 2017 22:10:33 +0000 (16:10 -0600)]
perldelta: Clarify -Di switch entry

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

4 years agoperldelta: Add missing links
Karl Williamson [Mon, 22 May 2017 21:48:53 +0000 (15:48 -0600)]
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.

4 years agoperldelta: Rmv entry that applied only to 5.25 dev release
Karl Williamson [Mon, 22 May 2017 21:33:37 +0000 (15:33 -0600)]
perldelta: Rmv entry that applied only to 5.25 dev release

4 years agoperldelta: Clarify entry for [perl #129106]
Karl Williamson [Mon, 22 May 2017 21:30:02 +0000 (15:30 -0600)]
perldelta: Clarify entry for [perl #129106]

4 years agoperldelta: Clarify a utf8 decode entry
Karl Williamson [Mon, 22 May 2017 21:20:36 +0000 (15:20 -0600)]
perldelta: Clarify a utf8 decode entry

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

4 years agoperldelta: Clarify about when isFOO_utf8 now die
Karl Williamson [Mon, 22 May 2017 21:18:26 +0000 (15:18 -0600)]
perldelta: Clarify about when isFOO_utf8 now die

4 years agoperldelta: perlop changes
Karl Williamson [Mon, 22 May 2017 21:12:55 +0000 (15:12 -0600)]
perldelta: perlop changes

This adds a new item, and clarifies the existing one

4 years agoperldelta: Clarified perlhack entry
Karl Williamson [Mon, 22 May 2017 21:11:41 +0000 (15:11 -0600)]
perldelta: Clarified perlhack entry

4 years agoperldelta: Reordered split() so most important is 1st
Karl Williamson [Mon, 22 May 2017 21:10:03 +0000 (15:10 -0600)]
perldelta: Reordered split() so most important is 1st

4 years agoperldelta: Clarify seek() entry
Karl Williamson [Mon, 22 May 2017 21:07:56 +0000 (15:07 -0600)]
perldelta: Clarify seek() entry

4 years agoperldelta: Move dtrace ticket number
Karl Williamson [Mon, 22 May 2017 21:06:17 +0000 (15:06 -0600)]
perldelta: Move dtrace ticket number

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

4 years agoperldelta: Remove duplicate entry
Karl Williamson [Mon, 22 May 2017 21:02:30 +0000 (15:02 -0600)]
perldelta: Remove duplicate entry

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

4 years agopod/perldelta: Reword #129903 description
Karl Williamson [Mon, 22 May 2017 20:58:03 +0000 (14:58 -0600)]
pod/perldelta: Reword #129903 description

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

4 years agopod/perldelta: Reword #130010 description
Karl Williamson [Mon, 22 May 2017 20:56:54 +0000 (14:56 -0600)]
pod/perldelta: Reword #130010 description

I looked at the commits and ticket to clarify this

4 years agoperldelta: Add missing =item
Karl Williamson [Mon, 22 May 2017 20:51:56 +0000 (14:51 -0600)]
perldelta: Add missing =item

4 years agoperldelta: Nit fixes
Karl Williamson [Mon, 22 May 2017 20:45:48 +0000 (14:45 -0600)]
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.

4 years agoperldelta: Standardize on ticket #'s being at ends
Karl Williamson [Mon, 22 May 2017 20:16:22 +0000 (14:16 -0600)]
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.

4 years agopodcheck: Module::Signatures is known correct.
Karl Williamson [Mon, 22 May 2017 19:11:32 +0000 (13:11 -0600)]
podcheck: Module::Signatures is known correct.

4 years agoperldelta: Add pod formatting codes
Karl Williamson [Mon, 22 May 2017 19:39:49 +0000 (13:39 -0600)]
perldelta: Add pod formatting codes

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

4 years agoperldelta: Fix overlooked C<.>
Karl Williamson [Mon, 22 May 2017 20:07:53 +0000 (14:07 -0600)]
perldelta: Fix overlooked C<.>

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

4 years agoperldelta: Fix link displays
Karl Williamson [Mon, 22 May 2017 19:23:40 +0000 (13:23 -0600)]
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>

4 years agoperldelta: Standardize references to Perl
Karl Williamson [Mon, 22 May 2017 17:49:28 +0000 (11:49 -0600)]
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

4 years agoFix various POD issues
Sawyer X [Mon, 22 May 2017 19:21:39 +0000 (21:21 +0200)]
Fix various POD issues

4 years agoCorrect POD formating error detected by t/porting/podcheck.t.
James E Keenan [Mon, 22 May 2017 19:19:03 +0000 (15:19 -0400)]
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.

4 years agoperldelta: Note new test scripts
Karl Williamson [Mon, 22 May 2017 17:32:14 +0000 (11:32 -0600)]
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.

4 years agoperldelta: Fix some single char C< >
Karl Williamson [Mon, 22 May 2017 16:46:54 +0000 (10:46 -0600)]
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.

4 years agoperldelta: Collapse "Removed Deprecations"
Karl Williamson [Mon, 22 May 2017 15:29:43 +0000 (09:29 -0600)]
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.

4 years agoperldelta: tweak SV flags; eliminate hv_fetchs
David Mitchell [Mon, 22 May 2017 15:22:23 +0000 (16:22 +0100)]
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.

4 years agoperldelta: expand Unicode/utf8 API changes
David Mitchell [Mon, 22 May 2017 15:09:50 +0000 (16:09 +0100)]
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.

4 years agoperldelta: sort the "Internal Changes" section.
David Mitchell [Mon, 22 May 2017 14:01:18 +0000 (15:01 +0100)]
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.

4 years agoperldelta: move an entry from Internal to Bug Fixes
David Mitchell [Mon, 22 May 2017 13:50:21 +0000 (14:50 +0100)]
perldelta: move an entry from Internal to Bug Fixes

4 years agoperldelta: remove some "Internal Changes" entries
David Mitchell [Mon, 22 May 2017 13:44:05 +0000 (14:44 +0100)]
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?

4 years agoperldelta: re-order "Core Enhancements" entries
David Mitchell [Mon, 22 May 2017 13:17:22 +0000 (14:17 +0100)]
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.

4 years agoperldelta: fix some issues raised by Karl
David Mitchell [Mon, 22 May 2017 13:07:29 +0000 (14:07 +0100)]
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.

4 years agoperldelta: Fix some issues raised by Ævar
David Mitchell [Mon, 22 May 2017 11:56:00 +0000 (12:56 +0100)]
perldelta: Fix some issues raised by Ævar

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

4 years agoperldelta: update @INC blurb in Notice
David Mitchell [Mon, 22 May 2017 10:18:03 +0000 (11:18 +0100)]
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.

4 years agoTime-HiRes: fix a do/@INC issue in Makefile.PL
David Mitchell [Mon, 22 May 2017 08:37:31 +0000 (09:37 +0100)]
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 ]

4 years agoperldelta: Add a C<> formatting code.
Karl Williamson [Sun, 21 May 2017 03:41:42 +0000 (21:41 -0600)]
perldelta: Add a C<> formatting code.

4 years agoperldelta: Cleanup documentation changes section
Karl Williamson [Sun, 21 May 2017 03:38:10 +0000 (21:38 -0600)]
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.

4 years agoperldelta: Add a section for undeprecations
Karl Williamson [Sun, 21 May 2017 03:36:16 +0000 (21:36 -0600)]
perldelta: Add a section for undeprecations

and populate it.

4 years agoperldelta: Note that utf8_hop_safe is for XS code
Karl Williamson [Sun, 21 May 2017 03:31:57 +0000 (21:31 -0600)]
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.

4 years agoperldelta: remove the @INC blurb I added
Ævar Arnfjörð Bjarmason [Sat, 20 May 2017 13:53:04 +0000 (13:53 +0000)]
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.

4 years agoMore perldelta tweaks.
Craig A. Berry [Sat, 20 May 2017 02:52:51 +0000 (21:52 -0500)]
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.

4 years agoperldelta: Note that part of perlre was rewritten
Karl Williamson [Fri, 19 May 2017 20:08:51 +0000 (14:08 -0600)]
perldelta: Note that part of perlre was rewritten

4 years agoperldelta: Fix wording about literal "{"
Karl Williamson [Fri, 19 May 2017 20:07:36 +0000 (14:07 -0600)]
perldelta: Fix wording about literal "{"

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

4 years agoperldelta: Nits
Karl Williamson [Fri, 19 May 2017 20:04:56 +0000 (14:04 -0600)]
perldelta: Nits

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

4 years agoperldelta: Make version numbers more consistent
Karl Williamson [Fri, 19 May 2017 19:58:53 +0000 (13:58 -0600)]
perldelta: Make version numbers more consistent

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

4 years agoperldelta: tweaks to obituaries
Aaron Crane [Fri, 19 May 2017 14:07:38 +0000 (15:07 +0100)]
perldelta: tweaks to obituaries

4 years agoperldelta: Use two spaces after sentences.
Karl Williamson [Fri, 19 May 2017 03:25:28 +0000 (21:25 -0600)]
perldelta: Use two spaces after sentences.

4 years agoperldelta: Various nits.
Karl Williamson [Fri, 19 May 2017 03:17:43 +0000 (21:17 -0600)]
perldelta: Various nits.

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

4 years agoperldelta: don't dollar-quote an env variable like $ENV, should be ENV
Ævar Arnfjörð Bjarmason [Thu, 18 May 2017 08:02:35 +0000 (08:02 +0000)]
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.

4 years agoperldelta: This file is for 5.26, not 5.24
Karl Williamson [Thu, 18 May 2017 05:10:08 +0000 (23:10 -0600)]
perldelta: This file is for 5.26, not 5.24

4 years agoperldelta: Rmv entry that applies just to a devel release
Karl Williamson [Thu, 18 May 2017 05:09:01 +0000 (23:09 -0600)]
perldelta: Rmv entry that applies just to a devel release

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

4 years agoperldelta: Don't mention development release numbers
Karl Williamson [Thu, 18 May 2017 05:07:10 +0000 (23:07 -0600)]
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.

4 years agoperldelta: Add unescaped "{" to Notice
Karl Williamson [Thu, 18 May 2017 05:05:32 +0000 (23:05 -0600)]
perldelta: Add unescaped "{" to Notice

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

4 years agoperldelta: Move some alleged 'enhancements' to 'incompatible changes'
Karl Williamson [Thu, 18 May 2017 05:02:33 +0000 (23:02 -0600)]
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.

4 years agoperldelta: Improve wording about Unicode scx property
Karl Williamson [Thu, 18 May 2017 05:00:47 +0000 (23:00 -0600)]
perldelta: Improve wording about Unicode scx property

4 years agoperldelta: Move section adjacent to similar one
Karl Williamson [Thu, 18 May 2017 04:51:46 +0000 (22:51 -0600)]
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.

4 years agoperldelta: Remove duplicate entry
Karl Williamson [Thu, 18 May 2017 04:47:40 +0000 (22:47 -0600)]
perldelta: Remove duplicate entry

4 years agoFix another perldelta link
Sawyer X [Wed, 17 May 2017 19:15:54 +0000 (21:15 +0200)]
Fix another perldelta link

4 years agoFix perldelta link
Sawyer X [Wed, 17 May 2017 19:15:45 +0000 (21:15 +0200)]
Fix perldelta link

4 years agoRemove documentation of 5.25.4 fix in 5.26.0 delta
Sawyer X [Wed, 17 May 2017 19:09:18 +0000 (21:09 +0200)]
Remove documentation of 5.25.4 fix in 5.26.0 delta

4 years agoFix git conflict indicator
Sawyer X [Wed, 17 May 2017 19:09:07 +0000 (21:09 +0200)]
Fix git conflict indicator

4 years agoExtra commas
Sawyer X [Sun, 14 May 2017 09:39:43 +0000 (11:39 +0200)]
Extra commas

4 years agoAdd more extensive information about @INC changes into perldelta (RT#131304)
Dominic Hargreaves [Wed, 17 May 2017 14:17:42 +0000 (15:17 +0100)]
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].

4 years agoperldelta: Fix broken link
Karl Williamson [Wed, 17 May 2017 15:53:34 +0000 (09:53 -0600)]
perldelta: Fix broken link

4 years agoperldelta: clarify what '.' and @INC is about
Ævar Arnfjörð Bjarmason [Tue, 16 May 2017 18:30:10 +0000 (18:30 +0000)]
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)

4 years agoperldelta: clarify how undeffing HV/AV is faster now
Ævar Arnfjörð Bjarmason [Sat, 13 May 2017 22:14:50 +0000 (22:14 +0000)]
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)