Expand bump RT version number in Porting/release_managers_guide.pod

Robert generally adds future versions, so check first whether he
has first.

fix `perldoc -v '$0'`

Presently, `perldoc -v '$0'` fetches the entry for $<digits> ($1, $2,
...) instead of $0 ($PROGRAM_NAME).

Increase $Pod::Perldoc::VERSION

in preparation for the next commit.

perldelta entry for #93454

Tiny comment typo fix in handy.h

Correct comment that 903fd87c missed

perlunicode: Nits

a missing word, remove L<> from a verbatim block, add L<> for a module,
clarify wording

cast unsigned to avoid warning

Add a cast C<(unsigned)> to silence a compiler warning [-Wsign-compare]

[perl #93454] Free deleted iterator when freeing hash

Commit 7d6175e, which did a fix-up after commit e0171a1a3, which
introduced hfree_next_entry, did not account for the fact that
hfree_next_entry frees the hash iterator before removing and returning
the next value.

It changed the callers to check the number of keys to determine
whether anything else needed to be freed, which meant that
hfree_next_entry was called one time less than necessary on hashes
whose current iterator had been deleted and which consequently
appeared empty.

This fixes that.

I don’t know how to test it, but the string table warnings were caus-
ing test failures on VMS, so maybe that’s good enough.

Bypass a switch in gv_fetchpvn for 2-char symbols

The switch that checks for ISA, EXPORT, etc. in packages other
than main was guarded with an if(len>1) statement.  Since ISA is
three characters, we can bypass that entire switch for two-charac-
ter symbols.

Update proto docs after prev commit

Allow the \$ proto to accept any scalar lvalue [perl #91846]

This makes the \$ prototype’s parsing the same as the second argument
to read(), making it possible to create a custom myread() function
that has the same syntax.

This is handled in two places in the prototype-parsing code, to avoid
calling scalar() on the op if another character in \[...] will accept
it.  I don’t know what the consequences of that would be.  So it calls
Perl_op_lvalue_flags in the $ case only if it is not inside brackets.
Then in the ] case it checks to see whether there was a $.

OP_READ, not OP_ENTERSUB, is passed as the type to
Perl_op_lvalue_flags, since OP_ENTERSUB would allow sub foo(\$) to
accept an array as an argument.  OP_RECV and OP_SYSREAD would have
worked, too.

Make Perl_op_lvalue_flags provide a no-croak option

This is in preparation for making the \$ prototype accept any lvalue.

op_lvalue .= _flags

Add flags param to op_lvalue, so that the caller can ask it not to
croak when encountering an unmodifiable op (upcoming).

This is in preparation for making the \$ prototype accept any lvalue.

There is no mathom, as the changes that this will support
are by no means suitable for maint.

proto.t: Test \$ with subcall()->[elem]

This syntax was documented, but there was no test for it.

Remove two tests from proto.t

These have been superseded by t/op/cproto.t, which came later.

Make pp_leavesublv use S_return_lvalues

The returning code is now almost identical, due to the preceding com-
mits, so they can be merged.

realclean clean-up on VMS.

Update a few missing or moved items in the realclean target.

preplibrary needs an explicit action in descrip_mms.template.

Even if that action says "Don't do anything."  MMK silently ignores
this but MMS falls down hard with:

%MMS-F-GWKNOACTS, Actions to update PREPLIBRARY are unknown.

This was broken in ebca06e95b02d1a8cf073328af30c9f4b9af6891.

Fix explicit return of pad var in list lv context

This is something that commit e08be60 missed, though it never worked
properly, even in 5.14, as explicit return from lvalue subs used to
copy return values.

As the commit message for e08be60 states, returning a scalar itself
from an lvalue sub does not work if it is a pad variable with a refer-
ence count of 1, because the sub-popping code clears it on exit.

The one code path that did not account for this was list lvalue con-
text (real lvalue context, not just potentially lvalue).  The only
observable effect this has is that assigning to a magic pad variable
returned from a subroutine in list context will not trigger set-magic.

This commit fixes it and also adds tests for returned magic pad vars
in all combinations of list/scalar lvalue/ref context.

Collapse the list context code in pp_leavesublv

Two branches of this three-branch if/elsif were doing the same thing.
One was written out longhand.

Remove now-redundant check from pp_ctl.c:S_return_lvalues

This has been redundant since commit d25b0d7.

Mention bump-perl-version's inplace mode in Porting/release_managers_guide.pod

Seeing as Porting/bump-perl-version is run in a git directory,
instead of writing a diff file and then applying it, this adds
a -i option which makes the changes inplace

Move Porting/bump-perl-version to use autodie

Extract the code the maps from an author/distribution to a
CPAN URL into its own subroutine: cpan_url_distribution()
in Porting/core-cpan-diff

Test studied scalars with s///ge.

study now passes REXEC_SCREAM to the regex engine when SvSCREAM() is true.

This causes the regex engine to take advantage of the study data.

Fix up some tests in sub_lval.t

One test was disabled long ago

Returning undef in list context was allowed by change 10777 (f206cdd)
in 2001.  There was already a test for disallowing it.  That test was
disabled by change 10779 (4c8a4e58), rather than correct to test the
new behaviour.

This commit changes it to test that undef return is allowed in list
context, also adding a test for explicit return.

Make lvalue return make the same checks as leavesublv

This causes explicit return in lvalue context to die the way implicit
return does.  See the tests and the perldelta entry in the diff.

pp_leavesublv: Put the deref code inside if(scalar)

No need to check it in list context (but still assert that).

Make pp_leavesublv switch based on gimme

Put if(gimme == ...) on the outside and if(CxLVAL(cx)...) on the
inside.  This reduces the amount of code, since the OPpENTERSUB_INARGS
case and the !CxLVAL case were both doing the same thing for scalars.

Removed unused label from pp_leavesublv

This has been unused since e178c744.

Copy PADTMPs explicitly returned from lv subs

I don’t believe this changes any observable behaviour, Devel::Peek
aside.  If it does, it fixes bugs.

I am making this change for two reasons:
• PADTMPs can be a bit buggy and letting them escape their subroutines
  can make the bugs harder to fix.
• This brings explicit and implicit return from lvalue subroutines one
  step closer (for the sake of merging the code).

Duplicate in list of .h files on VMS.

This is a bug I introduced in 66b82e1fdff51a4c821a3a249fe707cf8014a185.
Surprising it hasn't caused more trouble.  When building with MMS, it's
a hard error, whereas MMK silently ignores it.

For s///r, avoid copying the source early only to edit it in place.

Instead, take advantage of the "can't edit in place" code path of pp_subst
which writes to a new scalar, and that pp_substcont always leaves the original
intact, writing to a new scalar.

Add PERL_NO_GET_CONTEXT to Math::BigInit::FastCalc.

For threaded platforms, this reduces the object code size significantly, and
should slightly reduce CPU usage.

Two small tidying refactors for TestInit.pm

Make the order of backslash and forward slash in character classes consistent.
Move the top level modification of $0 adjacent to the top level modification of
$ENV{PERL_CORE}.

Fix a (back)slash bug in a regex, added with the regex itself.

8fcfece7bab67639 added code to TestInit to set the CWD and @INC for tests in
ext. However, the regex used to distinguish where a test was had one forward
slash where a backslash should have been, hence the intended Win32 support
would not work. I'm assuming that no-one has noticed this because no-one has
tried to run tests from the command line on Win32 directly, or if they have
they always use forward slashes in their pathnames.

In TestInit, eliminate @new_inc, by assigning to @INC directly.

To decide whether to default, we can test $set_opt instead of whether @new_inc
is empty, as all places that assign to @new_inc (now to @INC) also set
$set_opt.

In TestInit, inline new_inc() and set_opt() into import(), their only caller.

In find_git_or_skip(), also check whether we have a working git executable.

Otherwise we trip up if someone copies an entire git checkout to another
machine that doesn't have (or support git), or NFS mounts their active
checkout onto it, or simply doesn't have git in their PATH currently.

find_git_or_skip() will now follow symlinks and chdir to the real source tree.

porting{authors,cmp_version,manifest}.t now use TestInit qw(T A) to set @INC
and $^X to absolute paths, in case find_git_or_skip() changes directory.
As $^X is now absolute, there's no need to choose between '/' and '\\' based
on $^O.

Use find_git_or_skip() in porting{authors,cmp_version,manifest}.t

Correct the skip count in t/porting/manifest.t. Not that this matters
currently, as the SKIP block holds the last tests in the file, and the script
uses done_testing() instead of a plan up front.

Add find_git_or_skip(), which skips if we are not in a git checkout.

use TestInit 'T' in porting{authors,cmp_version,manifest}.t to chdir '..'

These three tests run git commands from the top level of the build tree, so
need to chdir '..' if run from 't'. use TestInit 'T' to do this, as it simplify
adapting the tests to also work when the build tree is a symlink forest from
-Dmksymlinks. TestInit also sets $ENV{PERL5LIB}, avoiding the need to use -Ilib
on the command line of the programs they run.

t/porting/manifest.t now runs throughout at the top level, which simplifies it
slightly.

Add an import option 'T' to TestInit, for tests that run at the top level.

This sets @INC to 'lib, and unless we're already at the top level will
chdir '..' [on the assumption that we are starting in t].

In TestInit.pm, move the default chdir and @INC code into import().

The behaviour is consistent with previous behaviour, as the equivalent of the
new code used to be run at the top level, hence would happen (unconditionally)
before import() was called.

In TestInit.pm, merge two substitutions into one.

Both are intended to transform ./perl into ../../perl, one for forward slashes,
one for backslashes.

Remove another CvLVALUE check from pp_leavesublv

Move pp_leavesublv from pp_hot.c to pp_ctl.c

This is so that it can share code with pp_return.  I was going to move
pp_return into pp_hot.c, but it uses static functions that other pp_
functions in pp_ctl.c use.

Remove the CvLVALUE check from pp_leavesub

As of bb3abb0, this can no longer happen.

Update IO-Compress to CPAN version 2.037

  [DELTA]

  2.037 22 June 2011

      * IO::Uncompress
        - get globmapper tests working on VMS
          [RT# 68926]

      * IO::Uncompress::Unzip
        - Fixed limitation where Streamed Stored content was not supported.

Update Compress-Raw-Zlib to CPAN version 2.037

  [DELTA]

  2.037 22 June 2011

      * No Changes

Update Compress-Raw-Bzip2 to CPAN version 2.037

  [DELTA]

  2.037 22 June 2011

      * No Changes

Update IPC-Cmd to CPAN version 0.72

  [DELTA]

  Changes for 0.72    Wed Jun 22 12:29:59 BST 2011
  =================================================
  * Added IPC::Open3 support for capturing STDOUT/STDERR
    on MSWin32, prefer this over IPC::Run

attrs.t: Test for something I almost broke

attributes.pm: warn & don’t apply :lvalue to defined subs

This is something that ‘sub foo :lvalue;’ declarations do.  This brings
attributes.pm in line with them.

See commits fff96ff and 885ef6f, ticket #68758, and
<364E1F98-FDCC-49A7-BADB-BD844626B8AE@cpan.org>.

Increase $attributes::version to 0.15

I’m about to make changes to it.

In Cwd.xs, swap to defaulting to disabled prototypes.

As only 1 function enables prototypes, it seems sensible to set the default to
the majority case.

Merge the implementation of Cwd::{fastcwd,getcwd} using ALIAS.

In Cwd.xs on VMS, don't compile bsd_realpath() at all.

On VMS, call Perl_rmsexpand() directly from abs_path(), instead of making
bsd_realpath() a trivial wrapper to Perl_rmsexpand().

Initialise path at the point of declaration, instead of separately. Use
sv_setpv_mg() instead of sv_setpvn() with an explicit strlen(), changing
PUSHTARG to PUSHs(TARG) to avoid setting magic twice.

Add PERL_NO_GET_CONTEXT to Cwd.

In Cwd::_win32_cwd() avoid a string eval when checking if we're miniperl.

To allow ExtUtils::MakeMaker to run tests as if it's "miniperl" we need to avoid
taking any sort of reference to the typeglob or the code in the optree, as its
test modules are loaded later than Cwd. Previously this was done with a string
eval, but that was causing problems (for unclear reasons - rt.cpan.org #56225).
Using a symbol table lookup and *foo{THING} syntax avoids the string eval.

Evolved from a suggestion by Reini Urban.

Trim multiple blank lines above =item in pod files.

This makes many documents more consistent in their pod formatting. Don't trim
blank lines between verbatim blocks and =item, as removing them makes the (raw)
pod harder to read.

The podchecker much prefers a forward slash in F<symbian/TODO>

It looks for the file within the F<> - on *nix, 'symbian\TODO' doesn't exist,
so the line is flagged as a known issue. On Windows, it does exist (because
at the API level, / and \ are both valid as directory separators), so there is
no known issue, and the test fails with a request to delete the known issue.

README.symbian is not consistent in its use of backward or forward slashes
inside F<> markup, so this isn't the first use of a forward slash.

(The podchecker has other exemption rules for F<>, hence why this doesn't
matter in some cases.)

Update IO-Compress to CPAN version 2.036

  [DELTA]

  2.036 18 June 2011

      * IO::Compress::Zip & IO::Uncompress::Unzip
        - Added support for LZMA (method 14) compression/uncompresion.

      * IO::Compress::Unzip
        - Fixed CRC issue when compression is Store or Bzip2 and Strict option
          is set.

      * IO::Compress::Zip
        - Fixed Zip64 issue where the content size is exactly 0xFFFFFFFF

Update Compress-Raw-Zlib to CPAN version 2.036

   [DELTA]

    2.036 6 May 2011

       * Added offset parameter to CRC32

Update Compress-Raw-Bzip2 to CPAN version 2.036

  [DELTA]

   2.036 18 June 2011

       * No Changes

podcheck.t: ignore buildtoc output

Re-clarify the pod.lst instruction

Well, it was unclear enough that I misunderstood it and my
previous clarification was wrong.  This corrects it.

Stop ‘sub :lvalue :Foo’ from applying :lvalue to defined subs

This is something that commit 885ef6f missed.  See ticket #68758 and
the perldelta diff in this commit.

I thought that the prototype-application inconsistencies mention in
<2C7C1BF5-A814-4F5E-B10E-E431B71BA8CA@cpan.org> would get in the way
of this, but I found that the easiest way to fix it actually did not
change any of that.  So those issues can wait till another day.

Re-flow some sample text in the perldelta template to avoid an overlong line.

Porting/perldelta_template.pod is exempt from t/porting/podchecker.t, but when
its contents are copied as pod/perldelta.pod, that file is not. This change
reduces the amount of work the release manager needs to do to create a new
perldelta.

Add perldelta "known issues" to the podchecker exception list.

Porting/perldelta_template.pod is exempted from t/porting/podchecker.t
Hence when it is copied to pod/perldelta.pod, exceptions need to be added for
certain template boilerplate it contains, which are not valid pod
(but ultimately will be edited out before the release).

This doesn't seem ideal, but I'm not sure of a better way to do this.

Add perl5151delta to pod.lst and regenerate makefiles.

Clarify the pod.lst instruction in rm guide

Grrr! I always forget to add new files

[perl #78462] Don't warn for splice(@a,MAX_LEN)

The intent of splice(@a,MAX_LEN) is quite clearly to truncate
the array if it's too large. There's no reason to warn if it's
currently smaller than the max length.

create perldelta for 5.15.1

Increase $Storable::VERSION to 2.29

Add Sam Kimbrel to AUTHORS

[perl #92432] Storable::nfreeze shouldn't stringify ints

Storable::nfreeze's integer size check doesn't work correctly:

Using nfreeze to store an int larger than one byte produces a
frozen representation that thaws into a stringified integer, without
my having done string operations on the scalar beforehand.

I've confirmed this bug with the three versions I had available to me:
5.8.9 on 64-bit CentOS 4, 5.12.1 on 64-bit OS X 10.6, and
5.14.0 on 64-bit Debian squeeze.

The constants involved in the comparisons get created as 32-bit integers,
which wrap around and cause the comparison to yield true when it shouldn't.

This patch casts the constants before using them, which should make this
port correctly to 64-bit architectures. Running tests on a 64-bit Debian
host shows no problems.

In pod/buildtoc, use abs_from_top() to generate pathnames.

88fb56ecc95f23db used 'pod/perldelta.pod' instead of abs_from_top(), and broke
the build on Win32, which runs buildtoc from the win32 directory.

update Time-HiRes to CPAN version 1.9724

- Correct XS parameter list, and therefore prototype, for
  unimplemented-on-this-platform version of clock_nanosleep()
  [rt.cpan.org #68700].
- Declare package variables with "our" rather than "use vars".
- Corresponding to "our" usage, check for minimum Perl version
  5.006.
- Declare module dependencies.

- Remove $ENV{PERL_CORE} logic from test suite, which is no
  longer desired in the core.
- Convert test suite to use Test::More.
- Factor out watchdog code from test suite.
- In test suite, be consistent about using fully-qualified form
  of function names.
- Divide test suite into feature-specific scripts.
- Make ualarm timing test less vulnerable to delay-induced false
  failure, from Dave Mitchell.

update Math-Complex to CPAN version 1.58

* Declare package variables with "our" rather than "use vars".

* Corresponding to "our" usage, check for minimum Perl version
  5.006.

* Remove $ENV{PERL_CORE} logic from test suite, which is no
  longer desired in the core.

* In test suite, remove obsolete and now-incomplete handling of
  unavailability of Test::More.

* Declare module dependencies.

update release schedule document

perlunicode: Narrow verabitm lines so don't wrap

For 80 columns, this collection of spacing changes keeps all
lines in this pod from wrapping.

podcheck.t: sort --add_link output

The recently added --add_link option just appended lines to the end of
the data base file.  While this works, it means that the next time the
db is regen'd, that they will move around and show up in difference
listings unrelated to the original patch, thus potentially confusing
people.

podcheck.t: Reduce F<> message false positives

podcheck looks for things that might be file path references which
are enclosed in C<> instead of F<>.  But there are some things that
aren't paths that have slashes in them, like "origin/blead"  This
adds some more of these.

podcheck.t: White-space only changes

podcheck: Reduce fals positives for L<> message

podcheck looks for things like "See C<INSTALL>" and flags them as
perhaps L<> should have been used instead.  It was giving false
positives for things like "if you do x, you should see C<foo>".  This
catches those.

podcheck: Fix skip upstream cpan

Normally upstream cpan modules are not pod checked, but in the
one case where two had the same name, an error was generated
nonetheless.

podcheck.t: Fewer false positives for L<>

If there is a F<foo/bar> and a file named bar in the directory foo
exists, then assume that is what was meant, instead of raising
the possibility that L<> was meant.

podcheck.t: Suppress all L<> messages for config.pod

config.pod is a generated file that just adds C<> around all-caps words.
Until such time as it is made smarter to use L<> for links instead,
just suppress the messages that L<> might be better.

File::Find pod: fix link issue

README.macosx: Change C<> into F<>

perlapi: fix broken link, from sv.c

README.ce: Change some C<> into F<>

perlcygwin: Fix broken link

perlfunc: Fix some link issues