This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perl5.git
2 months agosmall wording fixes for perldelta
Karen Etheridge [Sun, 22 May 2022 20:12:46 +0000 (13:12 -0700)]
small wording fixes for perldelta

2 months agobump version to v5.36.0 (RC3) v5.36.0-RC3
Ricardo Signes [Sat, 21 May 2022 22:44:57 +0000 (18:44 -0400)]
bump version to v5.36.0 (RC3)

2 months agoMerge branch 'release-5.36.0' into blead 19729/head
Ricardo Signes [Sat, 21 May 2022 21:27:09 +0000 (17:27 -0400)]
Merge branch 'release-5.36.0' into blead

2 months agoperldoc: add performance enhancement note about #19414
Ricardo Signes [Sat, 21 May 2022 21:24:43 +0000 (17:24 -0400)]
perldoc: add performance enhancement note about #19414

2 months agoRevert "perlapi: Document sv_dup(_inc)?"
Karl Williamson [Sat, 21 May 2022 18:52:46 +0000 (12:52 -0600)]
Revert "perlapi: Document sv_dup(_inc)?"

This reverts commit f45ba102ff7bfce07641cfd49cd18ef4e8a7f6e3, which
turns out to be contentious, so at this late date revert.

2 months agoperlapi: do_open doesn't have docs yet
Karl Williamson [Sat, 21 May 2022 18:51:53 +0000 (12:51 -0600)]
perlapi: do_open doesn't have docs yet

2 months agobuiltin.pm: document that it is experimental
Ricardo Signes [Sat, 21 May 2022 18:44:41 +0000 (14:44 -0400)]
builtin.pm: document that it is experimental

2 months agoperlexperiment: document extra_paired_delimiters
Ricardo Signes [Sat, 21 May 2022 18:38:03 +0000 (14:38 -0400)]
perlexperiment: document extra_paired_delimiters

2 months agoperlexperiment: defer {} syntax
Ricardo Signes [Sat, 21 May 2022 18:28:54 +0000 (14:28 -0400)]
perlexperiment: defer {} syntax

2 months agoperlexperiment: document the builtin experiment
Ricardo Signes [Sat, 21 May 2022 18:22:23 +0000 (14:22 -0400)]
perlexperiment: document the builtin experiment

2 months agoperlexperiment: add documentation for for_list feature
Ricardo Signes [Sat, 21 May 2022 18:14:29 +0000 (14:14 -0400)]
perlexperiment: add documentation for for_list feature

2 months agoperlapi: Mark call_list as internal
Karl Williamson [Sat, 21 May 2022 04:22:03 +0000 (22:22 -0600)]
perlapi: Mark call_list as internal

This function is heavily dependent on non-public state information.

ExtUtils::ParseXS generates code that uses it to emulate the generated
XS boot code for a range of perls where this was problematic.  This
range ends before 5.22.  This code is #ifdef'd out on newer perls.

New XS code should not use this function.

There is one CPAN module that uses it independently, Parse::Perl, using
the same formulation that ExtUtils::ParseXS generates.

2 months agoperlapi: Document sv_dup(_inc)?
Karl Williamson [Wed, 18 May 2022 21:42:21 +0000 (15:42 -0600)]
perlapi: Document sv_dup(_inc)?

2 months agoperlapi: Document do_join
Karl Williamson [Thu, 19 May 2022 18:13:22 +0000 (12:13 -0600)]
perlapi: Document do_join

2 months agoperlapi: Document do_sprintf
Karl Williamson [Thu, 19 May 2022 18:35:35 +0000 (12:35 -0600)]
perlapi: Document do_sprintf

2 months agoperlapi: Further clean up AV docs
Karl Williamson [Fri, 20 May 2022 20:53:39 +0000 (14:53 -0600)]
perlapi: Further clean up AV docs

2 months agoprepare perl-v5.36.0 RC2
Ricardo Signes [Fri, 20 May 2022 20:16:16 +0000 (16:16 -0400)]
prepare perl-v5.36.0 RC2

Due to SSL problems on PAUSE, RC1 is unlikely to exist in public.

2 months agoperl5360delta: remove XXXs, add acknowledgements
Ricardo Signes [Fri, 20 May 2022 19:52:14 +0000 (15:52 -0400)]
perl5360delta: remove XXXs, add acknowledgements

