F37 proposal: Perl 5.36 (System-Wide Change proposal)

[Ben Cotton]

This document represents a proposed Change. As part of the Changes
process, proposals are publicly announced in order to receive
community feedback. This proposal will only be implemented if approved
by the Fedora Engineering Steering Committee.

https://fedoraproject.org/wiki/Changes/perl5.36


== Summary ==
A new ''perl 5.36'' version brings a lot of changes done over a year
of development. Perl 5.36 will be released in May 20th 2022. See
[https://metacpan.org/pod/release/SHAY/perl-5.35.11/pod/perldelta.pod
5.36.0 perldelta] for more details about new release.

== Owner ==
* Name: [[User:Jplesnik| Jitka Plesníková]]
* Email: <jplesnik(a)redhat.com&gt;
* Name: [[User:Mspacek| Michal Josef Špaček]]
* Email: <mspacek(a)redhat.com&gt;


=== Completed Items ===

=== Items in Progress ===

=== Items to Be Done ===

* Get dedicated <!--[https://pagure.io/releng/issue/10119 -->
build-root from rel-engs (''f37-perl'') <!-- ] -->
* Upstream to release Perl 5.36
<!--* Remove old perl(:MODULE_COMPAT_5.34.*) from perl -->
* Define perl_bootstrap in perl-srpm-macros
* Rebase perl to 5.36.0
<!--* Build new perl 5.36 keeping old COMPAT Provides -->
* 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
* [https://jplesnik.fedorapeople.org/5.36/ Final lists of results]
* Merge dedicated build-root to rawhide and remove the dedicated one by rel-engs
* Synchronize packages upgraded in ''f37'' build root
* Rebuild Perl packages: 0 of 3261 done (0.00%)

== Detailed Description ==
New perl is released every year and updates containing mainly bug
fixes follow during the year. The 5.36.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 ''f37-perl''
build-root against perl 5.36.0 and then if no major problem emerges
the packages will be merged back to ''f37'' build-root.

* Proposal owners:
New perl and all packages requiring perl or a Perl module will be
rebuilt into ''f37-perl'' build-root.

* Other developers: 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/issue/10771 #10771]
Release engineers will be asked for new ''f37-perl'' build-root
inheriting from ''f37'' build-root. After successful finishing the
rebuild, they will be asked to merge ''f37-perl'' packages back to
''f37'' 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.36 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 36 to 37. 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].


== 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 ==
* Contingency mechanism: If we find perl 5.36 is not suitable for
Fedora 37, we will revert back to perl 5.34 and we drop the temporary
build-root with already rebuilt packages.
* Contingency deadline: branching Fedora 37 from Rawhide.
* Blocks release? No.

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

== Release Notes ==



-- 
Ben Cotton
He / Him / His
Fedora Program Manager
Red Hat
TZ=America/Indiana/Indianapolis