Skip to content

Commit 3f46175

Browse files
committed
Update release manager's guide
1 parent f9468e1 commit 3f46175

File tree

1 file changed

+13
-5
lines changed

1 file changed

+13
-5
lines changed

Porting/release_managers_guide.pod

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@
33
=head1 NAME
44

55
release_managers_guide - Releasing a new version of perl 5.x
6-
76
Note that things change at each release, so there may be new things not
87
covered here, or tools may need updating.
98

@@ -102,6 +101,9 @@ key steps are missing. If you do use your own fork then extra care
102101
needs to be taken when setting/pushing the tag and doing the merge
103102
(do B<not> use a PR).
104103

104+
As you follow these steps, please record notes of anything that you found
105+
to be unclear; improving this guide is an important part of releasing.
106+
105107
=head2 Release types
106108

107109
=over 4
@@ -964,13 +966,19 @@ Build perl, then make sure it passes its own test suite, and installs:
964966

965967
$ make test install
966968

969+
For an odd-numbered version, perl will install itself as
970+
C</tmp/perl-5.X.Y-pretest/bin/perl5.X.Y> rather than
971+
C</tmp/perl-5.X.Y-pretest/bin/perl>.
972+
967973
Check that the output of C</tmp/perl-5.X.Y-pretest/bin/perl -v> and
968974
C</tmp/perl-5.X.Y-pretest/bin/perl -V> are as expected,
969975
especially as regards version numbers, patch and/or RC levels, and @INC
970-
paths. Note that as they have been built from a git working
971-
directory, they will still identify themselves using git tags and
972-
commits. (Note that for an odd-numbered version, perl will install
973-
itself as C<perl5.X.Y>). C<perl -v> will identify itself as:
976+
paths.
977+
978+
Note that as they have been built from a git working directory, they
979+
will still identify themselves using git tags and commits.
980+
981+
C<perl -v> (or C<perl5.X.Y -v>) will identify itself as:
974982

975983
This is perl 5, version X, subversion Y (v5.X.Y (v5.XX.Z-NNN-gdeadbeef))
976984

0 commit comments

Comments
 (0)