release_managers_guide: replace =item with =head3

The main body of the Release Manager's Guide is currently just a long list
of steps, each with a '=item *'. Replace these with
    =head3 some description
so that its easier to navigate around.

Also do a few minor structural fixups along the way (eg splitting or
merging individual =item sections).

Also a few typos and bits fixed as I noticed them.

release_managers_guide: add BLEAD-POINT/-FINAL

the Release Manager's Guide talks about three different release types,
RC, BLEAD and MAINT. This is a bit ambiguous for a major release
(e.g. 5.14.0): is it the first MAINT or the last BLEAD?

So, split BLEAD into two:

BLEAD-FINAL - a final release on a blead branch (e.g. 5.14.0)
BLEAD-POINT - a point release on a blead branch (e.g. 5.15.0, 5.15.1)

Then update the whole document to use these tags consistently.

release_managers_guide: remove SNAPSHOT

Now that we make regular blead releases, we no longer need to make
snapshot releases. So remove the instructions for SNAPSHOT that
litter release_managers_guide.pod.

given wasn't calling set magic [RT#84526]

TODO tests for RT#84526 - given needs to handle magical TARG

Revert "Partially revert 4155e4fe"

This reverts commit 7f586e41ad4ecd904c7d8dbe1ddb0f9410484bac.

Revert "silence do_curse() compiler warning"

This reverts commit 82336099d393c4ac04507e58e4402ba9c413f791.

