perldiag: reflow an entry

perldiag: Move the \p{} entry

perldiag: sort some entries

perldiag: missing article

perldiag: remove repeated reference

perldiag: reflow ‘Number with no digits’

perldiag: missing dot

perldiag: reflow ‘Non-octal character’

perldiag: reflow; missing dot

perldiag: punctuation and formatting

perldiag: reflow ‘Invalid hexadecimal number’

perldiag: resort some entries

perldiag: missing hyphen

perldiag: reflow a couple of entries

perldiag: Make two entries for my/state and pkgs

Not only was it not put in alphabetical order when "my" was changed to
"%s" on the introduction of state variables, but it’s easier to find
them if there are two entries.

perldiag: retitle Ambiguous use of %c{%s%s}

This is not very helpful:

=item Ambiguous use of %c{%s%s} resolved to %c%s%s

especially since it is functionally identical to the previous entry:

=item Ambiguous use of %c{%s} resolved to %c%s

Not only can diagnostics.pm never find it, but it is hard for human
beings to understand what the different is at first glance, too.

So filling in the second and fourth %s’s with the two possible values
slays a twain of avians with one piece of petrified matter.

perldiag: reflow ‘Missing right brace on \N{}’

for ‘use diagnostics’ output on eighty-column terminals

perldiag: reflow ‘Missing braces on \N{}’ for 80 cols.

perldiag: sort the ma* entries

perldiag: whitespace; grammar

perldiag: an number -> a number

That’s my own typo.

perldiag: reflow ‘Lexing code attempted to stuff...’

for the sake of diagnostics.pm, which displays the link simply as
lex_stuff_pvn_flags.

Silence win32 smoke compiler warning

Silence util.c compiler warning from win32 smokes

perldiag: Suggest use re '/m' for $*

perldiag: reflow $* and $#

perldiag: more typos and grammar

perldiag: fewer, not less

(plus a bit of reflow)

Reflow perldiag/Invalid separator...

for an eighty-column terminal under ‘use diagnostics’

Mention mro plugins in perldiag

and reflow the entry

Sort some perldiag entries

List all proto chars in perldiag

The description for ‘Illegal character in prototype’ did not include
the new + prototype.

perldiag: Reflow ‘Having no space...’

This does not fit in an eighty-column terminal under ‘use
diagnostics’.

Reflow perdiag/()-group...

This does not look very good:

