From Fedora Project Wiki
(Move to ChangeReadyForWrangler)
m (→‎Release Notes: A typography)
 
(44 intermediate revisions by 3 users not shown)
Line 24: Line 24:
  
 
== Summary ==
 
== Summary ==
A new ''perl 5.30'' version brings a lot of changes done over a year of development. Perl 5.30 should be released at the end of May 2019. See [https://metacpan.org/pod/release/XSAWYERX/perl-5.30.0-RC1/pod/perldelta.pod 5.30.0 perldelta] for more details about preparing release.
+
A new ''perl 5.30'' version brings a lot of changes done over a year of development. Perl 5.30 was released 5/22/2019. See [https://metacpan.org/pod/release/XSAWYERX/perl-5.30.0/pod/perldelta.pod 5.30.0 perldelta] for more details about preparing release.
  
 
== Owner ==
 
== Owner ==
Line 51: Line 51:
 
CLOSED as NEXTRELEASE -> change is completed and verified and will be delivered in next release under development
 
CLOSED as NEXTRELEASE -> change is completed and verified and will be delivered in next release under development
 
-->
 
-->
* Tracker bug: []
+
* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=1715528 #1715528]
* Release Notes tracking: []
+
* Release Notes tracking: [https://pagure.io/fedora-docs/release-notes/issue/346 #346]
  
 
=== Completed Items ===
 
=== Completed Items ===
 
=== Items in Progress ===
 
 
=== Items to Be Done ===
 
  
 
* Upstream to release Perl 5.30
 
* Upstream to release Perl 5.30
* Get dedicated build-root from rel-engs (''f31-perl'')  
+
* Get dedicated [https://pagure.io/releng/issue/8384 build-root from rel-engs (''f31-perl'') ]
 
* Define perl_bootstrap in perl-srpm-macros
 
* Define perl_bootstrap in perl-srpm-macros
 
* Rebase perl to 5.30.0
 
* Rebase perl to 5.30.0
* Build new perl 5.30 keeping old COMPAT Provides
+
<!--* Build new perl 5.30 keeping old COMPAT Provides -->
 
* Rebuild dual-lived packages (otherwise dnf recommends --skip-broken and fails)
 
* Rebuild dual-lived packages (otherwise dnf recommends --skip-broken and fails)
 
* Rebuild packages needed for minimal build-root
 
* Rebuild packages needed for minimal build-root
 
* Rebuild packages needed for building source packages from git repository
 
* Rebuild packages needed for building source packages from git repository
* Remove old perl(:MODULE_COMPAT_5.28.*) from perl
+
* Rebuild other packages: Use Fedora::Rebuild dependency solver
 +
<!--* Remove old perl(:MODULE_COMPAT_5.28.*) from perl -->
 
* Undefine perl_bootstrap
 
* Undefine perl_bootstrap
* Rebuild other packages: Use Fedora::Rebuild dependency solver
 
 
* Rebuild packages having perl_bootstrap condition in spec file
 
* Rebuild packages having perl_bootstrap condition in spec file
 
* Rebuild all updated packages
 
* Rebuild all updated packages
 +
* [https://jplesnik.fedorapeople.org/5.30/ Final lists of results]
 
* Merge dedicated build-root to rawhide and remove the dedicated one by rel-engs
 
* Merge dedicated build-root to rawhide and remove the dedicated one by rel-engs
 
* Synchronize packages upgraded in ''f31'' build root
 
* Synchronize packages upgraded in ''f31'' build root
* Rebuilt Perl packages: 0 of 3186 done (0.00 %)
+
 
* Failed builds (0):  
+
=== Items in Progress ===
* Unsatisfied dependencies (0):
+
 
 +
* Rebuilt Perl packages: 3180 of 3182 done (99.94%)
 +
* Failed builds (2):  
 +
** crypto-utils - [https://bugzilla.redhat.com/show_bug.cgi?id=1674777 BZ#1674777]
 +
** thrift - [https://bugzilla.redhat.com/show_bug.cgi?id=1676140 BZ#1676140]
 +
 
 +
=== Items to Be Done ===
  
 
== Detailed Description ==
 
== Detailed Description ==
  
 
New perl is released every year and updates containing mainly bug fixes follow during the year. The 5.30.0 version is stable release this year.
 
New perl is released every year and updates containing mainly bug fixes follow during the year. The 5.30.0 version is stable release this year.
 +
 +
In addition, Perl ''site'' paths will be made ABI-specific. CPAN modules intended for an installation under /usr/local/ will be installed to /usr/local/{share,lib*}/perl5/5.30 paths. This will prevent from breaking Perl with old locally installed modules after a Fedora upgrade.
  
 
== Benefit to Fedora ==
 
== Benefit to Fedora ==
Line 97: Line 102:
 
Owners of packages that fail to rebuild, mainly perl-sig users, will be asked using Bugzilla to fix or remove their packages from the distribution.
 
Owners of packages that fail to rebuild, mainly perl-sig users, will be asked using Bugzilla to fix or remove their packages from the distribution.
  
* Release engineering: [] (a check of an impact with Release Engineering is needed) <!-- REQUIRED FOR SYSTEM WIDE AS WELL AS FOR SELF CONTAINED CHANGES -->
+
* Release engineering: [https://pagure.io/releng/issue/8368 #8368] (a check of an impact with Release Engineering is needed) <!-- REQUIRED FOR SYSTEM WIDE AS WELL AS FOR SELF CONTAINED CHANGES -->
 
Release engineers will be asked for new ''f31-perl'' build-root inheriting from ''f31'' build-root. After successful finishing the rebuild, they will be asked to merge ''f31-perl'' packages back to ''f31'' build-root.
 
Release engineers will be asked for new ''f31-perl'' build-root inheriting from ''f31'' build-root. After successful finishing the rebuild, they will be asked to merge ''f31-perl'' packages back to ''f31'' build-root.
 
<!-- ** [[Fedora_Program_Management/ReleaseBlocking/Fedora{{FedoraVersionNumber|next}}|List of deliverables]]: N/A (not a System Wide Change) --> <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 
<!-- ** [[Fedora_Program_Management/ReleaseBlocking/Fedora{{FedoraVersionNumber|next}}|List of deliverables]]: N/A (not a System Wide Change) --> <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
Line 106: Line 111:
  
 
== Upgrade/Compatibility Impact ==
 
== Upgrade/Compatibility Impact ==
Vast majority of functionality will be preserved. Only the packages that failed to build against perl 5.30 will be removed from the distribution. That will require to remove those packages from existing systems otherwise package manager will encounter unsatisfied dependencies.
+
Vast majority of functionality will be preserved. Only the packages that failed to build against perl 5.30 will be removed from the distribution. That will require to remove those packages from existing systems otherwise package manager will encounter unsatisfied dependencies. Modules installed locally into /usr/local will become unavailable and users will need to reinstall them.
  
 
== How to Test ==
 
== How to Test ==
Line 112: Line 117:
  
 
== User Experience ==
 
== User Experience ==
There should not be any remarkable change in user experience.  
+
There should not be any remarkable change in user experience. With the exception that previously locally installed modules with a CPAN clients will need a reinstalation.
  
 
== Dependencies ==
 
== Dependencies ==
Line 124: Line 129:
  
 
== Documentation ==
 
== Documentation ==
* [https://metacpan.org/pod/release/XSAWYERX/perl-5.30.0-RC1/pod/perldelta.pod 5.30.0 perldelta]
+
* [https://metacpan.org/pod/release/XSAWYERX/perl-5.30.0/pod/perldelta.pod 5.30.0 perldelta]
* An announcement on the perl-devel mailing list
+
* [https://lists.fedoraproject.org/archives/list/perl-devel@lists.fedoraproject.org/thread/ZPSYPQTGOENGRYJC54HTEH2OKHMDNYAB/ An announcement on the perl-devel mailing list]
 +
* [https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/MZBMSKP3TQHIDMPBGESPJY4MIB7I7ZB3/ An announcement on fedora-devel mailing list]
 +
* [https://lists.fedoraproject.org/archives/list/perl-devel@lists.fedoraproject.org/thread/YLWW33T7C4LTQY5XQ6E6PXOZUGYTP27M/ Making Perl site paths ABI-specific] discussion on perl-devel mailing list
  
 
== Release Notes ==
 
== Release Notes ==
 
=== Important Changes ===
 
=== Important Changes ===
* Unicode 11, 12 and draft 12.1 is supported
+
* Unicode 12.1 is supported
* The upper limit "n" specifiable in a regular expression quantifier of the form "{m,n}" has been doubled to 65534
+
* The upper limit ''n'' specifiable in a regular expression quantifier of the form ''{m,n}'' has been doubled to 65534
* Wildcards in Unicode property value specifications are now partially supported
+
* Wildcards in the Unicode property value specifications are now partially supported
* qr'\N{name}' is now supported
+
* ''qr'\N{name}''' is now supported
 
* It is now possible to compile perl to always use thread-safe locale operations.
 
* It is now possible to compile perl to always use thread-safe locale operations.
 
* Limited variable length lookbehind in regular expression pattern matching is now experimentally supported
 
* Limited variable length lookbehind in regular expression pattern matching is now experimentally supported
 
* Use faster method to convert to UTF-8
 
* Use faster method to convert to UTF-8
 
* Turkic UTF-8 locales are now seamlessly supported
 
* Turkic UTF-8 locales are now seamlessly supported
* Eliminate opASSIGN macro usage from core
+
* Eliminate ''opASSIGN'' macro usage from core
* -Drv now means something on -DDEBUGGING builds
+
* ''-Drv'' now means something on ''-DDEBUGGING'' builds
  
 
=== Removed Features and Incompatible Changes ===
 
=== Removed Features and Incompatible Changes ===
* Removed modules: Math::BigInt::CalcEmu, arybase, Locale::Code, B::Debug
+
* Removed modules: ''Math::BigInt::CalcEmu'', ''arybase'', ''Locale::Codes'', ''B::Debug''
* Pattern delimiters now must be graphemes
 
 
* Delimiters must now be graphemes
 
* Delimiters must now be graphemes
* Some formerly deprecated uses of an unescaped left brace "{" in regular expression patterns are now illegal
+
* Some formerly deprecated uses of an unescaped left brace ''{'' in regular expression patterns are now illegal
* Assigning non-zero to $[ is fatal
+
* Assigning non-zero to ''$['' is fatal
* Previously deprecated sysread()/syswrite() on :utf8 handles now fatal
+
* Previously deprecated ''sysread()''/''syswrite()'' on '':utf8'' handles is now fatal
* my() in false conditional prohibited
+
* ''my()'' in a false conditional is prohibited
* Fatalize $* and $#
+
* Fatalize ''$*'' and ''$#''
* Fatalize unqualified use of dump()
+
* Fatalize unqualified use of ''dump()''
* Remove File::Glob::glob()
+
* Remove ''File::Glob::glob()''
* pack() no longer can return malformed UTF-8
+
* ''pack()'' no longer can return a malformed UTF-8
* Any set of digits in the Common script are legal in a script run of another script
+
* Any set of digits in the ''Common'' script is legal in a script run of another script
* JSON::PP enable allow_nonref by default
+
* ''JSON::PP'' enables ''allow_nonref'' by default
 +
* Site paths moved from ''/usr/local/…/perl5'' to ''/usr/local/…/perl5/5.30''
  
 
=== Deprecated Features ===
 
=== Deprecated Features ===
 
* In XS code, use of various macros dealing with UTF-8.
 
* In XS code, use of various macros dealing with UTF-8.
  
[[Category:ChangeReadyForWrangler]]
+
[[Category:ChangeAcceptedF31]]
 
<!-- When your change proposal page is completed and ready for review and announcement -->
 
<!-- When your change proposal page is completed and ready for review and announcement -->
 
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
 
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->

Latest revision as of 07:53, 6 March 2020


Perl 5.30

Summary

A new perl 5.30 version brings a lot of changes done over a year of development. Perl 5.30 was released 5/22/2019. See 5.30.0 perldelta for more details about preparing release.

Owner

Current Status

Completed Items

  • Upstream to release Perl 5.30
  • Get dedicated build-root from rel-engs (f31-perl)
  • Define perl_bootstrap in perl-srpm-macros
  • Rebase perl to 5.30.0
  • Rebuild dual-lived packages (otherwise dnf recommends --skip-broken and fails)
  • Rebuild packages needed for minimal build-root
  • Rebuild packages needed for building source packages from git repository
  • Rebuild other packages: Use Fedora::Rebuild dependency solver
  • Undefine perl_bootstrap
  • Rebuild packages having perl_bootstrap condition in spec file
  • Rebuild all updated packages
  • Final lists of results
  • Merge dedicated build-root to rawhide and remove the dedicated one by rel-engs
  • Synchronize packages upgraded in f31 build root

Items in Progress

  • Rebuilt Perl packages: 3180 of 3182 done (99.94%)
  • Failed builds (2):

Items to Be Done

Detailed Description

New perl is released every year and updates containing mainly bug fixes follow during the year. The 5.30.0 version is stable release this year.

In addition, Perl site paths will be made ABI-specific. CPAN modules intended for an installation under /usr/local/ will be installed to /usr/local/{share,lib*}/perl5/5.30 paths. This will prevent from breaking Perl with old locally installed modules after a Fedora upgrade.

Benefit to Fedora

Up-to-date and latest perl release will be delivered to Fedora users.

Scope

Every Perl package will be rebuilt in a dedicated f31-perl build-root against perl 5.30.0 and then if no major problem emerges the packages will be merged back to f31 build-root.

  • Proposal owners:

New perl and all packages requiring perl or a Perl module will be rebuilt into f31-perl build-root.

  • Other developers: N/A (not a System Wide Change)

Owners of packages that fail to rebuild, mainly perl-sig users, will be asked using Bugzilla to fix or remove their packages from the distribution.

  • Release engineering: #8368 (a check of an impact with Release Engineering is needed)

Release engineers will be asked for new f31-perl build-root inheriting from f31 build-root. After successful finishing the rebuild, they will be asked to merge f31-perl packages back to f31 build-root.

  • Policies and guidelines:

No policies have to be modified to complete this change.

Upgrade/Compatibility Impact

Vast majority of functionality will be preserved. Only the packages that failed to build against perl 5.30 will be removed from the distribution. That will require to remove those packages from existing systems otherwise package manager will encounter unsatisfied dependencies. Modules installed locally into /usr/local will become unavailable and users will need to reinstall them.

How to Test

Try upgrading from Fedora 30 to 31. Try some Perl application to verify they work as expected. Try embedded perl in slapd or snmpd.

User Experience

There should not be any remarkable change in user experience. With the exception that previously locally installed modules with a CPAN clients will need a reinstalation.

Dependencies

There is more than 3100 packages depending on perl. Most of them are expected not to break. Finishing this change can be endangered only by critical changes in a toolchain.

Contingency Plan

If we find perl 5.30 is not suitable for Fedora 31, we will revert back to perl 5.28 and we drop the temporary build-root with already rebuilt packages.

  • Contingency deadline: branching Fedora 31 from Rawhide.
  • Blocks release? No.

Documentation

Release Notes

Important Changes

  • Unicode 12.1 is supported
  • The upper limit n specifiable in a regular expression quantifier of the form {m,n} has been doubled to 65534
  • Wildcards in the Unicode property value specifications are now partially supported
  • qr'\N{name}' is now supported
  • It is now possible to compile perl to always use thread-safe locale operations.
  • Limited variable length lookbehind in regular expression pattern matching is now experimentally supported
  • Use faster method to convert to UTF-8
  • Turkic UTF-8 locales are now seamlessly supported
  • Eliminate opASSIGN macro usage from core
  • -Drv now means something on -DDEBUGGING builds

Removed Features and Incompatible Changes

  • Removed modules: Math::BigInt::CalcEmu, arybase, Locale::Codes, B::Debug
  • Delimiters must now be graphemes
  • Some formerly deprecated uses of an unescaped left brace { in regular expression patterns are now illegal
  • Assigning non-zero to $[ is fatal
  • Previously deprecated sysread()/syswrite() on :utf8 handles is now fatal
  • my() in a false conditional is prohibited
  • Fatalize $* and $#
  • Fatalize unqualified use of dump()
  • Remove File::Glob::glob()
  • pack() no longer can return a malformed UTF-8
  • Any set of digits in the Common script is legal in a script run of another script
  • JSON::PP enables allow_nonref by default
  • Site paths moved from /usr/local/…/perl5 to /usr/local/…/perl5/5.30

Deprecated Features

  • In XS code, use of various macros dealing with UTF-8.