2 months agoperlapi: Clean up some AV documentation
Karl Williamson [Wed, 18 May 2022 15:07:49 +0000 (09:07 -0600)]
perlapi: Clean up some AV documentation

The consolidation of newAV with newAV_alloc_xz? included nonsensical
juxtapositions.  This cleans that up, adds a bit of markup, moves the
function implementing the newAV_alloc ones to internal, as there are no
CPAN uses, and we prefer the macro interface.

2 months agoFix the previous commit
Karl Williamson [Fri, 20 May 2022 19:36:19 +0000 (13:36 -0600)]
Fix the previous commit

that being 1a5f85f6dac28f2dfebf1cb8a04df3c44e355e24

I hadn't actually committed the change before pushing

2 months agoperlapi: Mark hv_delayfree_ent as internal
Karl Williamson [Fri, 20 May 2022 19:26:45 +0000 (13:26 -0600)]
perlapi: Mark hv_delayfree_ent as internal

I'm told this has been unused since early 5.0, and should be deprecated
and removed.  For 5.36, just mark it as internal.

2 months agoperlhist: add v5.36.0 RC1 to perlhist v5.36.0-RC1
Ricardo Signes [Fri, 20 May 2022 18:10:12 +0000 (14:10 -0400)]
perlhist: add v5.36.0 RC1 to perlhist

2 months agobump version to v5.36.0 (RC1)
Ricardo Signes [Fri, 20 May 2022 17:59:39 +0000 (13:59 -0400)]
bump version to v5.36.0 (RC1)

2 months agoperldelta: Note documentation effort in perlapi
Karl Williamson [Fri, 20 May 2022 13:40:08 +0000 (07:40 -0600)]
perldelta: Note documentation effort in perlapi

2 months agoperlhist: add release size information
Ricardo Signes [Sun, 15 May 2022 21:46:55 +0000 (17:46 -0400)]
perlhist: add release size information

2 months agoperldelta: fix broken links
Ricardo Signes [Sun, 15 May 2022 21:30:24 +0000 (17:30 -0400)]
perldelta: fix broken links

2 months agorelease prep for v5.36.0: regenerate files
Ricardo Signes [Sun, 15 May 2022 21:17:33 +0000 (17:17 -0400)]
release prep for v5.36.0: regenerate files

2 months agoperldelta: remove the v5.35.z deltas
Ricardo Signes [Sun, 15 May 2022 21:07:27 +0000 (17:07 -0400)]
perldelta: remove the v5.35.z deltas

2 months agoperldelta: populate "new/updated modules"
Ricardo Signes [Sun, 15 May 2022 21:05:16 +0000 (17:05 -0400)]
perldelta: populate "new/updated modules"

by running:

  ./perl -Ilib Porting/corelist-perldelta.pl 5.034000 5.036000 \
    --mode=update pod/perldelta.pod

2 months agoModule::CoreList: update v5.36.0 contents
Ricardo Signes [Sun, 15 May 2022 21:02:10 +0000 (17:02 -0400)]
Module::CoreList: update v5.36.0 contents

2 months agoModule-CoreList: bump versions for v5.36.0
Ricardo Signes [Sun, 15 May 2022 20:55:05 +0000 (16:55 -0400)]
Module-CoreList: bump versions for v5.36.0

2 months agobump version to v5.36.0 (RC0)
Ricardo Signes [Sun, 15 May 2022 20:43:23 +0000 (16:43 -0400)]
bump version to v5.36.0 (RC0)

2 months agoperl5360delta: undocument removal of bareword_filehandles
Ricardo Signes [Sat, 14 May 2022 13:28:47 +0000 (09:28 -0400)]
perl5360delta: undocument removal of bareword_filehandles

...because we unremoved it.

2 months agoperl5360delta: typo corrections from code review
Ricardo Signes [Tue, 19 Apr 2022 13:43:36 +0000 (09:43 -0400)]
perl5360delta: typo corrections from code review

2 months agoperl5360delta: integrate "switch left bundle" into "use v5.36" docs
Ricardo Signes [Sun, 3 Apr 2022 20:32:38 +0000 (16:32 -0400)]
perl5360delta: integrate "switch left bundle" into "use v5.36" docs

