autodoc.pl: Don't list undocumented deprecated fcns in API

autodoc creates a list of all the undocumented functions that are part
of the API.  It omits ones that are experimental and whose API may
change; and now it omits ones that are deprecated (and whose API is
planned to change to be non-existent)

autodoc.pl: Add note for deprecated functions

This causes each deprecated function to have a prominent note to that
effect in its API documentation.

embed.fnc: Slight clarification in comments

Add tests for case-change macros API

Use new case changing macros

The previous commit added macros to do some case changing.  This
commit uses them in the core, where appropriate.

handy.h: Add some macro definitions

These macros fill in all the missing case changing operations.  They
were omitted before because they are identical in their input domains to
other operations.  But by adding them here, that detail no longer need be
known by the callers.  toFOLD_LC is not documented, as is subject to
change

pp.c: Nit in comment

perlclib.pod: Update character class macro descriptions

Much has changed since this pod was last updated.

perlclib.pod: Fix too long verbatim lines

perlapi: Add docs for some case-changing macros; clarify others

The case changing macros are now almost all documented.  The exception
is toUPPER_LC, which may change in 5.19

In addition the functions in utf8.c that these macros call now refer to
them instead of having their own documentation.  People should really be
using the macros instead of calling the functions directly.  I'm not
deprecating the functions because I can't foresee the need to change
them, so code that uses them should continue to be ok.

Remove perlsh, which is neither installed nor referenced anywhere.

Described as a "poor man's perl shell", it is unreferenced, and virtually
unchanged since its addition in perl 2. As it is never installed, it's not
used by anyone.

