Project:Perl/How to version-bump dev-perl

From Gentoo Wiki
Jump to: navigation, search

Here's a recipe for version-bumping dev-perl packages, with reasonable time expenditure. Please improve.

Who's doing what

In 2015:

  • zlogene: dev-perl/[A-F].*
  • dilfridge: dev-perl/[G-L].*
  • civil: dev-perl/[M-R].*
  • monsieurp: dev-perl/[S-Z].*

Preparations

  • Add typical dependencies to your installation (i.e., world)
dev-perl/CGI
dev-perl/File-ShareDir-Install
dev-perl/Module-Build-Tiny
dev-perl/Test-Base
dev-perl/Test-Differences
dev-perl/Test-Exception
dev-perl/Test-Fatal
dev-perl/Test-MockObject
dev-perl/Test-NoWarnings
dev-perl/Test-Pod
dev-perl/Test-Requires
dev-perl/Test-Warn
dev-perl/Test-Warnings
  • If you're on stable, update some dev-perl packages to ~arch
to do: which ones?
  • enable tests for perl-core, dev-perl, and dev-lang/perl:
FILE /etc/portage/package.env
perl-core/* tests
dev-perl/* tests
dev-lang/perl tests
FILE /etc/portage/env/tests
FEATURES=test

Bumping a package

  • Pick a package to be bumped, say dev-perl/foo-bar
  • Search on CPAN for it (foo::bar), and open the corresponding page of the latest version, say 1.05
  • Copy latest existing ebuild version to new version, i.e. foo-bar-1.50.0.ebuild (use gentoo-modperl-version.pl if you're not sure about the conversion)
  • ekeyword ~all foo-bar-1.50.0.ebuild
  • Open foo-bar-1.50.0.ebuild in an editor.
  • Set EAPI=6
  • MODULE_VERSION becomes DIST_VERSION, MODULE_AUTHOR becomes DIST_AUTHOR (check if it's still the same), MY_PN becomes DIST_NAME, SRC_TEST becomes DIST_TEST (or just delete it)
  • In the CPAN tab, open META.json or META.yml
  • Compare the contents there with the specified dependencies. Add whatever is missing (always convert the version numbers). corelist and CPAN search help.
  • ...