2 months agoperl5360delta: isbool is now builtin::is_bool
Ricardo Signes [Sun, 3 Apr 2022 14:40:40 +0000 (10:40 -0400)]
perl5360delta: isbool is now builtin::is_bool

2 months agoperl5360delta: update notes on generating Acknowledgements
Ricardo Signes [Sun, 3 Apr 2022 14:38:59 +0000 (10:38 -0400)]
perl5360delta: update notes on generating Acknowledgements

2 months agoperl5360delta: avoid talking about exact wallclock time
Ricardo Signes [Sun, 3 Apr 2022 14:37:33 +0000 (10:37 -0400)]
perl5360delta: avoid talking about exact wallclock time

2 months agoperl5360delta: reorganize changes to diagnostics
Ricardo Signes [Sun, 3 Apr 2022 14:36:31 +0000 (10:36 -0400)]
perl5360delta: reorganize changes to diagnostics

2 months agoperl5360delta: add -g docs to perlrun section, also
Ricardo Signes [Sun, 3 Apr 2022 14:28:54 +0000 (10:28 -0400)]
perl5360delta: add -g docs to perlrun section, also

2 months agoperl5360delta: move a perldiag update to Diagnostics
Ricardo Signes [Sun, 3 Apr 2022 14:26:23 +0000 (10:26 -0400)]
perl5360delta: move a perldiag update to Diagnostics

2 months agoperl5360delta: rewrite the "use vX" and strict section
Ricardo Signes [Sun, 3 Apr 2022 14:21:44 +0000 (10:21 -0400)]
perl5360delta: rewrite the "use vX" and strict section

2 months agoperl5360delta: sort () is as erroneous as sort
Ricardo Signes [Sun, 3 Apr 2022 14:12:03 +0000 (10:12 -0400)]
perl5360delta: sort () is as erroneous as sort

2 months agoperl5360delta: restructure the Core Enhancements section
Ricardo Signes [Sun, 3 Apr 2022 03:34:30 +0000 (23:34 -0400)]
perl5360delta: restructure the Core Enhancements section

2 months agoperl5360delta: combine notes on "use v5.36" behavior
Ricardo Signes [Sun, 3 Apr 2022 03:08:33 +0000 (23:08 -0400)]
perl5360delta: combine notes on "use v5.36" behavior

2 months agoperl5360delta: clean up the top header
Ricardo Signes [Sat, 2 Apr 2022 21:49:35 +0000 (17:49 -0400)]
perl5360delta: clean up the top header

This part of the document will be regenerated before it is really
merged, but it was pretty ugly just while I read this.

2 months agoperl5360delta: incorporate perl53510delta
Ricardo Signes [Sat, 2 Apr 2022 21:48:05 +0000 (17:48 -0400)]
perl5360delta: incorporate perl53510delta

2 months agoperl5360delta: incorporate perl5359delta
Ricardo Signes [Sat, 2 Apr 2022 21:45:17 +0000 (17:45 -0400)]
perl5360delta: incorporate perl5359delta

2 months agoperl5360delta: incorporate perl5358delta
Ricardo Signes [Sat, 2 Apr 2022 21:32:44 +0000 (17:32 -0400)]
perl5360delta: incorporate perl5358delta

2 months agoperl5360delta: incorporate perl5357delta
Ricardo Signes [Sat, 2 Apr 2022 21:29:40 +0000 (17:29 -0400)]
perl5360delta: incorporate perl5357delta

2 months agoperl5360delta: incorporate perl5356delta
Ricardo Signes [Sat, 2 Apr 2022 21:15:35 +0000 (17:15 -0400)]
perl5360delta: incorporate perl5356delta

2 months agoperl5360delta: incorporate perl5355delta
Ricardo Signes [Sat, 2 Apr 2022 21:04:24 +0000 (17:04 -0400)]
perl5360delta: incorporate perl5355delta

2 months agoperl5360delta: incorporate perl5354delta
Ricardo Signes [Sat, 2 Apr 2022 20:57:19 +0000 (16:57 -0400)]
perl5360delta: incorporate perl5354delta