Update Test-Harness to CPAN version 3.27

  [DELTA]

  3.28    2013-05-02
          - Bugfix: Fix taint failures on Windows (Jan Dubois)

  3.27    2013-04-30
          - Dramatically reduce memory usage (Nick Clark, RT #84939)
          - Store test_num (in Grammar.pm) as a number instead of a string.
            Reduces memory usage (Nick Clark, RT #84939)
          - PERL5LIB is always propogated to a test's @INC, even with taint more
            (Schwern, RT #84377)

The local modifications to t/source.t are retained. [rt.cpan.org #64353]

handy.h: Add missing toFOLD_utf8 macro

This corresponds to the other case changing macros

handy.h: define some synonyms for consistency

Other macros have these suffixes, so for uniformity add these.

regcomp.c: White-space only

Change this to follow perl coding conventions

mg.c: White-space only

I found re-formatting this multi-line 'if' to be easier to understand

toke.c: Remove redundant test

This checks that something is both not-printable and not a word
character, but all word characters are printable, so just the
non-printable test suffices.

t/porting/regen.t: Add file to check

handy.h: Clarify comment

regcomp.c: White-space only, wrap comment to fit

mktables: Fix typos in comments

One of these fixes is for where a real CTRL-X was specified, instead of
$^X

utf8.c: Remove redundant assignment.

This variable is always set just below.

t/TEST: Don't bail if fails in t/base unless minitest

In order to completely compile Perl, many modules must have been parsed
and compiled, so if there is a full perl, we know that things basically
work.  The purpose of bailing out is that if these supposedly very base
level functionality tests don't work, there's no point in continuing.
But over the years, tests of more esoteric functionality have been
added here, and if one of them doesn't work, it still could be that Perl
pretty much does work.

I believe it would be best to move such non-basic tests elsewhere, but
that's work, and hasn't bitten us much so far; this change lessens the
severity of the biting even more.  Where it will really bite is if
things are so bad that a full perl binary can't be compiled, and we are
trying to figure out why using minitest.

t/porting/bincompat.t: Typo in comment

utf8.c: Use mnemonics instead of hex numbers

charnames: fix nit in comment

Remove double space between words in pod

podcheck.t: Avoid misleading error message

If there are input files on the command line that don't exist, prior to
this commit, the message was output that they are transitory.  This adds
a check and a correct message.

lib/utf8.pm: Fix pod verbatim line wraps

lib/utf8.pm: Pod clarification and nit

Add missing test for regex parse error

regcomp.c: Use mnemonic instead of number

toke.c: VALID_LEN_ONE_IDENT only needs a char, not a char*

Rather than passing s and having the macro do a bunch of *s,
just pass and expect *s.

toke.c, S_intuit_method: Minor parsing speedup for 'maybe_method $foo'

This commit moves a scan_word() closer to when it's actually used,
which provides a minor speedup for things like 'new $foo' or
'is $foo, $bar'.

toke.c: Call base macro that does the same thing

SPACE_OR_TAB is the same thing as isBLANK, or perhaps more clearly
isBLANK_A.  And these latter macros only have one branch instead of 2
(but some extra masking)

add new perldelta

bump version to 5.19.1

perldelta: 5.19.0, shortest perldelta ever?

update corelist for Getopt::Std, utf8

Bump $Getopt::Std::VERSION following commit 0c0a84c65e572a92.

Document getopts before getopt, and de-recommend getopt.

utf8: Remove unused variable (%utf8::enc).

In its original implementation in perl 5.6, 'use utf8' accepted
an encoding argument, which was saved in %utf8::enc and later
used by utf8_heavy.pl to load the right files from lib/unico[rd]e.

However, since 5.8 (or more specifically, 15732964418f),
utf8_heavy.pl stopped using that variable, so there's no reason
to keep it around in utf8.pm.

Bump $VERSION in lib/utf8.pm.

perlhist for 5.19.0

bring in the 5.18-related epigraphs

update Module::CoreList for 5.19.0

and its mass removal!

Removed cpan/File-CheckTree

Removed cpan/Text-Soundex

regenerate known pod issues

Removed cpan/Log-Message

Removed cpan/Log-Message-Simple

Remove cpan/Object-Accessor

Remove cpan/Term-UI

Remove cpan/Module-Pluggable

Remove cpan/Pod-LaTeX and pod2latex utility

Remove cpan/B-Lint

Remove cpan/Archive-Extract

  Note:

    Porting/core-cpan-diff refactored to use Archive::Tar
    instead of Archive::Extract

Remove cpan/CPANPLUS and associated utilities

Remove cpan/CPANPLUS-Dist-Build

Remove core references to SVt_BIND

This scalar type was unused.  This is the first step in using the slot
freed up for another purpose.  The slot is now occupied by a temporary
placeholder named SVt_DUMMY.

perlpacktut: nit

Fix compiler warnings in regcomp.c

Perform all the "bump us to 5.19.0" work

...I hope.

regenerate META.json

regen feature.pm

bump the perldelta version

bump version to 5.19.0

final version and perlhist update for 5.18.0

update perlexperiment

- fixed a typo (%H instead of %^H)
- removed mention of Unicode support, which is so deep that I doubt that
  it could ever be removed
- added the following items to the "Current experiments" section
  - alloccopstash
  - cop_store_label
  - gv_fetchmethod_*_flags
  - op_scope
  - op_lvalue
  - Smart match (~~)
  - Lexical $_
  - Array and hash container functions accept references
  - Regular Expression Set Operations

- moved the following items to the "Accepted features" section
  - fork() emulation
  - Weak references
  - Internal file glob
  - 64-bit support
  - die accepts a reference
  - DB module

- moved the following items to the "Removed features" section
  - GetOpt::Long Options
  - 5.005-style threading
  - Test::Harness::Straps
  - perlcc
  - Assertions
  - The pseudo-hash data type

I tried to add the corresponding Perl versions of when features were added
and accepted or removed, but used the stable versions as I searched in the
perldelta's.

fix wrong tense

update the release schedule

perldelta: document known failure on HP-UX 11.00

bump patchlevel and perlhist for RC4

perldelta: restate the changes to ${x} versus $x

Credit for improvements made in this commit to to khw.  Blame for
anything else goes to rjbs.

perldelta: Clarify removal vs deprecation of modules

perldelta: Use 'Here doc' consistently sans dash

This corresponds to perldiag, and was suggested by Zsbán Ambrus.

Fix typo in perldelta

Spotted by Zsbán Ambrus

perldelta clarification

expand documentation of the \cK change

perldelta: add another hash overhaul cross reference

Clarified perldelta entry for UID/GID magic variables

Address [perl #117999] for now by skipping known bad test on AIX

perldelta: various fixes suggested by Dave Mitchell

perldelta: remove a literally incorrect "literal"

perldelta: collapse a bit of vertical space

perldelta: clarify the deprecation of non-PerlIO perl

Spelling correction.

perldelta: add obituary for AMORETTE

perldelta: minor nitpicks

bump patchlevel to RC3, update hist

fix extrefs text with SDK 2003

The attached patch (also inlined below) fixes the SDK2003 test failure
for me, and also passes with all the other VC++ compilers. (It isn't
easy trying to pinpoint the SDK2003 compiler individually, so it is
simpler to just do this for all VC++ compilers on Windows.)

perldelta: fix reported new version of Carp

[perl #117141] sometimes we just can't make fork fail, skip the test

bump patchlevel to RC2, update hist

perldelta: remove the "from version X" from module updates

too many were incorrect

perldelta: combine, merge, and edit "modules updated"

update CoreList for new Pod::Simple in 5.18.0

Update Pod-Simple to CPAN version 3.28

  [DELTA]

2013-05-04   David E. Wheeler <david@justatheory.org>
  * Release 3.28

  Removed use of 'done_testing' in t/white.t, which was added in
  v3.27. Thanks to Paul Howarth for the catch.

  Fixed inproperly calculated number of skipped tests in t/xhtml01.t
  when HTML::Entities is not intalled.

2013-05-03   David E. Wheeler <david@justatheory.org>
  * Release 3.27

  Added new warnings as defined by Pod::Checker, thanks to RJBS:
  + "=over" without "=back"
  + "L<>" starts or ends with whitespace
  + raw "|" or "/" in "L<text|link>" text

  Added ->keep_encoding_directive, which is false by default, to
  prevent formatters from emitting a document's '=encoding'
  directive in most cases. That they emitted the encoding was a bug
  introduced in v3.26 (RT #84093). Now, only the DumpAsText and
  DumpAsXML formats set it to true. Patch from Patrice Dumas.

bump the version on Module::CoreList

set the patchlevel to RC1

perlhist: update for 5.18.0-RC1

including the "selected sizes" for 5.18.0