From Fedora Project Wiki
(Initial version)
 
(More details)
Line 2: Line 2:
  
 
== Summary ==
 
== Summary ==
[http://search.cpan.org/ search.cpan.org] web frontend for [https://www.cpan.org/ CPAN] is being replaced by [https://metacpan.org/ metacpan.org]. Many Perl RPM packages refer to the search.cpan.org. This Fedora change aims to mass-update URL and Source RPM tags.
+
''[http://search.cpan.org/ search.cpan.org]'' web frontend for ''[https://www.cpan.org/ CPAN]'' is being replaced by ''[https://metacpan.org/ metacpan.org]''. Many Perl RPM packages refer to ''search.cpan.org''. This Fedora change aims to mass-update URL and Source RPM tags in affected Perl packages.
  
 
== Owner ==
 
== Owner ==
Line 31: Line 31:
 
== Detailed Description ==
 
== Detailed Description ==
  
Fedora packages store URL to the upstream web page and URL to source archive location in their metadata. Most of the Perl packages uses search.cpan.org for this purpose. However, [https://log.perl.org/2018/05/goodbye-search-dot-cpan-dot-org.html search.cpan.org won't be the canonical source] anymore. We should update the metadata to point to the new location.
+
Fedora packages store URL to the upstream web page and URL to the source archive location in their metadata. Most of the Perl packages uses ''search.cpan.org'' for this purpose. However, [https://log.perl.org/2018/05/goodbye-search-dot-cpan-dot-org.html search.cpan.org won't be the canonical source] anymore. We should update the metadata to point to the new location.
 +
 
 +
Specification for all Perl packages will be updated like this:
 +
 
 +
<pre>-URL:            http://search.cpan.org/dist/CPANPLUS/
 +
-Source0:        http://www.cpan.org/authors/id/B/BI/BINGOS/CPANPLUS-%{cpan_version}.tar.gz
 +
+URL:            https://metacpan.org/release/CPANPLUS
 +
+Source0:        https://cpan.metacpan.org/authors/id/B/BI/BINGOS/CPANPLUS-%{cpan_version}.tar.gz</pre>
 +
 
 +
This change will be pushed as one commit into each affected Perl package without increasing its release number. We will try to do this change before Perl 5.28 mass rebuild in order to have it visible in Fedora 29 binary repositories.
  
 
== Benefit to Fedora ==
 
== Benefit to Fedora ==
Line 65: Line 74:
  
 
== Documentation ==
 
== Documentation ==
<!-- Is there upstream documentation on this change, or notes you have written yourself?  Link to that material here so other interested developers can get involved. -->
+
* [http://search.cpan.org/ search.cpan.org] – the old web interface
 +
* [https://metacpan.org/ metacpan.org] – the new web interface
 +
* [https://log.perl.org/2018/05/goodbye-search-dot-cpan-dot-org.html Perl NOC announcement]
 +
* [https://fedoraproject.org/wiki/Packaging:Perl Perl packaging guidelines]
 +
* [https://lists.fedoraproject.org/archives/list/perl-devel@lists.fedoraproject.org/thread/4AMIYRZBZDW2H5274FXIRGNJLCWHQK7Q/#4AMIYRZBZDW2H5274FXIRGNJLCWHQK7Q Discussion on perl-devel Fedora mailing list]
 +
* [https://github.com/release-monitoring/anitya/issues/558 Anitya CPAN backend update request]
  
 
== Release Notes ==
 
== Release Notes ==

Revision as of 16:04, 24 May 2018

Perl Move to MetaCPAN

Summary

search.cpan.org web frontend for CPAN is being replaced by metacpan.org. Many Perl RPM packages refer to search.cpan.org. This Fedora change aims to mass-update URL and Source RPM tags in affected Perl packages.

Owner

  • Name: Petr Písař
  • Email: <ppisar@redhat.com>
  • Release notes owner:

Current status

  • Targeted release: Fedora 29
  • Last updated: 2018-05-24
  • Tracker bug: <will be assigned by the Wrangler>

Detailed Description

Fedora packages store URL to the upstream web page and URL to the source archive location in their metadata. Most of the Perl packages uses search.cpan.org for this purpose. However, search.cpan.org won't be the canonical source anymore. We should update the metadata to point to the new location.

Specification for all Perl packages will be updated like this:

-URL:            http://search.cpan.org/dist/CPANPLUS/
-Source0:        http://www.cpan.org/authors/id/B/BI/BINGOS/CPANPLUS-%{cpan_version}.tar.gz
+URL:            https://metacpan.org/release/CPANPLUS
+Source0:        https://cpan.metacpan.org/authors/id/B/BI/BINGOS/CPANPLUS-%{cpan_version}.tar.gz

This change will be pushed as one commit into each affected Perl package without increasing its release number. We will try to do this change before Perl 5.28 mass rebuild in order to have it visible in Fedora 29 binary repositories.

Benefit to Fedora

Provide up-to-date home page in package descriptions to Fedora users. Fetch sources into Fedora infrastructure directly from upstream location.

Scope

  • Proposal owners: Rewrite URL and Source addresses in Perl package specification files.
  • Other developers: Make sure the new addresses are correct.
  • Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

This change has no impact on run-time.

How To Test

Package rebuilt after this change won't display search.cpan.org in rpm -qi' output.

User Experience

URL in in RPM packages uses metacpan.org instead of search.cpan.org.

Dependencies

There are no dependencies.

Contingency Plan

Reverting Perl packaging guidelines change.

Documentation

Release Notes

This change does not need to be highlighted in the release notes.