From Fedora Project Wiki
(Initial version)
 
(→‎Current status: Remove perl-Crypt-PWSafe3 (fixed), perl-MouseX-App-Cmd (deprecated))
 
(38 intermediate revisions by 4 users not shown)
Line 2: Line 2:


== Summary ==
== Summary ==
A new ''perl 5.34'' version brings a lot of changes done over a year of development. Perl 5.34 will be released in May 20th 2021. See [https://metacpan.org/pod/release/TODDR/perl-5.33.9/pod/perldelta.pod 5.33.9 perldelta] for more details about new release.
A new ''perl 5.34'' version brings a lot of changes done over a year of development. Perl 5.34 will be released in May 20th 2021. See [https://metacpan.org/pod/release/XSAWYERX/perl-5.34.0/pod/perldelta.pod 5.34.0 perldelta] for more details about new release.


== Owner ==
== Owner ==
Line 14: Line 14:


== Current status ==
== Current status ==
[[Category:ChangePageIncomplete]]
[[Category:ChangeAcceptedF35]]
<!-- 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 -->
Line 32: Line 32:
ON_QA -> change is fully code complete
ON_QA -> change is fully code complete
-->
-->
* FESCo issue: <will be assigned by the Wrangler>
* FESCo issue: [https://pagure.io/fesco/issue/2609 #2609]
* Tracker bug: <will be assigned by the Wrangler>
* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=1962075 #1962075]
* Release notes tracker: <will be assigned by the Wrangler>
* Release notes tracker: [https://pagure.io/fedora-docs/release-notes/issue/698 #698]


=== Completed Items ===
=== Completed Items ===
 
* Get dedicated [https://pagure.io/releng/issue/10119 build-root from rel-engs (''f35-perl'')]
=== Items in Progress ===
 
=== Items to Be Done ===
* Get dedicated build-root from rel-engs (''f35-perl'')
* Upstream to release Perl 5.34
* Upstream to release Perl 5.34
<!--* Remove old perl(:MODULE_COMPAT_5.32.*) from perl -->
* Define perl_bootstrap in perl-srpm-macros
* Define perl_bootstrap in perl-srpm-macros
* Rebase perl to 5.34.0
* Rebase perl to 5.34.0
Line 50: Line 47:
* Rebuild packages needed for building source packages from git repository
* Rebuild packages needed for building source packages from git repository
* Rebuild other packages: Use Fedora::Rebuild dependency solver
* Rebuild other packages: Use Fedora::Rebuild dependency solver
<!--* Remove old perl(:MODULE_COMPAT_5.32.*) from perl -->
* Undefine perl_bootstrap
* Undefine perl_bootstrap
* Rebuild packages having perl_bootstrap condition in spec file
* Rebuild packages having perl_bootstrap condition in spec file (127 packages)
* Rebuild all updated packages
* Rebuild all updated packages
* [https://jplesnik.fedorapeople.org/5.34/ Final lists of results]
* [https://jplesnik.fedorapeople.org/5.34/ 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 ''f35'' build root
* Synchronize packages upgraded in ''f35'' build root
* Rebuild Perl packages: 0 of 3208 done (0.00%)
* Rebuild Perl packages: 3248 of 3248 done (100%)
 
=== Items in Progress ===
 
=== Items to Be Done ===


== Detailed Description ==
== Detailed Description ==
Line 74: Line 74:
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: [https://pagure.io/releng/issues #Releng issue number] <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
* Release engineering: [https://pagure.io/releng/issue/10106 #10106] <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
Release engineers will be asked for new ''f35-perl'' build-root inheriting from ''f35'' build-root. After successful finishing the rebuild, they will be asked to merge ''f35-perl'' packages back to ''f35'' build-root.
Release engineers will be asked for new ''f35-perl'' build-root inheriting from ''f35'' build-root. After successful finishing the rebuild, they will be asked to merge ''f35-perl'' packages back to ''f35'' build-root.
<!-- Does this feature require coordination with release engineering (e.g. changes to installer image generation or update package delivery)?  Is a mass rebuild required?  include a link to the releng issue.  
<!-- Does this feature require coordination with release engineering (e.g. changes to installer image generation or update package delivery)?  Is a mass rebuild required?  include a link to the releng issue.  
Line 89: Line 89:


== Upgrade/compatibility impact ==
== Upgrade/compatibility impact ==
Vast majority of functionality will be preserved. Only the packages that failed to build against perl 5.32 will be removed from the distribution. That will require to remove those packages from the existing systems otherwise a package manager will encounter unsatisfied dependencies. The developers in Perl language are advised to install ''perl-doc'' and ''perl-debugger'' packages.
Vast majority of functionality will be preserved. Only the packages that failed to build against perl 5.34 will be removed from the distribution. That will require to remove those packages from the existing systems otherwise a package manager will encounter unsatisfied dependencies. The developers in Perl language are advised to install ''perl-doc'' and ''perl-debugger'' packages.
 
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->


== How To Test ==
== How To Test ==
Try upgrading from Fedora 34 to 35. Try some Perl application to verify they work as expected. Try embedded perl in slapd or snmpd.
Try upgrading from Fedora 34 to 35. Try some Perl application to verify they work as expected. Try embedded perl in [https://src.fedoraproject.org/rpms/openldap slapd] or [https://src.fedoraproject.org/rpms/net-snmp snmpd].
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->


Line 110: Line 111:


== Documentation ==
== Documentation ==
* 5.34.0 perldelta
* [https://metacpan.org/pod/release/XSAWYERX/perl-5.34.0/pod/perldelta.pod 5.34.0 perldelta]
* An announcement on the perl-devel mailing list
* An announcement on the perl-devel mailing list
* An announcement on fedora-devel mailing list
* [https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/FQY75B6UX4PK4BFFAJZKXXS3BDY6LG3Z/ An announcement on fedora-devel mailing list]


== Release Notes ==
== Release Notes ==
TBD
 
* Experimental ''try''/''catch'' syntax was added
* ''qr/{,n}/'' is now accepted
* Blanks freely allowed within but adjacent to curly braces
* New octal syntax 0oddddd
* Lots of modules were updated
* Documentation was updated and some new pages were added
** ''perldocstyle'' - this document is a guide for the authorship and maintenance of the documentation that ships with Perl
** ''perlgov'' - this document describes the goals, scope, system, and rules for Perl's new governance model.
* ''-Dusedefaultstrict'' - EXPERIMENTAL: Perl can now be built with strict on by default (using this configuration option)

Latest revision as of 09:45, 3 May 2022

Perl 5.34

Summary

A new perl 5.34 version brings a lot of changes done over a year of development. Perl 5.34 will be released in May 20th 2021. See 5.34.0 perldelta for more details about new release.

Owner

Current status

Completed Items

  • Get dedicated build-root from rel-engs (f35-perl)
  • Upstream to release Perl 5.34
  • Define perl_bootstrap in perl-srpm-macros
  • Rebase perl to 5.34.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 (127 packages)
  • 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 f35 build root
  • Rebuild Perl packages: 3248 of 3248 done (100%)

Items in Progress

Items to Be Done

Detailed Description

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

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 f35-perl build-root against perl 5.34.0 and then if no major problem emerges the packages will be merged back to f35 build-root.

  • Proposal owners:

New perl and all packages requiring perl or a Perl module will be rebuilt into f35-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 engineers will be asked for new f35-perl build-root inheriting from f35 build-root. After successful finishing the rebuild, they will be asked to merge f35-perl packages back to f35 build-root.

  • Policies and guidelines: N/A (not needed for this Change)
  • Trademark approval: N/A (not needed for this Change)
  • Alignment with Objectives:

Upgrade/compatibility impact

Vast majority of functionality will be preserved. Only the packages that failed to build against perl 5.34 will be removed from the distribution. That will require to remove those packages from the existing systems otherwise a package manager will encounter unsatisfied dependencies. The developers in Perl language are advised to install perl-doc and perl-debugger packages.


How To Test

Try upgrading from Fedora 34 to 35. 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 reinstallation.

Dependencies

There is more than 3200 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.34 is not suitable for Fedora 35, we will revert back to perl 5.32 and we drop the temporary build-root with already rebuilt packages.

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

Documentation

Release Notes

  • Experimental try/catch syntax was added
  • qr/{,n}/ is now accepted
  • Blanks freely allowed within but adjacent to curly braces
  • New octal syntax 0oddddd
  • Lots of modules were updated
  • Documentation was updated and some new pages were added
    • perldocstyle - this document is a guide for the authorship and maintenance of the documentation that ships with Perl
    • perlgov - this document describes the goals, scope, system, and rules for Perl's new governance model.
  • -Dusedefaultstrict - EXPERIMENTAL: Perl can now be built with strict on by default (using this configuration option)