|
3 | 3 | =head1 NAME |
4 | 4 |
|
5 | 5 | release_managers_guide - Releasing a new version of perl 5.x |
6 | | - |
7 | 6 | Note that things change at each release, so there may be new things not |
8 | 7 | covered here, or tools may need updating. |
9 | 8 |
|
@@ -102,6 +101,9 @@ key steps are missing. If you do use your own fork then extra care |
102 | 101 | needs to be taken when setting/pushing the tag and doing the merge |
103 | 102 | (do B<not> use a PR). |
104 | 103 |
|
| 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 | + |
105 | 107 | =head2 Release types |
106 | 108 |
|
107 | 109 | =over 4 |
@@ -964,13 +966,19 @@ Build perl, then make sure it passes its own test suite, and installs: |
964 | 966 |
|
965 | 967 | $ make test install |
966 | 968 |
|
| 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 | + |
967 | 973 | Check that the output of C</tmp/perl-5.X.Y-pretest/bin/perl -v> and |
968 | 974 | C</tmp/perl-5.X.Y-pretest/bin/perl -V> are as expected, |
969 | 975 | 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: |
974 | 982 |
|
975 | 983 | This is perl 5, version X, subversion Y (v5.X.Y (v5.XX.Z-NNN-gdeadbeef)) |
976 | 984 |
|
|
0 commit comments