summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNicolas R <atoomic@cpan.org>2019-02-20 09:32:59 -0700
committerNicolas R <atoomic@cpan.org>2019-02-20 09:45:34 -0700
commitdf369d8ee09f81094572bc2715837100c7f01bfb (patch)
tree6e1098142defba5bcdb75661d6a2753cf5f3bd3b
parentb6125dfcd017e2dd18dacdce91a6e071499b7aed (diff)
downloadperl-df369d8ee09f81094572bc2715837100c7f01bfb.tar.gz
Add note for BLEAD point release to release_managers_guide.pod
Add note concerning the bump of PERL_API_* constants for blead point releases.
-rw-r--r--Porting/release_managers_guide.pod12
1 files changed, 9 insertions, 3 deletions
diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod
index bcb3c856e2..254b8f2f52 100644
--- a/Porting/release_managers_guide.pod
+++ b/Porting/release_managers_guide.pod
@@ -435,9 +435,11 @@ F<pod/perlpolicy.pod>.
When doing a BLEAD-POINT or BLEAD-FINAL release, also make sure the
C<PERL_API_*> constants in F<patchlevel.h> are in sync with the version
you're releasing, unless you're absolutely sure the release you're about to
-make is 100% binary compatible to an earlier release. When releasing a MAINT
-perl version, the C<PERL_API_*> constants C<MUST NOT> be changed as we aim
-to guarantee binary compatibility in maint branches.
+make is 100% binary compatible to an earlier release. Note: for BLEAD-POINT
+releases the bump should have already occured at the end of the previous release
+and this is somethig you would have to do at the very end.
+When releasing a MAINT perl version, the C<PERL_API_*> constants C<MUST NOT>
+be changed as we aim to guarantee binary compatibility in maint branches.
After editing, regenerate uconfig.h (this must be run on a system with a
/bin/sh available):
@@ -479,6 +481,7 @@ version number.
=head3 update INSTALL
Review and update INSTALL to account for the change in version number.
+INSTALL for a BLEAD-POINT release should already contain the expected version.
The lines in F<INSTALL> about "is not binary compatible with" may require a
correct choice of earlier version to declare incompatibility with. These are
in the "Changes and Incompatibilities" and "Coexistence with earlier versions
@@ -531,6 +534,9 @@ C<-Dusethreads>
If you have multiple compilers on your machine, you might also consider
compiling with C<-Dcc=$other_compiler>.
+You can also consider pushing the repo to GitHub where Travis CI is enabled
+which would smoke different flavors of Perl for you.
+
=head3 update perlport
L<perlport> has a section currently named I<Supported Platforms> that