$ ./perl -Ilib -Mdiagnostics -e 'warn "()-group starts with a count"'
()-group starts with a count at -e line 1 (#1)
    (F) A ()-group started with a count.  A count is
    supposed to follow something: a template character or a ()-group.
     See "pack" in perlfunc.

perldiag: copy/paste error

When the ‘Filehandle opened only for output’ message is displayed, the user is trying to read from the handle, so saying ‘instead of "<" or nothing’ does not make sense, as it would not have produced the error.

perldiag: missing article

Replace mention of MacPerl with Symbian

Improve perldiag/Eval-group not allowed at runtime

• Mention use re 'eval' within the description
• Improve text flow

perldoc improvements for map

Add Alexander Hartmaier to AUTHORS

Remove some whitespace pod warnings in perluniprops.pod

ignore extensions based on the configuration

actually handle the case of extensions being built statically

Correct perldiag/Died

‘die’ does not look at $_.

Reflow perldiag/Deprecated character in \N{...}

It wraps on a 80-character terminal under ‘use diagnostics’.

Resort some perldiag entries

According to the description at the top, non-alphabetic characters and
%-format characters are ignored in alphabetisation.

More perldiag grammar tweaks

Delete perldiag/Can't unshift

This error message was removed by commit 49beac4814c9f4 fourteen
years ago.

Make diagnostics.pm understand messages sharing descriptions

We currently have entries in perldiag like this:

=item Code point 0x%X is not Unicode, may not be portable

=item Code point 0x%X is not Unicode, no properties match it; all inverse properties do

(W utf8) You had a code point above the Unicode maximum of U+10FFFF.

...

diagnostics.pm needs to know that the description applies to the first
=item, as well as to the second.

more perldiag grammar/punctuation tweaks

Add Larwan Berke’s other address to checkAUTHORS.pl

Correctly list the allowed modifiers in the (?...) construct

Reflow perldiag/Can't find Unicode property

so it appears slightly less unsightly under ‘use diagnostics’.

regex: Deprecate \b{ and \B{

This allows future use by Perl of these

regcomp.c: include { in unregcognized \q{ warning

The warning message about regex unrecognized escapes passed through is
changed to include any literal '{' following the 2-char escape.
e.g., "\q{" will include the { in the message as part of the escape.

Improve diagnostics.pm’s link rendering.

The number of L<foo/bar> links in perldiag has grown over time, and
diagnostics.pm has never been updated to render them nicely, resulting
in output like this:

Lexing code attempted to stuff non-Latin-1 character into Latin-1 input at
  lib/diagnostics.t line 36 (#3)
     (F) An extension is attempting to insert text into the current parse
     (using lex_stuff_pvn_flags|perlapi/lex_stuff_pvn_flags or similar), but
     tried to insert a character that couldn't be part of the current input.
     This is an inherent pitfall of the stuffing mechanism, and one of the
     reasons to avoid it.  Where it is necessary to stuff, stuffing only
     plain ASCII is recommended.

I’ve implemented some rudimentary L<> parsing, which should suffice
for perldiag. I think using a real POD processor would be overkill.

Delete perldiag/Can't declare class for non-scalar

This message no longer occurs as of d5e98372e6efc4, which was included
in 5.12.0.

Delete perldiag/Can't call method in empty package

This message has not been produced since ac91690fe10ac7691f6f, four-
teen years ago!

perldiag: Combine nearly identical entries

These entries--

=item Can't coerce %s to integer in %s
=item Can't coerce %s to number in %s
=item Can't coerce %s to string in %s

--can be combined into one. Currently, they say exactly the same
thing, except that the first one has more detail. Consequently,
diagnostics.pm will sometimes provide more, and sometimes less, infor-
mation, which is suboptimal.

perldiag: pseudo-hashes are long gone

perlfaq7: there are no empty packages any more

perldiag: typos

perldiag: be realistic

perldiag: typos and slight English improvements

Correct perldiag/Ambiguous use of -%s

Use of -foo to mean "-foo" is valid even in strict mode.

Add info to perlhist.pod for 5.12.{2,3}

Clarify perldiag/Ambiguous use of %c{%s%s}

${foo[2]} only warns with built-in keywords. (See the source in
toke.c:S_scan_ident which uses keyword().)

The suggested use of $foo[2] instead of ${foo[2]} does not
always work.

I also added an ‘and’ to clarify the existing text.

Clean up perldiag/Ambiguous use resolved as operator

This entry was missing some words. I supplied them, fixed spelling
mistakes, and reflowed it to look good under -Mdiagnostics.

Bump re.pm’s version

perldebug: capitalise titles

The capitalisation was rather inconsistent throughout.

Fix links to POD sections

perldebug: perl no longer includes the emacs mode

perldebug tweaks

Update CPANPLUS to CPAN version 0.91

  [DELTA]

  Changes for 0.91        Fri Feb 11 22:43:31 2011
  ================================================
  * Making a stable release

  Changes for 0.90_13     Mon Feb  7 10:26:35 2011
  ================================================
  * Fix Parse::CPAN::Meta prereq version

  Changes for 0.90_12     Sun Feb  6 19:48:49 2011
  ================================================
  * Remove more trailing whitespace spotted by Nicholas Clark
    with patch to fix, RT #64976
  * Added META.json and MYMETA.json support. Requires a more
    recent Parse::CPAN::Meta
  * Switch to Digest::SHA and SHA256 checksums instead of
    Digest::MD5 and MD5, which has dropped v5.6.x support.

perldebguts tweaks

perldbmfilter tweaks

• ‘Each’ is singular
• ‘If not’, not ‘in not’

perldata: remove duplicate text from adjacent sections

perlfunc/eval: $@ is now set after unwinding

perlfunc: hyphenate a compound adjective

perldata: retitle a section

The ‘Array Joining Delimiter’ section is about array interpolation in
general, not just the $" variable.

perldelta: ‘package;’ is no longer supported

perldata tweaks

Add Version::Requirements as a dual-life module

Version::Requirements version 0.101020 has been added as a dual-life
module.  It provides a standard library to model and manipulates module
prerequisites and version constraints as defined in the CPAN::Meta::Spec.

It is a prerequisite for CPAN::Meta, which will be used by the Perl
CPAN Toolchain to standardize interactions with META and MYMETA files.

retab t/porting/checkcase.t

t/porting/checkcase.t should skip directories

We should only care about directory case to the extent
it causes an actual file collision, so we can safely skip
directories and let the file collision tests find issues for us.

perlcompile tweaks

• Hyphenate compound adjectives
• Missing word

perlcommunity: punctuation and capitalisation

perlcommunity: capitalise consistently

perlclib: similar to, not similar as

Relation between overloading and ties: second try

The current text is confusing as it refers to tied values. Variables, not values, are tied (don’t bring up handles, please!).

Revert "The relation between overloading and ties has been fixed."

This reverts commit c378af320498199f011ee6aca32cef036936dd36.

Other parts of the document still refer to this. More edits are
fifthcoming.

The relation between overloading and ties has been fixed.

typo in perldiag

Prevent destructors called from gp_free from seeing freed SVs

perl5.13.9 -e 'local *foo; $foo = bless[]; (); DESTROY { use Devel::Peek; Dump $foo; }'

This prints:
SV = UNKNOWN(0xff) (0x8044dc) at 0x8044e0
  REFCNT = 0
  FLAGS = ()

If I do anything with $foo inside the destructor, such as
‘local $foo’, it crashes, of course.

gp_free (called when *foo is being unlocalised on scope exit) does
SvREFCNT_dec(gp->gp_xv) on each of its slots.

SvREFCNT_dec(gp->gp_sv) lowers the refcount of $foo to zero, which
causes the object it references to be destroyed, too. The objects
destructor sees the same $foo still there in the typeglob.

This commit changes gp_free to use a loop, the way S_hfreeentries
(in hv.c) does, checking that everything has been freed before exit-
ing the loop.

(The one-liner above is a reduced version of

perl -MWWW::Scripter -e '$w = new WWW::Scripter; $w->use_plugin(JavaScript); $w->get(q|data:text/html,<a href onclick="throw new Error(&quot;XMLHttpRequest&quot;)">|); $w->document->links->[0]->click'

which involved *@ and a destructor localising $@.)

perl #82278: Overload documentation: many changes This is a partial rewrite to address long standing issues and comments that this document is confusing, in addition to accurately documenting the behaviour of fallback and nomethod in the context of overloaded operands of different types, as implemented in the fix for bug #71286. Fixes many mistakes, ambiguities, and omissions. Most of the early part of the document has been restructured and revised. For the full list of changes, see bug #82278.

[perl #77692] substr causes panic: sv_len_utf8 cache...

pp_substr contains this comment, which was added in perl 5.0 alpha 2
(commit 79072805bf63):

    PUSHs(TARG); /* avoid SvSETMAGIC here */

Calling set-magic when substr returns an lvalue will cause its argu-
ment to be stringified even if the lvalue is not assigned to. That’s
why set-magic has to be avoided.

But the result is that utf8 caches (stored in magic) on TARG are not
reset properly.

Since substr lvalues now follow a different code path (and do not use
TARG at all), it’s perfectly safe to call set-magic at this point.
It’s also the right thing to do in case of other types of magic that
might get attached to TARG.

exporting a static function doesn't work

In test.pl, validate that require_ok() and use_ok() are called correctly.

It only provides a subset of the Test::More functionality, but could
inadvertently be used in a way which is not compatible with Test::More, which
is not the intent.

Fix up \cX for 5.14

Throughout 5.13 there was temporary code to deprecate and forbid
certain values of X following a \c in qq strings.  This patch fixes
this to the final 5.14 semantics.

These are:

1) a utf8 non-ASCII character will croak.  This is the same
behavior as pre-5.13, but it gives a correct error message, rather than
the malformed utf8 message previously.

2) \c{ and \cX where X is above ASCII will generate a deprecated
message.  The intent is to remove these capabilities in 5.16.  The
original agreement was to croak on above ASCII, but that does violate
our stability policy, so I'm deprecating it instead.

3) A non-deprecated warning is generated for all other \cX; this is the
same as throughout the 5.13 series.

I did not have the tuits to use \c{} as I had planned in 5.14, but \N{}
can be used instead.

dquote_static.c: Add comment