develooper Front page | perl.perl5.porters | Postings from January 2022

Re: perldelta: ?Internal Changes?

Thread Previous
From:
Oodler 577 via perl5-porters
Date:
January 31, 2022 05:25
Subject:
Re: perldelta: ?Internal Changes?
Message ID:
YfdyxGlhvX6PleDE@odin.sdf-eu.org
* Darren Duncan <darren@darrenduncan.net> [2022-01-30 20:35:30 -0800]:

> On 2022-01-30 4:26 p.m., Felipe Gasper wrote:
> > 	perldelta describes its ?Internal Changes? section thus: ?Changes which affect the interface available to C<XS> code go here.? The interface for XS modules is just Perl?s C API. By definition, isn?t an API external-facing?
> > 
> > 	By that logic, changes like Paul?s new sv_numeq and sv_streq (and my proposed change to sv_dump() to output hex rather than octal) don?t really seem like ?internal? changes.
> > 
> > 	Would it perhaps be more sensible to make a separate section named ?C API Changes?, then reserve ?Internal Changes? for those updates that are indeed purely internal to Perl?
> 
> I agree with this proposal.  Whatever APIs XS uses are "external", while
> changes to Perl that don't affect any API are "internal".  -- Darren Duncan

Looking at the perldeltas (seem to be rightly, just on .0 versions), it
seems like it's a mixed bag historically.

https://perldoc.perl.org/perl

So maybe the "ask" is to break them into subsections? The section might
more rightly be called "Internals", since this is often an overloaded
term.

Cheers,
Brett

-- 
--
oodler@cpan.org
oodler577@sdf-eu.org
SDF-EU Public Access UNIX System - http://sdfeu.org
irc.perl.org #openmp #pdl #native

Thread Previous


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About