2 months agoperl5360delta: incorporate perl5353delta
Ricardo Signes [Sat, 2 Apr 2022 20:52:46 +0000 (16:52 -0400)]
perl5360delta: incorporate perl5353delta

2 months agoperl5360delta: incorporate perl5352delta
Ricardo Signes [Sat, 2 Apr 2022 20:48:41 +0000 (16:48 -0400)]
perl5360delta: incorporate perl5352delta

2 months agoperl5360delta: a work in progress
Ricardo Signes [Sat, 2 Apr 2022 20:45:42 +0000 (16:45 -0400)]
perl5360delta: a work in progress

This will not be merged as such, but is a place for me to save my work
while I build the perl5360delta.

This is just the new perldelta template plus content imported from
perl5351delta.pod.

2 months agoperlre: Clarify /xx pod
Karl Williamson [Mon, 16 May 2022 23:00:34 +0000 (17:00 -0600)]
perlre: Clarify /xx pod

This is a result of GH #19726

2 months agoperl.c, pp_hot.c: Fix typos in comments
Karl Williamson [Fri, 20 May 2022 04:02:48 +0000 (22:02 -0600)]
perl.c, pp_hot.c: Fix typos in comments

2 months agoperlapi: Turn ptr_table comments into pod
Karl Williamson [Fri, 20 May 2022 02:20:15 +0000 (20:20 -0600)]
perlapi: Turn ptr_table comments into pod

2 months agoMerge remote-tracking branch 'leonerd/revert-PR19541' into blead
Ricardo Signes [Fri, 20 May 2022 00:01:10 +0000 (20:01 -0400)]
Merge remote-tracking branch 'leonerd/revert-PR19541' into blead

2 months agoRemove documentation references to recent Configure taint changes 19679/head
Paul "LeoNerd" Evans [Thu, 19 May 2022 16:57:04 +0000 (17:57 +0100)]
Remove documentation references to recent Configure taint changes

2 months agoRevert "Add Configure question for taint support"
Paul "LeoNerd" Evans [Sun, 1 May 2022 08:54:49 +0000 (09:54 +0100)]
Revert "Add Configure question for taint support"

This reverts commit 39f8eb4a21670e6b973dcfc86d0b1339064f5642.

This is because of a variety of issues discussed #19657 and at the PSC
meeting 064 2022-04-22

https://www.nntp.perl.org/group/perl.perl5.porters/2022/04/msg263670.html

2 months agoperlapi: safemalloc doesn't take a pointer
Tomasz Konojacki [Thu, 19 May 2022 15:56:38 +0000 (17:56 +0200)]
perlapi: safemalloc doesn't take a pointer

2 months agoperlapi: Document re_compile
Karl Williamson [Thu, 19 May 2022 03:36:59 +0000 (21:36 -0600)]
perlapi: Document re_compile

2 months agoperlapi: Mark new(FORM|PROG), newMYSUB as internal
Karl Williamson [Thu, 19 May 2022 14:58:01 +0000 (08:58 -0600)]
perlapi: Mark new(FORM|PROG), newMYSUB as internal

Dave Mitchell says all the undocumented OP newFOO forms are considered
somewhat experimental.  Unfortunately, all but these three are in
current CPAN use.

Mark these three as experimental to avoid their getting used; and leave
the rest as undocumented until we decide what to do.

2 months agoSync Compress-Raw-Zlib-2.105 into blead
Todd Rinaldo [Mon, 16 May 2022 02:04:31 +0000 (02:04 +0000)]
Sync Compress-Raw-Zlib-2.105 into blead

This commit synchs into blead versions 2.105 for
CPAN distribution Compress-Raw-Zlib

2 months agoFix typos for generating perlapi
Karl Williamson [Thu, 19 May 2022 11:34:03 +0000 (05:34 -0600)]
Fix typos for generating perlapi

2 months agoperlapi: Document amagic(_deref)?_call
Karl Williamson [Thu, 12 May 2022 23:14:12 +0000 (17:14 -0600)]
perlapi: Document amagic(_deref)?_call

2 months agoperlapi: Document SvAMAGIC
Karl Williamson [Thu, 12 May 2022 21:39:00 +0000 (15:39 -0600)]
perlapi: Document SvAMAGIC

