Maintaining Perl 5 Core (Dave Mitchell): September 2025
Tue, 07-Oct-2025 by
alh
edit post
Dave writes:
Last month I completed rewriting and modernising perlxs.pod, Perl's
reference manual for XS. It's now sitting as PR [#23795](https://github.com/perl/perl5/pull/23795), and will hopefully
get merged before too long. (I actually completed the work two days into
October, so next month's report will show a few hours.)
From the PR's description:
This branch completely rewrites and modernises the XS reference manual,
perlxs.pod.
The new file is about twice the size of the old one.
This branch:
- deletes some obsolete sections;
- reorders the existing sections into a more logical order;
- adds a large new introductory/overview part, which explains
all the background needed to understand what XSUBs do, including
SVs, the stack, reference counts, magic etc.
- includes a BNF syntax section
- modernises: e.g. it uses ANSI parameter syntax throughout
- has a fully-worked example using T_PTROBJ
SUMMARY:
* 23:19 modernise perlxs.pod
* 3:50 rationalise XS typemap file search order
Total:
* 27:09 (HH::MM)
Comments (0)