* FAQ sync for Nov blead release

This comes from 028b6d17a07335707c2b234cb69ac4051ed48435 in
git@github.com:briandfoy/perlfaq.git

* Fixed sort example using =(\d+)

The example wanted to sort a list like qw(=1 =2 =a =3 =d). One
example tried to be clever with array indices and precomputed
an array in @nums. However, it forgot to leave holes for the
elements where it could not extract a run of digits. Once the
indices were misaligned, the sort didn't give the right answer.

I know you can read the patch, but since I fixed whitespace too,
a simple diff gives you a lot of output. The old example had:

    for (@old) {
        push @nums, /=(\d+)/;
        push @caps, uc($_);
    }

The new one keeps the indices aligned by using undef when the
match failed:

    for (@old) {
        push @nums, ( /=(\d+)/ ? $1 : undef );
        push @caps, uc($_);
    }

This issue was reported on Stackoverflow:

http://stackoverflow.com/questions/1754441

Merge branch 'blead' of ssh://perl5.git.perl.org/gitroot/perl into blead

Module::CoreList updated for the real 5.11.2, including Module::Build changes

Convert the shell pipeline for the list of committers to a Perl 1 liner.

To me it feels better to promote our own dogfood.

The lexer API is very exciting, but only mention it once

Run Porting/podtidy

Add details of module updates

Delete a few more sections

Delete sections, add a bunch more

Merge branch 'blead' of perl5.git.perl.org:/gitroot/perl into blead

Sync AUTHORS and Porting/checkAUTHORS.pl with Changelogs

Mention how to generate stats for the Acknowledgements

Fix POD: C<...->...> => C<< ...-> ... >>

Signed-off-by: Abigail <abigail@abigail.be>

Updated Module::Build to 0.35_09

0.35_09 - Thu Nov 19 01:30:42 EST 2009

 Bug fixes:

 - The DB package should not be included in 'provides' in META files
   [David Golden]

 - Fixed t/xs.t build failures in bleadperl for noexec temp directories
   [Nicholas Clark]

 - Adjusted order of @INC in resume() (fixes par.t, ppm.t, xs.t fails):
   @INC = @new_additions_to_inc, @saved_additions_to_inc, @default_inc
   [David Golden]

 - Skip bundle_inc.t tests if bundled Module::Build for test can't be
   tweaked (Works around test crashes on Win2) [David Golden]

 Other:

 - 'C_support' is no longer an optional feature.  Modern ExtUtils::CBuilder
   and ExtUtils::ParseXS added to the 'requires' list.  This ensures that
   upgrading Module::Build will upgrade this critical modules.
   ExtUtils::CBuilder no longer requires a compiler, so it is "safe" to
   require.

Fill in some details about the release

Tweak tense, remove double spaces

Bump version of Module::CoreList to 2.23

Abolish xio_lines from struct PVIO - store IoLINES() in the IVX slot.

PVIOs don't use the SvIVX slot.

lexer API fixes

The attached patch contains these fixes for the lexer API work:

