much better git related version numbering in our (*nix for now) build process

The net result of this patch is to make available via Config.pm and -v/-V the
details about the git version info we have available for the build. When built within
a git repository git is queried directly. When built from a snapshot or bundle
it is assumed that the source is unchanged, and that the required details are
avaialble in a file called .patch, whose format current is a four field string
in the following format: "$branchname $date.$time $sha1 $describe". The
generator of these files currently resides on camel.booking.com.

* git-describe is now used more directly with -v.
When the prefix of git-describe matches the version number
as determined by the defines in patchlevel.h then we use ONLY
the git-describe output, otherwise we include
the git describe in parenthesis after the version number. Either way
the describe text is optionally followed by a star should there be
uncommitted changes.
eg: This is perl, v5.11.0 (GitLive-blead-136-g58ca560) built for i686-linux
or: This is perl, v5.11.0-1-g58ca560 built for i686-linux
or: This is perl, v5.11.0 built for i686-linux

* include the SHA1 in perl -V summary, and automatically include unpushed
commits in the registered patches list

* include various git/version/.patch details in %Config, as follows:

git_commit_id             # sha1 of HEAD
git_ancestor              # ancestor in $remote/$branch (presumably canonical)
git_describe              # git describe
git_branch                # current branch
git_uncommitted_changes   # "true" if there are any, empty otherwise
git_unpushed_commits      # List of sha1's of unpushed commits
git_commit_id_title       # Used to make the perl -V summary output

Additionally one more value is added depending on build process used: when
building from an rsynced snapshot (or any dist including a file called
.patch) then the second field will be used to populate the
"git_snapshot_date" field. Otherwise if built in a git directory (as is hopefully
recommended these day) then the field will be "git_commit_date" which will be the
commit date of HEAD.

This patch introduces two new files (on top of .patchnum) that will be generated by
make_patchnum.sh: "lib/Config_git.pl" and "unpushed.h", the former is used to make
git data available to Config.pm/%Config without rebuilding everything else, and the
second is used to expose unpushed commits (if any) via the registered patch facility
of patchlevel.h

added information how to build on Leopard

In mro_get_mro, use the length and UTF-8-ness now contained in struct mro_alg
when generating an SV containing the name.

Mark my dual-life modules as authoritative in blead

PL_registered_mros can start with 1 hash bucket, as it will probably never
contain more than "dfs", and even if C3 is loaded, 2 buckets are less than the
default of 8.

Bump switch version to 2.14

Make Switch.pm skip POD like perl does

Patch provided by Daniel Klein <danielklein-à-airpost.net> :

  It also doesn't check for invalid POD which gets ignored by the
  compiler anyway.

Seems that Damian had a POD parser in mind when he devised those
regular expressions, but perl only looks for =cut followed by a
non-letter.

Fix line numbering issues with POD filtered by Switch.pm

Patch provided by Daniel Klein <danielklein-à-airpost.net> :

  I noticed a very subtle bug in the code: it filters out all detected POD
  from the source code. This means that any line number reporting after
  POD code will be out by the number of POD lines removed. So if there is
  an error or a "warn"ing in the code it will be harder for the programmer
  to track down.

Switch.pm doesn't appear to support plain arrays and hashes in case().

Let us direct Switch questions to P5P.

I still can release versions of Switch to CPAN, but I prefer
to consider the blead version canonical.

Handle non-numeric version numbers in ext/Digest/MD5/Makefile.PL

Also define 'localizing' in pp_helem for the sake of clarity

On scope end, delete localized array elements that should not exist anymore, so that the array recovers its previous length. Honour EXISTS and DELETE for tied arrays.

Add save_adelete()/SAVEADELETE() to save on the stack an array element delete

Introduce SvCANEXISTDELETE in pp.h, which simplify the logic in pp_helem and pp_hslice

Fix malformed utf8 in regexec.c

Revise malformed utf8 test case

Add casts to gain C++ compatibility, as spotted by Yves.