2 months agoperlapi: Document SvAMAGIC_(on|off)
Karl Williamson [Thu, 12 May 2022 21:25:09 +0000 (15:25 -0600)]
perlapi: Document SvAMAGIC_(on|off)

2 months agoperlapi: Document Gv_AMupdate
Karl Williamson [Thu, 12 May 2022 20:57:33 +0000 (14:57 -0600)]
perlapi: Document Gv_AMupdate

2 months agoperlapi: Document Perl_deb and kin
Karl Williamson [Thu, 12 May 2022 19:34:58 +0000 (13:34 -0600)]
perlapi: Document Perl_deb and kin

2 months agoperlapi: Document a few dump functions.
Karl Williamson [Thu, 12 May 2022 20:18:09 +0000 (14:18 -0600)]
perlapi: Document a few dump functions.

dump_eval, pmop_dump, gv_dump, magic_dump, dump_form.

2 months agoperlapi: Mark do_spawn and kin as internal
Karl Williamson [Wed, 18 May 2022 22:25:19 +0000 (16:25 -0600)]
perlapi: Mark do_spawn and kin as internal

These compile only on a few systems that lack a Unix-ish system(),
and don't really map to a Perl-level operation.

There are no CPAN uses

2 months agoperlapi: Mark mg_size as internal
Karl Williamson [Wed, 18 May 2022 20:35:33 +0000 (14:35 -0600)]
perlapi: Mark mg_size as internal

This looks like grander things were planned for this, but currently this
is a helper for AvFILL, which is a macro that is better accessed
through, say, av_count.  Whichever, mg_size should not be used
independently.

2 months agoperlapi: Mark savestack_grow(_cnt) as internal
Karl Williamson [Wed, 18 May 2022 20:29:24 +0000 (14:29 -0600)]
perlapi: Mark savestack_grow(_cnt) as internal

These are used to help implement various macros, such as SS_ADD_END
and SSGROW, which should be called instead of calling these functions
directly.

2 months agoperlapi: Mark get_vtbl as internal experimental
Karl Williamson [Wed, 18 May 2022 20:25:36 +0000 (14:25 -0600)]
perlapi: Mark get_vtbl as internal experimental

This is obsoleted, was ommited from
2ab86d4ccc1d7d8cf04590ca7c73d7a436d1e162

2 months agoperlapi: Mark new_stackinfo as internal
Karl Williamson [Wed, 18 May 2022 20:08:57 +0000 (14:08 -0600)]
perlapi: Mark new_stackinfo as internal

This is basically a helper function for PUSHSTACKi()

2 months agoperlapi: Mark markstack_gorw as internal
Karl Williamson [Wed, 18 May 2022 20:03:01 +0000 (14:03 -0600)]
perlapi: Mark markstack_gorw as internal

This is an internal helper function for things like TOPMARK.

2 months agoperlapi: Document and mark internal my_popen_list
Karl Williamson [Wed, 18 May 2022 19:57:38 +0000 (13:57 -0600)]
perlapi: Document and mark internal my_popen_list

This implements PerlProc_popen_list on some systems.

2 months agoperlapi: Document and mark internal my_socketpair
Karl Williamson [Wed, 18 May 2022 19:48:08 +0000 (13:48 -0600)]
perlapi: Document and mark internal my_socketpair

This emulates socketpair on some systems that lack it; and should all be
under the level that XS code would deal with.

2 months agoperlapi: Mark hv_rand_set as internal
Karl Williamson [Wed, 18 May 2022 19:40:20 +0000 (13:40 -0600)]
perlapi: Mark hv_rand_set as internal

This is the core implementing function for hash_traversal_mask() in
Hash::Util.

2 months agoperlapi: Mark doref as internal
Karl Williamson [Wed, 18 May 2022 19:35:09 +0000 (13:35 -0600)]
perlapi: Mark doref as internal

This is the old name for plain ref()

2 months agoperlapi: Mark gp_ref as internal
Karl Williamson [Wed, 18 May 2022 19:30:42 +0000 (13:30 -0600)]
perlapi: Mark gp_ref as internal

There are no cpan uses; this is a helper function for GvGP_set

2 months agoperlapi: Mark gp_free as internal
Karl Williamson [Wed, 18 May 2022 19:25:31 +0000 (13:25 -0600)]
perlapi: Mark gp_free as internal

