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

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

• Open the following tabs in a browser of your choice:
  • Euscan page for the dev-perl category
  • CPAN search

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.
• ...