Add a key flag HVhek_KEYCANONICAL for Perl_hv_common(), which signals that the
key is in canonical form - any key passed encoded in UTF-8 cannot be represented
as bytes, hence the downgrade check can be skipped. Use this internally for
shared hash key scalars, as they are always canonical.

Verify that pre-computing hashes with shared hash key scalars does not cause
problems.

Also test Perl_hv_common() and pre-computed hashes for SV keys.

Precomputing the hash value for a string representable in bytes, but passed in
in UTF-8, would result in storing the wrong hash value in the hash, and hence
failing lookups. I guess not that much XS code precomputes hash values.

Fix typo in code not yet used.

Move all mro:: XS functions from mro.c to ext/mro/mro.xs, except for
mro::method_changed_in(), which is used by constant.

In struct mro_meta, rename mro_linear_dfs to mro_linear_all, and change it from
AV * to HV *.

In struct mro_meta, rename mro_linear_c3 to mro_linear_current, and change it
from AV * to SV *.

Break out the set-the-MRO logic from the XS_mro_set_mro into Perl_mro_set_mro(),
which can be called from C code (such as the guts of extensions).

Optimisation of the use of the meta structure - don't create a hash if all we
are dealing with is data for the current MRO. Instead the direct pointer "owns"
the (reference to the) data, with the hash pointer left as NULL to signal this.

Remove the comment that the mro:: functions are actually in the core
interpreter, hence you don't actually need to use mro;
This should have remained an implementation detail, as it limits the scope to
move things around within a stable branch. So for now, remove the expectation.

Proper pluggable Method Resolution Orders. 'c3' is now implemented outside the
core, in ext/mro/mro.xs. Also move mro::_nextcan() to mro.xs. It needs direct
access to S_mro_get_linear_isa_c3(), and nothing on CPAN calls it, except via
methods defined in mro.pm. Hence all users already require mro;

Explictly export Perl_mro_meta_init() so that HvMROMETA() can become part of the
public API and be used outside the core. However, leave Perl_mro_meta_init() as
a private implementation detail.

Add Perl_mro_register() to register Method Resolution Orders,
Perl_mro_get_from_name() to retrieve MROs by name, and PL_registered_mros to
store them in. Abolish the static array of mros, and instead register the dfs
and c3 MRO structures.

Add MRO_GET_PRIVATE_DATA() to use the cached mro private data where possible.

Repurpose struct mro_meta to allow it to store cached linear ISA for arbitary
method resolution orders.

mro_linear_dfs becomes a hash holding the different MROs' private data.
mro_linear_c3 becomes a shortcut pointer to the current MRO's private data.

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

fix problem on some platforms

Tweak make_patchnum.sh to cope with /bin/sh on Solaris 9, in particular errors
most hateful in the man page for test.

tweak dependency

fix bug #57042 - preserve $^R across TRIE matches

ignore bugBLAH.pl files as they are likely dev/test/debugging byproduct

better .patchnum/.sha1 dependency stuff

hopefully this makes FreeBSD happy

add cflags as a dependency for all object files. (it is used to control the arguments they are compiled with)

apparently this isnt necessary after all.

make make_patchnum.sh (more) portable

rebuild cflags if cflags.sh changes

come new version related code in perl.c is not enabled -- explain why

remove .sha1 file as well if necessary

forgot that i was modifying a generated file

add a newline for clarity

better git based version numbering (hopefully sane)

tidier -v output

make git-describe info show up in -V output in the "Characteristics of this binary" section.

Generate .patchnum from .patch or .git

slightly smarter make_patchnum logic, detect if there are changes to the working directory so we dont lie about our version

smarter make_patchnum.sh, get the .patchnum from the .patch file if it exists

clean up .patchnum in make clean

fix broken indentation, and move PERL_PATCHNUM logic to a different place so it only affects perl.c

more build dependency changes, we should make sure that cflags is updated whenever cflags.SH changes

make sure that the perl -v/-V output corresponds to the latest commit

Remove "b" flag for sv_utf8_upgrade_nomg in embed.fnc

This is only a macro, without a Perl_ implementation.
Hopefully this fixes the Win32 build.

sv_dup(): avoid cloning empty arrays