Ignore pod/*.{html,man}

Signed-off-by: Michael Witten <mfwitten@gmail.com>

waitpid doesn't work with WIFSTOPPED

> Quoth Emmanuel Rodriguez:
>> I'm see a strange behavior in the fonction WIFSTOPPED($?) when
>> waitpid($pid, WUNTRACED) is invoked and that the child process
>> receives a stop signal. Under this conditions one would expect that
>> WIFSTOPPED($?) would return a true value, but that's not what is
>> happening. A similar program written in C will have the same macro
>> return true instead of false under the same conditions.
>>
>> I can reproduce this with the default perl provided by Ubuntu 9.10 and
>> OS X 10.6. Which lets me guess that this is not a distro related bug.
>
> This is a documentation error.  POSIX.pod incorrectly claims that
> you can pass the value of $? to WIFEXITED and its relatives.
> You must use the raw status value from ${^CHILD_ERROR_NATIVE} instead.

And here's the patch.  Note that perlvar.pod gets it right already.

/Bo Lindbergh

[perl #90898] B::Deparse failure on glob()

Change d1bea3d changed the way that glob() is converted into
a CORE::GLOBAL::glob call, by preserving the OP_GLOB node, so
that it could still do overloading.

But B::Deparse was never updated to account for the change to
the op tree.

[perl #90160] U* gives ‘U0 mode on an empty string’

This is a regression in 5.10 caused by change 23966/08ca2aa38a29,
which added a bit of faulty logic. It was treating U* in the middle of
a pack template as equivalent to U0, if the input string was empty.

update Math-Complex to CPAN version 1.57

* Add copy constructor and arrange for it to be called
  appropriately, problem found by David Madore and Alexandr
  Ciornii.

* Correctly format polarwise when a numeric format specifier is
  given, problem found by TomC.

* More stable great_circle_direction algorithm, problem found
  by Daniel Burr.

update Time-HiRes to CPAN version 1.9722

- Fix broken linkage on Windows with gcc 3.4 seen with ActivePerl,
  report from Christian Walde [rt.cpan.org #61648], fix derived
  from Vincent Pit.
- Jump through hoops to avoid compiler warnings.

[perl #89896] Locale::Maketext test failure
when environment has variable containing unbalanced brackets

Patch is attached to escape brackets in the value of the environment
variable being used in the test.

In Perl_regdupe_internal() eliminate npar, which is assigned to but never used.

It has been unused since 28d8d7f41ab202dd restructured the regexp dup code.

In S_regpiece(), only declare parse_start if conditional code needs it.

gcc 4.6.0 warns about variables that are set but never read, and unless
RE_TRACK_PATTERN_OFFSETS is defined, parse_start is never read. So avoid
declaring or setting it if it's not actually going to be used later.

In Perl_safesyscalloc(), only declare total_size if conditional code needs it.

gcc 4.6.0 warns about variables that are set but never read, and for most
combinations of conditional compilation options, total_size is never read.
So avoid declaring or setting it if it's not actually going to be used later.

In pp_warn and pp_die, eliminate pv, which is assigned to but never read.

Eliminate C variables unused since 4d0fbddde6c5dcb9 refactored HvFILL()

3 functions had C variables previously used to track whether the number of
hash chains have any entries. 4d0fbddde6c5dcb9 refactored the hash
implementation to calculated this on demand, instead of tracking changes to
it on hash updates. That change missed eliminating those variables, as
gcc prior to 4.6.0 didn't actually warn that they weren't used, because
(technically) they aren't unused - they are assigned to, but never read.

gcc (at least 4.3.2 and 4.6.0) generates identical object code with/without
this change, implying that its optimiser correctly eliminates the code.
Other optimisers may be similar, in which case there's no runtime saving from
this change.

mktables: Put off removing the \N{BELL} conflict

Unicode 6.0 re-used the name BELL for a character other than what it
was traditionally for.  There is code in mktables to change the
treatment for 5.15, so that it wouldn't be forgotten.  But I'm thinking
that we might want to wait til 5.18 to change, and so I just changed it
to 5.17 instead.

[perl #89662] PATCH to perlfunc.pod: select fix

I think it's about time--by say 20 years--that we stop passing around
filehandles as strings, especially if we don't use Symbol::qualify_to_ref()
to fix the package.  Plus it isn't strict-safe.  All fixed now.

I am somewhat concerned about the final comment regarding read
and sysread, as I don't know whether PerlIO encoding translation
issues affect this picture.

--tom

[perl #89660] PATCH to perlfunc.pod: three forgotten prototypes, unforgotten

Improved perlpodstyle docs from tchrist

An editing pass on perlop.pod from tchrist

Subject: [perl #89490] PATCH: perlop.pod

perllol doc updates from tchrist.

This patch is aagainst the "blead du moment".  It fixes various
things, but does not address the "this version" != 5.14 and the
perlio issues.  I believe that these at least should be addressed
as soon as possible (I don't know whether that means 5.14;
probably not).  It has to either say the particular version that
applies.  We can't keep releasing things that say this version:
they are not trustable.

--tom

Update the version of Darwin we know the by_BE locale to be broken on

Add Vladimir Timofeev to AUTHORS

Fix for [perl #90106] 5.14.0-RC2 ODBM_File failures on Ubuntu natty [multiarch]

Ubuntu has juggled lib paths so we get to play games to catch up with
them.

S_sv_unmagicext_flags wasn't declared static either

S_mg_findext_flags wasn't declared static

In S_doparseform(), don't force the pattern to a string. This resolves #79532

Previously S_doparseform() was using SvPV_force(), because the pattern had to
be forced to a string, because the compiled format was stored in the string's
buffer. Now that the compiled format is stored in the magic struct, this isn't
necessary.

Additionally, removing the call to SvPV_force() removes the need to hack with
the SvREADONLY() flag in pp_formline.

Store the compiled format in mg_ptr instead of after SvCUR() - fixes RT #89218

Formats are compiled down to a sequence of U32 opcodes in doparseform().
Previously the block of opcodes was stored in the buffer of SvPVX() after
the raw string by extending the buffer, and calculating the first U32 aligned
address after SvCUR(). A flag bit on the scalar was set to signal this hackery,
tested with SvCOMPILED()

The flag bit used happened to be the same as one of the two used by to signal
Boyer-Moore compiled scalars. The assumption was that no scalar can be used for
both. Unfortunately, this isn't quite true.

Given that the scalar is alway upgraded to PVMG to add PERL_MAGIC_fm magic,
to clear the cached compiled version, there's no extra memory cost in using
mg_ptr in the MAGIC struct to point directly to the block of U32 opcodes. The
test for "is there a compiled version" can switch to mg_find(..., PERL_MAGIC_fm)
returning a pointer, and the use of a flag bit abolished.

Retain SvCOMPILED() and SvCOMPILED_{on,off}() as compatibility for XS code on
CPAN - the first is always 0, the other two now no-ops.

S_doparseform() should return void, not OP*, as it should use Perl_die not DIE

a1b950687051c32e added an error condition in S_doparseform() but used DIE(...)
to report it. DIE is defined as C<return Perl_die>, which acts as a hint to the
compiler about the control flow [as Perl_die() never returns], but also forces
the return type to be OP *. Whilst this is appropriate for pp functions, it's
not for S_doparseform() - a1b950687051c32e had to change the return type to OP*
and return NULL, just to appease DIE(). Hence use Perl_die() instead, remove
return statements, and remove the didn't-return-NULL (dead) code from
pp_formline.

perlreapi: nits

op_reg_common.h: Fix comment

perluniintro: revise text on blocks vs scripts

perlop: Add explanation of \c

perluniprops: specify exact chars in PerlSpace

perlrecharclass: Nits

perlrecharclass: Move table

The table makes more sense moved; some accompanying wording cleanup.

perlrecharclass: Move text about \N

This should come right after the text about '.', as they are related.

perlrecharclass: Extra leading zero in code points

regcomp.sym: Add comment

perlop: Clarify that only ASCII brackets nest

perluniprops: AHex and PosixXDigit are identical

charnames: pod nit

perlfunc: Refer to if.pm from "use"

regcomp.c: change comment wording, from TomC

perlxs: Fix pod errors

perlunicode: Fix pod error

perlport: Fix pod errors

pod/perlfaq2: Fix pod errors

handy.h: Link moved to perlhacktips

README.os2: Fix pod errors

pod/perlinterp.pod: Fix broken link

ext/Devel-Peek/Peek.pm: Fix broken links

dist/Cwd/lib/File/Spec/Win32.pm: Fix broken link

version/Internals.pod: Fix broken links

README.os2: fix broken link

FieldHash.pm: Fix broken links

perlsyn: fix broken link to this

The X<> have spaces between them which was causing the =head to
generate a different anchor than expected

perlop.pod: Fix broken link

The reason there are links broken to this is that the X<>
were part of the heading, and the spaces between them are
significant

perlfaq4: Fix broken link

perlxs: Fix broken link

perlthrtut: fix broken links

perlhack: Fix broken link

perlguts: Fix broken link

README.os2: Fix broken links

Internals.pod: Fix broken link

overload.pm: Fix broken link

perlform: Revise link

The link doesn't have to be to the exact text, can just name the function,
and doing so is clearer.

configpm: Fix broken links

perlsub.pod: Fix broken link

perlguts: Link to internal doesn't need pod name

perlfaq9: Add links to man pages

perlfaq8: Add links to man pages

perlebcdic.pod: Add man page section number to link

perldata.pod: Fix broken link

mathoms.c: pod: fix broken link

vmsish.pm: Fix broken link

Attribute-Handlers: Fix broken link

README.cygwin: Fix broken link

Internals.pod: Fix broken links

README.os2: Fix broken links

perlglossary: Fix broken links

cop.h: pod: Fix broken links

INSTALL: Change name so links to it aren't broken

POSIX.pod: fix broken link

Fix broken link

threads-shared: Fix broken link

perlxstut: Correct NAME

base.pm: pod: Remove obsolete references

INSTALL: broken link

Assertion fails in multi-char regex match

In '"s\N{U+DF}" =~ /\x{00DF}/i, the LHS folds to 'sss', the RHS to 'ss'.
The bug occurs when the RHS tries to match the first two es's, but that
splits the LHS \xDF character, which Perl doesn't know how to handle,
and the assertion got triggered.  (This is similar to [perl #72998].)

The solution adopted here is to disallow a partial character match,
as #72998 did as well.

release_managers_guide: feedback from 5.15.0 bump

The version bump from 5.14.0 to 5.15.0 didn't go at all smoothly.
Update release_managers_guide based on that experience.

Basically there were a couple of catch-22 situations with auto-generated
files; namely uconfig.h and the pod/perl5150delta.pod link.

Also, I've split the 'bump bleed to 5.15' and 'make maint-5.14 branch'
instructions into two separate sections.

buildtoc - fix a bug and add some comments

while(readdir) doesn't auto-assign to $_

Also, make the informative output clear that its telling you like of files
it will be processing, rather than that its actually processing it now.

Bump the perl version in various places for 5.15.0

update TOC for perl5150delta

create perldelta for 5.15.0