summaryrefslogtreecommitdiff
path: root/Porting
diff options
context:
space:
mode:
authorNicolas R <atoomic@cpan.org>2019-02-20 09:32:59 -0700
committerSteve Hay <steve.m.hay@googlemail.com>2019-03-28 13:26:17 +0000
commit668c4090fe84d9363e8beb065d0f4b9084fa5559 (patch)
tree4acdaf7f41902cc2eba48935a50cceee1370a50a /Porting
parentf3785624dad1e8059c020baecd5adc8176979b46 (diff)
downloadperl-668c4090fe84d9363e8beb065d0f4b9084fa5559.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. (cherry picked from commit df369d8ee09f81094572bc2715837100c7f01bfb)
Diffstat (limited to 'Porting')
-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