Testing the ARRAY pointer is insufficent.  Arrays emptied by 'shift' or
'pop' may still have non-NULL 'ARRAY' pointers.  Check more carefully to
determine whether the array has anything worth duplicating.  If not, reset
the FILL and MAX offsets to -1 just as 'undef @ARRAY' would.

This avoids potential corruption in the PL_ptr_table during perl_clone().

Regen docs and headers

Necessary after change fe749c9aa803ce74d997ff797103481a55741837

Fix two pod links

Update comments and documentation dealing with utf

Upgrade to podlators 2.2.1

The string "." cannot possibly contain a PATH sepatator, so don't tell S_pushinc
to go searching for one. (And the analagous change for MacOS classic.)

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

Better fix for bug #6665

Add a parameter to S_incpush to indicate if the new directory should be
appended or prepended to @INC, and use it set to TRUE when parsing the
shebang line.

There is also a better version of the test.

This replaces commit ccb8f6a64f3dd06b4360bc27c194b28e6766a6ad.

Revert "[perl #6665] Different behavior using the -Idir option on the command line and inside a perl script"

This reverts commit ccb8f6a64f3dd06b4360bc27c194b28e6766a6ad.

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

Remove mentions of the old way of rsync'ing the source

Some additions to perlrepository.pod

mention git cherry-pick
mention git checkout <file> and git-reset
fix a command example
and formatting nits

autodie information added to Maintainers.pl

Add description of last commit in perldelta

(see ccb8f6a64f3dd06b4360bc27c194b28e6766a6ad)

[perl #6665] Different behavior using the -Idir option on the command line and inside a perl script

Adds the -Idir at the beginning of @INC.

(Plus a test by rgs -- check that -I does not add directories at the end
of the @INC array anymore)

Use the F formatting codes for filenames in pod/perlguts.pod.

Lies, damn lies and end-of-block comments

From: Michael G Schwern <schwern@pobox.com>
Date: Fri, 26 Sep 2008 00:06:31 -0400
Message-ID: <48DC5FC7.3000807@pobox.com>

I was reading reentr.h and noticed a lot of the endif's for the
HAS_XXX_R macros were wrongly indented and their comments had the
wrong condition.

The attached patch fixes the indentation and removes all but the last
comment which is shortest and furthest from its start.  No point in an
end-of-block comment on a one statement block, just falls out of date
and obscures the structure.

(plus "make regen")

Some source files and documentation files need not to be executable

Be less picky about what constitutes "numeric lists" in Pod; This allows "64bit" to not trigger the "numeric" match in a description list, for instance.

Blank lines "between" verbatim sections are now acceptible; This allows code examples to have indented blank lines without Pod::Parser carping.

Remove completed perltodo entry

Remove all mention of checkpods

Minor pod fixes to make Pod::Checker happy with the core pod

Applied with some amendments to the perlfunc corrections.
PerlFAQ modifications will be applied separately.

Move 'make check' in pods/ to using Pod::Checker

Make PERL_PATCHLEVEL a single value quoted string

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

Merge branch 'blead' of camel.booking.com:/gitroot/perl into blead

Subject: Patch for hints/netbsd.sh

From: "Ulrich Habel" <rhaen@netbsd.org>
Date: Tue, 23 Dec 2008 14:36:26 +0100
Message-ID: <9fd3126e0812230536x3f8a84bagbb1b4dcddb399bf5@mail.gmail.com>

Remove inconsistent formatting in pod/perlrepository.pod with Porting/podtidy

Add a new Porting/podtidy to reformat pod using Pod::Tidy

Add a section on committing to maintenance versions

Note the --author option of git commit, and therefore explain how to apply raw diffs.

POD nits from Frank Wiegand <frank.wiegand@gmail.com>

A short introduction to git bisect.

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

Document how commiters can keep 'origin' as a git remote and push with another ssh remote.

add a comment about git clean to the perlrepository.pod

Note the correct way to make a branch to track a remote branch.

Update Changes with the last 432 Perforce applied changes, finishing with 35120

Add the perlperf manpage, by Richard Foley