This is a helper for the specialty freeing of gp's.  There are no cpan
uses.

2 months agoperlapi: Mark share_hek as internal only
Karl Williamson [Wed, 18 May 2022 19:07:22 +0000 (13:07 -0600)]
perlapi: Mark share_hek as internal only

There are no cpan uses; this is a helper for various API macros, like
GvNAME_HEK.  It's complement, unshare_hek, isn't even exported.

2 months agoLoosen regex in tests which validate process name.
Todd Rinaldo [Mon, 16 May 2022 21:48:59 +0000 (16:48 -0500)]
Loosen regex in tests which validate process name.

This addresses some kernel inconsistencies on how the
process name can be represented in the /proc file. This
specifically addresses a failure on AlmaLinux 8.

2 months agoperlapi: perl_(alloc|clone)_using are internal
Karl Williamson [Wed, 18 May 2022 11:51:47 +0000 (05:51 -0600)]
perlapi: perl_(alloc|clone)_using are internal

No XS writer should be using them, and none are.

2 months agoregen/embed.pl: Allow perl_' prefix to names
Karl Williamson [Wed, 18 May 2022 11:40:51 +0000 (05:40 -0600)]
regen/embed.pl: Allow perl_' prefix to names

Normally, the embed.fnc C flag requires a p flag to make sure that the
name starts with 'Perl_', to avoid polluting the caller's name space.
This commit makes an exception to that if the name already starts with
[Pp]erl.

This is because we have few old functions whose name starts with
'perl_', and hence they don't fit in with the newer scheme of things.

The meanings of the O and o flags in combination could have been
tweaked, but this is the simplest solution, namely:  If the name isn't
going to pollute, it's ok no matter what the flags say.

2 months agodoio.c: Properly indent some nested #if lines
Karl Williamson [Wed, 11 May 2022 17:16:14 +0000 (11:16 -0600)]
doio.c: Properly indent some nested #if lines

2 months agoMark all _dup fcns but sv_dup* as internal
Karl Williamson [Thu, 12 May 2022 01:49:20 +0000 (19:49 -0600)]
Mark all _dup fcns but sv_dup* as internal

2 months agoperlapi: Mark internal and better document some memory fcns
Karl Williamson [Thu, 12 May 2022 00:18:34 +0000 (18:18 -0600)]
perlapi: Mark internal and better document some memory fcns

Perl_(([cm]|re)alloc|mfree) should not be used by the public; instead
there are macros that these implement.

The *alloc functions weren't documented, because of an erroneous
assumption; erroneous because all require the Perl_ preface to call
them.

2 months agoperlapi: Document save_alloc; mark as internal
Karl Williamson [Wed, 11 May 2022 22:18:50 +0000 (16:18 -0600)]
perlapi: Document save_alloc; mark as internal

This implements SSNEW and kin, which should be used instead of this.

2 months agoperlapi: Document SSNEW, SSPTR and kin
Karl Williamson [Wed, 11 May 2022 22:19:26 +0000 (16:19 -0600)]
perlapi: Document SSNEW, SSPTR and kin

2 months agoperlapi: Document newGVgen(_flags)?
Karl Williamson [Wed, 11 May 2022 20:37:24 +0000 (14:37 -0600)]
perlapi: Document newGVgen(_flags)?

2 months agoDocument gv_e?fullname[34]
Karl Williamson [Wed, 11 May 2022 20:33:39 +0000 (14:33 -0600)]
Document gv_e?fullname[34]

2 months agoperlapi: Document unsharepvn
Karl Williamson [Wed, 11 May 2022 19:57:46 +0000 (13:57 -0600)]
perlapi: Document unsharepvn

2 months agoperlapi: Document several *_dup functions
Karl Williamson [Wed, 11 May 2022 19:51:43 +0000 (13:51 -0600)]
perlapi: Document several *_dup functions

2 months agoperlapi: Document repeatcpy
Karl Williamson [Wed, 11 May 2022 19:20:44 +0000 (13:20 -0600)]
perlapi: Document repeatcpy

2 months agoperlapi: Document is_lvalue_sub
Karl Williamson [Wed, 11 May 2022 18:16:55 +0000 (12:16 -0600)]
perlapi: Document is_lvalue_sub