* fix MinGW-revealed problem in BOM logic (replacing Jan's patch)
* fix warnings from t/op/incfilter.t
* probably fix g++ failure due to goto bypassing initialisation
* perl5112delta update

-zefram

Signed-off-by: H.Merijn Brand <h.m.brand@xs4all.nl>

minitest fixes

Attached patch fixes two small bugs that interfere with minitest.

-zefram

Signed-off-by: H.Merijn Brand <h.m.brand@xs4all.nl>

Add a few more distribution versus module name exceptions

Merge branch 'blead' of ssh://perl5.git.perl.org/gitroot/perl into blead

Add the 5.11.2 release

{camel,dromedary}.booking.com names are gone, so update them to {,users.}per5.git.perl.org

And run podtidy.

Module::CoreList updated for 5.11.2

Fix two spelling errors

Bump 5.11.1 -> 5.11.2 in all sorts of places it's (oh so unfortunately) hardcoded

Updated CPAN path for Module::CoreList in Maintainers.pl

Fix minor typo in comment

Skip the scope name checks if PL_scopestack_name is NULL.

It's possible that someone has built a module with -DDEBUGGING, but they're
using it against a perl built non-DEBUGGING, in which case PL_scopestack_name
will be NULL. Better to skip the checks than to SEGV.

PL_scopestack_name needs to be present, -DDEBUGGING or not.

-DDEBUGGING and not need to be binary compatible with each other. Fixes the
test failures in ext/re caused by d343c3ef45381352 for threaded builds without
-DDEBUGGING.

Update CPANPLUS::Dist::Build to cpan version 0.44

  Changes for 0.44
  ================
  Make the prereq resolving fallback to _build/ querying if the 'prereq_data' action fails.

  The edge-case of a distribution that is bundling an older version of Module::Build exposed this
  flaw. Thanks to Johan Vromans for questioning the test report for EekBoek.

Correct the arguments to MBTest->tmpdir() to reflect implementation changes.

Updated Module::Build to 0.35_08

0.35_08 - Mon Nov 16 22:38:28 EST 2009

 Bug fixes:

 - Multiple tests were failing due to dependency problems.  Author
   dependencies have been largely removed from core 'requires' into
   optional features.  Feature prereq detection and messaging have been
   expanded and bugs on older Perls have been removed.

0.35_07 - Sat Nov 14 17:14:39 EST 2009

 Bug fixes:

 - Auto-detection of abstract and author fixed for mixed-case POD headers
   (RT#51117) [David Wheeler]

 - resume() was not restoring additions to @INC added in Build.PL
   (RT#50145) [David Golden]

 - When tarball paths are less than 100 characters, disables 'prefix'
   mode of Archive::Tar for maximum compatibility (RT#50571) [David Golden]

0.35_06 - Fri Nov 13 14:51:28 EST 2009

 Enhancements:

 - Added experimental inc/ bundling; see Module::Build::Bundling for
   details.  [David Golden and Eric Wilhelm]

 - Clarified that 'apache' in the license attribute indicates the Apache
   License 2.0 and added 'apache_1_1' for the older version of the license
   (RT#50614) [David Golden]

 Bug fixes:

 - Merging 'requires' and 'build_requires' in Module::Build::Compat could
   lead to duplicate PREREQ_PM entries; now the highest version is used
   for PREREQ_PM. (RT#50948) [David Golden]

 - Module::Build::Compat will now die with an error if advanced,
   non-numeric prerequisites are given, as these are not supported by
   ExtUtils::MakeMaker in PREREQ_PM [David Golden]

 - Made MYMETA generation non-fatal if fields required for META.yml
   are missing [David Golden]

 - Added Pod::Simple to requirements for manpage support; avoids
   problems if a user has a broken Pod::Man/Pod::Simple.  (RT#50081)
   [David Golden]

 - Won't die if installed Pod::Readme is broken [David Golden]

 Other:

 - Fixed Module::Build::Notes POD [David Golden]

 - Some commands had become silent by default, so added a few short status
   messages so users know something actually happened [David Golden]

 - Cleaned up Changes file formatting [David Golden]

 - Removed most PERL_CORE customizations from test files due to
   reorganization of dual-life modules in core (RT#49522) [David Golden]

0.35_05 - Wed Oct 28 17:20:59 EDT 2009

 Bug fixes:

 - Fix test failure in t/actions/installdeps.t when $^X is not the default
   perl [David Golden]

 - Work around $VERSION numbers in ActiveState with multiple underscores
   that prevent Module::Build from installing on Win32 [David Golden]

 - Fix bug cleaning compatibility Makefile when older ExtUtils::Manifest is
   installed [David Golden with help from David Cantrell]

 Other:

 - Suppressed more warnings from tests [David Golden]

 - Add provisional support for 'package NAME VERSION' syntax added in
   Perl 5.11.1 [David Golden]

0.35_04 - Fri Oct 23 11:20:41 EDT 2009

 Bug fixes:

 - Fix test failure if IPC::Cmd isn't installed [David Golden]

 Other:

 - Suppressed warning messages from various tests [David Golden]

0.35_03 - Wed Oct 21 21:20:59 EDT 2009

 *** API CHANGE ***

 - The prepare_metadata() method used to take a YAML::Node object as an
   argument for modification.  The method now takes no arguments and just
   returns a hash reference of metadata. [David Golden]

 Enhancements

 - Command line options may be set via the PERL_MB_OPT environment
   variable (similar to PERL_MM_OPT in ExtUtils::MakeMaker)

 Bug fixes:

 - Updated PPM generation to PPM v4 (RT#49600) [Olivier Mengue]

 - When c_source is specified, the directory scan will include additional,
   less-common C++ extensions (RT49298) [David Golden]

 - When module_name is not supplied, no packlist was being written; fixed
   by guessing module_name from dist_version_from or the directory name
   (just like ExtUtils::Manifest does without NAME) [David Golden]

 - Bumped IO::File prereq to fix binmode failures in PPMMaker on Perl
   prior to 5.8.8 [David Golden]

 Other:

 - Replaced use of YAML.pm with YAML::Tiny; Module::Build::YAML is now
   based on YAML::Tiny as well [David Golden]

 - Reduced amount of console output under normal operation (use --verbose
   to see all output) [David Golden]

0.35_02 - Mon Sep  7 22:37:42 EDT 2009

 Enhancements:

 - Added 'needs_compiler' property.  Defaults to true if XS or c_source
   exist.  If true, ExtUtils::CBuilder is also added to build_requires.
   [David Golden]

 - File::ShareDir automatically added to 'requires' if 'share_dir' is set
   [David Golden]

 - Added 'Build installdeps' action to install needed dependencies via
   a user-configurable command line program.  (Defaults to 'cpan'.)
   [Eric Wilhelm]

 Bug fixes:

 - Failure to detect a compiler will now warn during Build.PL and be a
   fatal error when trying to compile during Build. (RT#48918) [David
   Golden]

 - Fixed directory sorting failure in share_dir.t [David Golden]

 - Property defaults that are data structures were being assigned as
   references to new objects. Changed so that defaults are cloned instead.
   (This mostly affects testing, which often creates multiple objects in the
   same process) [David Golden]

 - Simplified error message on exit under use_tap_harness [suggested by
   David Wheeler]

 - Fixed typemap search to use a dist-level typemap if a typemap is not
   found in the directory with the *.xs file; (was manifesting as warnings
   in Perl 5.6 tests) [David Golden]

 Other:

 - Replaced guts of new_from_context().  Build.PL is now executed in a
   separate process before resume() is called.  (This is generally only of
   interest to Module::Build or toolchain developers) (RT#49350) [David
   Golden, Eric Wilhelm, Ken Williams]

 - Revised test helper classes to fix potential bugs and add new features
   to make writing tests simpler and easier.  Changes incorporated into
   t/README.pod and t/sample.t as examples for new testing. [David Golden]

0.35_01 - Mon Aug 31 12:11:10 EDT 2009

 Enhancements:

 - Generates MYMETA.yml during Build.PL (new standard protocol for
   communicating configuration results between toolchain components)
   [David Golden]

 - Added 'share_dir' property to provide File::ShareDir support;
   set automatically if a directory called 'share' exists
   [David Golden]

 Bug fixes:

 - Fix the t/destinations.t fix. [David Golden, with thanks to Eric Wilhelm]

 - Fix recursive test files in generated Makefile.PL (RT#49254) [Sawyer X]

 - Guard against trying :utf8 when :utf8 isn't available

 - The "test" action now dies when using the 'use_tap_harness'
   option and tests fail, matching the behavior under Test::Harness.
   (RT#49080) [initial patch from David Wheeler; revised by David Golden]

 Other:

 - Added t/README.pod and t/sample.t to guide developers writing new tests
   [David Golden, with some code from Eric Wilhelm]

 - Module::Build::Compat 'passthrough' style has been deprecated.  Using
   'passthrough' will issue warnings on Makefile.PL generation.  See
   Module::Build::Compat documentation for rationale.

Typo fix

Correctly check that functions flagged as documented do have documentation.

Correct the flags for 3 functions that don't actually have documentation.

Remove dead preprocessor code from toke.c

The symbol FTELL_FOR_PIPE_IS_BROKEN is no longer being used
and should have been removed with the commit 4c84d7f2, which
removed the -P option.

Fix crash in refactored lexer internals

Commit f0e67a1d29102aa9905aecf2b0f98449697d5af3 changed the control
flow so that PerlIO_tell(PL_rsfp) could be called when PL_rsfp was
NULL, which produces a crash at least on Windows with the MSVCRT
runtime.

This change moves the detection if PL_rsfp is NULL or not closer to
the location where is is actually tested, which gets rid of the
crashes.  I however have *not* verified if the changes in control
flow in f0e67a1d are otherwise correct or not.

add op class assertions to newXXXOP functions

Document SIGPIPE when printing to closed socket

Patches to Encode 2.38 to match current test layout

Updated Encode to CPAN release 2.38

Update CPANPLUS::Dist::Build to cpan version 0.42

Update IPC::Cmd to cpan version 0.54

  Changes for 0.54    Sun Nov 15 21:43:51 GMT 2009
  =================================================
  * Fixed issues on older perls requiring Time::HiRes

Inline PL_no_symref_sv into its users. Deprecate the visible global variable.

As the core no longer needs this fixed string outside of pp.c, it seems daft to
make it public just in case any module wants to use it. Modules that do should
provide their own inline copy in future.

Also restore the visible global PL_no_symref_sv back to the original format
specificiation (of 5.10.0 and earlier).

Inline PL_no_symref into pp_entersub. Deprecate the visible global variable.

As the core no longer needs this fixed string in more than one place, it seems
daft to go to the overhead (and cost) of making it public in case any module
wants to use it. Modules that do want to use it should provide their own inline
copy in future.

Also restore the visible global PL_no_symref back to the original format
specification (of 5.10.0 and earlier), as an extra %s has the potential to
cause SEGVs or worse if not spotted at compile time.

lexer API

Attached is a patch that adds a public API for the lowest layers of
lexing.  This is meant to provide a solid foundation for the parsing that
Devel::Declare and similar modules do, and it complements the pluggable
keyword mechanism.  The API consists of some existing variables combined
with some new functions, all marked as experimental (which making them
public certainly is).

Make the style of pad_add_name's flags consistent with pad_new's and pad_tidy's.

Change S_pad_check_dup()'s arguments from char*/STRLEN to SV *.

Within the function, use sv_eq() rather than strcmp().

Convert pad_check_dup() to static linkage, and call it from Perl_pad_add_name().

Provide a flag option to Perl_pad_add_name(), pad_add_NO_DUP_CHECK, to supress
the call.

Refactor common code paths from Perl_pad_add_name() into S_pad_add_name_sv().

The only user of the pad_add_FAKE flag was S_pad_findlex(), so move the relevant
code there from Perl_pad_add_name(), and have S_pad_findlex() call
S_pad_add_name_sv() directly. This eliminates the pad_add_FAKE flag completely.

Change perl -v version format

New format:

  This is perl 5, version 11, subversion 1 (v5.11.1) ...

The rationale for this change is that the Perl 5 interpreter will never
increment PERL_REVISION from 5 to 6, so we want people to start focusing
on the PERL_VERSION number as most significant and PERL_SUBVERSION as
equivalent to a "release number".  In other words, "perl 5" is a
language, this is the 11th version of it, and the second release of that
version (counting from zero).  Among other things, this makes the
output of -v and -V more consistent.

The old v-string style is included for familiarity and usage in code.
For builds from git, it will include the same extended format as it
did before, e.g. "(v5.11.1-176-gaf24cc9*)"

Performance optimisation in assert, suggested by Tim Bunce

Most compilers will store only a single copy of identical literal
strings. So changing that assert to check the pointer first would
significantly reduce the cost.

Teach B::Deparse about in-place reverse

And bump the $VERSION.

Updated File::Fetch to cpan version 0.22

  Changes for 0.22        Sat Nov 14 23:13:16 2009
  =================================================
  * Bumped to stable version

Include legacy.t in the maintainance list

POD fixes and typos

add code for Unicode semantics for non-utf8 latin1 chars

Update to Scalar-List-Utils-1.22 from CPAN

Revert core fixes for IO-Compress following IO-Compress update

With commit 1725f55ba78fb58489ea39e2bc0cc1faffd32275 IO-Compress now puts
its .pm files in lib rather than archlib for perls later than 5.11.1, so
the core can now do likewise given that blead will next be released as
5.11.2, i.e. revert the Configure part of 4cc80fc4cbbd82e20f7b14b68abb53d552076022
and revert f4a6a713802da1b781d7108503156fa3a0fe219e.

This change should not be merged into 5.10.x because IO-Compress will
continue to put its .pm files into archlib for the sake of anyone upgrading
a 5.10.x installation in-place.

[PATCH] IO-Compress 2.022

Message-ID: <4ACFB129.9070900@btinternet.com>

Support $! stringification of socket error codes on Windows.

The winsock error codes from WSAGetLastError() are stored by
Perl in errno, and there is some code in win32_strerror() that
would stringify them, but that code is never called when Perl
is built with the default WIN32IO_IS_STDIO setting.

This patch enables the win32_strerror() override unconditionally
and also fixes a potential memory corruption issue by using
the FORMAT_MESSAGE_IGNORE_INSERTS flag to ignore any parameter
substitution codes that may be embedded in the error message.

This now works as expected:

C:\git\perl>perl -Ilib -MPOSIX -E "$!=POSIX::EWOULDBLOCK; say $!"
A non-blocking socket operation could not be completed immediately.

Fix compiler warning:

p.c: In function `Perl_newATTRSUB':
op.c:5778: warning: cast from pointer to integer of different size

Fix compiler warnings:

pp_sys.c: In function `Perl_pp_tie':
pp_sys.c:788: warning: 'gv' might be used uninitialized in this function
pp_sys.c: In function `Perl_pp_dbmopen':
pp_sys.c:936: warning: 'gv' might be used uninitialized in this function
pp_sys.c: In function `Perl_pp_enterwrite':
pp_sys.c:1274: warning: 'cv' might be used uninitialized in this function
pp_sys.c: In function `Perl_pp_ghostent':
pp_sys.c:4711: warning: 'hent' might be used uninitialized in this function

Fix compiler warnings:

pp_ctl.c: In function `Perl_pp_return':
pp_ctl.c:2092: warning: 'retop' might be used uninitialized in this function
pp_ctl.c: In function `Perl_pp_last':
pp_ctl.c:2214: warning: 'nextop' might be used uninitialized in this function

Fix compiler warning:

scope.c:96:8: warning: extra tokens at end of #endif directive

Fix compiler warning:

pp.c: In function `Perl_pp_delete':
pp.c:4297: warning: 'sv' might be used uninitialized in this function

Updated IPC::Cmd to cpan release 0.52

  Changes for 0.52    Fri Nov 13 16:15:11 GMT 2009
  =================================================
  * Added documentation for run_forked()

Test for a bug in sort where the elements are freed in the sort block.

Refactor and expand unshift.t

[perl #70337] perldiag: localtime(...) too large

The message ‘localtime(...) too large’ is not documented in perldiag.
The attached patch adds it. I know it’s technically ‘%s(%.0f) too
large’, but it’s easier for users to find it under ‘localtime’ and
‘gmtime’. I also had to modify diagnostics.pm to support %.0f, and I
added a test, but I used a hack with STDERR that would make debugging
very difficult to anyone else adding tests.

flock() on Windows should set proper errno numbers.

It used to set errno to GetLastError(), which is from an
incompatible set of error codes.  That doesn't make any
sense, especially since the GetLastError() value is also
available at the Perl level via $^E.

It is important for autodie.pm that flock() will set
$! to WSAWOULDBLOCK when GetLastError() returns
ERROR_LOCK_VIOLATION because that is the value POSIX.pm
now returns for POSIX::EWOULDBLOCK.

flock() should return EWOULDBLOCK instead of EAGAIN.

POSIX requires fcntl() to return EAGAIN or EACCES, whereas BSD
requires flock() to return EWOULDBLOCK.  On most systems EAGAIN
and EWOULDBLOCK use the same number, but on some (e.g. Linux on
PA-RISC) they do not.

PL_scopestack_name needs to be copied in perl_clone()

Make win32_start_child responsible for cleaning all the scopes.

1 is a magic number to C's exit() and Perl_my_exit().

Its real name is EXIT_FAILURE and it comes out of the wash somewhat
differently on VMS than elsewhere.

Updated CPANPLUS to cpan version 0.89_09

  Changes for 0.89_09     Thu Nov 12 21:54:01 2009
  ================================================
  * Only look for missing prereqs in the output of the last
    set of tests that were run. This resolves RT #51408,
    reported by Andreas Koenig

Bring Pod::Simple up to 3.10

This is the same as the version just released to CPAN. Notable changes
are skipping failing tests on VMS and fixing nested definition lists in
the XHTML formatter.

PL_scopestack_name is only defined in DEBUGGING perl

As our $_; is forced into main::, it should warn as a redeclaration.

Explicitly check that our $_; is special, and forced to main::

Sorry, missed a "

HP-UX does not accept UTC0UTC, because there is no valid DST rule

Add line information to jumplevel debug information

Add information about where in the C code the jumplevel poping/setting up was done.

Gerard

From 7b95a19d6fbd3615a034cea79fa087b80e4a9555 Mon Sep 17 00:00:00 2001
From: Gerard Goossen <gerard@ggoossen.net>
Date: Thu, 12 Nov 2009 16:50:13 +0100
Subject: [PATCH] Add line information to jumplevel debug information provided when using -Dl

Signed-off-by: H.Merijn Brand <h.m.brand@xs4all.nl>

Add missing LEAVE to universal.c sv_does

Add missing LEAVE to POSIX.xs sigaction

Add ENTER_with_name and LEAVE_with_name to automaticly check for matching ENTER/LEAVE when debugging is enabled

Updated File::Fetch to cpan version 0.21_02

  Changes for 0.21_02     Thu Nov 12 12:55:57 2009
  =================================================
  * Additional checks for the iosock retriever

Grow zero length scalars

Update File::Fetch to cpan version 0.21_01

  Changes for 0.21_01     Wed Nov 11 23:38:27 2009
  =================================================
  * Added a simple IO::Socket/IO::Select based http retriever,
    based on code suggested by Paul 'Leonerd' Evans

Map winsock error codes to POSIX errno values

Some de-cruftification of README.vms.

readdir() reports file type on VMS, even if zero length.

refactoring of flip.t

Make diag.t skip the warning I just fixed

It's just for MAD anyway.

Update CPANPLUS to cpan version 0.89_08

  Changes for 0.89_08     Tue Nov 10 23:29:06 2009
  ================================================
  * Make the default config prefer Build.PL if perl version is
    greater than or equal to 5.10.1
  * Fix a problem with parse_module() where it would not
    resolve some edge-case distributions, addresses
    http://perlmonks.org/?node_id=805957

  Changes for 0.89_07     Thu Nov  5 14:05:11 2009
  ================================================
  * MYMETA.yml support added from Jos' branch

Clarify and complete documentation for in-place reverse