develooper Front page | perl.perl5.porters | Postings from May 2017

Re: perldelta [ was: Re: Perl 5.26.0-RC1 is now available!]

Thread Previous | Thread Next
From:
jkeenan
Date:
May 24, 2017 15:35
Subject:
Re: perldelta [ was: Re: Perl 5.26.0-RC1 is now available!]
Message ID:
fb56ea69-ba79-0f82-3616-d5e4e1ef78d6@pobox.com
On 05/24/2017 11:17 AM, James E Keenan wrote:
> On 05/24/2017 09:58 AM, Dave Mitchell wrote:
>>
>> I've just pushed my last set of reviews of perldelta.
>>
>> A couple of things I wasn't clear about.
>>
>> In
>>      =head2 Platform-Specific Notes
>>
>> there are separate entries for
>>
>>      =item Darwin
>>      =item OS X
>>      =item macOS (specifially macOS 10.12)
>>
>> Are all these essentially the same platform? (I'm not very familiar with
>> Macs).
>>
>> Similarly, there are separate entries for
>>
>>      =item Windows
>>      =item Win32
>>
>> should these all be under 'Windows'?
>>
>> Finally under
>>
>>      =head1 Reporting Bugs
>>
>> it starts off:
>>
>>      If you find what you think is a bug, you might check the articles 
>> recently
>>      posted to the comp.lang.perl.misc newsgroup and the perl bug 
>> database at
>>      L<https://rt.perl.org/>  .
>>
>> I think we've been removing mentions of newsgroups on the grounds that
>> they're no longer the main goto point for perl pregrammers. I suggest I
>> remove it. I'm not sure how it keeps getting there - does
>> Porting/new-perldelta.pl extract it from an older perldelta?
> 
> Apparently it does.  I just ran that program in a clean checkout and saw 
> that the comp.lang.perl.misc line was added to newly created file 
> pod/perl5260delta.pod.
> 
> Going back to a clean checkout, I call:
> 
> $ ack -l 'comp.*lang.*perl.*misc' ./pod | ack perl52 |sort
> pod/perl5200delta.pod
> pod/perl5201delta.pod
> pod/perl5202delta.pod
> pod/perl5203delta.pod
> pod/perl5220delta.pod
> pod/perl5221delta.pod
> pod/perl5222delta.pod
> pod/perl5223delta.pod
> pod/perl5240delta.pod
> pod/perl5241delta.pod
> pod/perl5250delta.pod
> pod/perl5251delta.pod
> 
> Those last two look suspicious.  But I find that even if I edit 
> perl5250delta.pod and perl5251delta.pod to remove the reference to 
> comp.lang.perl.misc and then re-run Porting/new-perldelta.pl, I get a 
> brand new file, pod/perl5260delta.pod, that retains the clpm reference 
> -- but pod/perldelta.pod is now clean.
> 
> Puzzled.
> 
> Thank you very much.
> Jim Keenan

At this point, I think we should simply manually edit these 3 files:

$ ack -C1 'comp.*lang.*perl.*misc' pod/perldelta.pod pod/perl525*
pod/perldelta.pod
3287-If you find what you think is a bug, you might check the articles 
recently
3288:posted to the comp.lang.perl.misc newsgroup and the perl bug 
database at
3289-L<https://rt.perl.org/> .  There may also be information at

pod/perl5250delta.pod
69-If you find what you think is a bug, you might check the articles 
recently
70:posted to the comp.lang.perl.misc newsgroup and the perl bug database at
71-L<https://rt.perl.org/> .  There may also be information at

pod/perl5251delta.pod
395-If you find what you think is a bug, you might check the articles 
recently
396:posted to the comp.lang.perl.misc newsgroup and the perl bug database at
397-L<https://rt.perl.org/> .  There may also be information at

Thread Previous | Thread Next


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