RMG - Note that Porting/cmVERSION.pl should be used to check more releases

t/porting/cmp_version.t only runs Porting/cmVERSION.pl for the previous
release of the current branch, but we need to check that our versions
differ from modules in releases from other branches too. For example,
when releasing 5.20.2 we need to check against 5.18.4 too.

diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod
index 7f80ee7..76e0f45 100644 (file)
--- a/Porting/release_managers_guide.pod
+++ b/Porting/release_managers_guide.pod
@@ -535,6 +535,20 @@ then configure and build perl so that you have a Makefile and porting tools:
 
     $ ./Configure -Dusedevel -des && make
 
+=head3 Check module versions
+
+For each Perl release since the previous release of the current branch, check
+for modules that have identical version numbers but different contents by
+running:
+
+    $ ./perl Porting/cmpVERSION.pl --tag=v5.X.YY
+
+(This is done automatically by F<t/porting/cmp_version.t> for the previous
+release of the current branch, but not for any releases from other branches.)
+
+Any modules that fail will need a version bump, plus a nudge to the upstream
+maintainer for 'cpan' upstream modules.
+
 =head3 update Module::CoreList
 
 =head4 Bump Module::CoreList* $VERSIONs