Skip to content

Commit ccd42f7

Browse files
thibaultduponchellekhwilliamson
authored andcommitted
RMG: More code in code block (ready to copy-paste)
1 parent c1768da commit ccd42f7

File tree

1 file changed

+28
-12
lines changed

1 file changed

+28
-12
lines changed

Porting/release_managers_guide.pod

Lines changed: 28 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -577,7 +577,10 @@ blead release, so you may find nothing to do here.
577577

578578
=head3 Update AUTHORS
579579

580-
The AUTHORS file can be updated by running F<Porting/updateAUTHORS.pl>.
580+
The AUTHORS file can be updated by running:
581+
582+
$ perl Porting/updateAUTHORS.pl
583+
581584
This shouldn't really be necessary anymore, and in theory nothing should
582585
change as our CI should not pass if a commit would result in AUTHORS
583586
needing to change, but do it anyway to be sure. Make sure all your changes
@@ -1170,7 +1173,7 @@ Test L<perlbug> with the following:
11701173
Action (Send/Display/Edit/Subject/Save to File): f
11711174
Name of file to save message in [perlbug.rep]:
11721175

1173-
and carefully examine the output (in F<perlbug.rep]>), especially
1176+
Then carefully examine the output (in F<perlbug.rep]>), especially
11741177
the "Locally applied patches" section.
11751178

11761179
=for checklist skip BLEAD-POINT
@@ -1347,21 +1350,33 @@ Confirm that you have a clean checkout with no local changes.
13471350
=item *
13481351

13491352
Run:
1350-
perl Porting/new-perldelta.pl
1353+
1354+
$ perl Porting/new-perldelta.pl
13511355

13521356
=item *
13531357

13541358
Run the C<git add> commands it outputs to add new and modified files.
13551359

13561360
=item *
13571361

1358-
Verify that the build still works, by running C<./Configure> and
1359-
C<make test_porting>. (On Win32 use the appropriate make utility).
1362+
Verify that the build still works, by running:
1363+
1364+
$ ./Configure
1365+
$ make test_porting
1366+
1367+
(On Win32 use the appropriate make utility).
13601368

13611369
=item *
13621370

1363-
If F<t/porting/podcheck.t> spots errors in the new F<pod/perldelta.pod>,
1364-
run C<./perl -MTestInit t/porting/podcheck.t | less> for more detail.
1371+
Run:
1372+
1373+
$ ./perl t/porting/podcheck.t
1374+
1375+
If it spots errors in the new F<pod/perldelta.pod>, run:
1376+
1377+
$ ./perl -MTestInit t/porting/podcheck.t | less
1378+
1379+
It will give you more details.
13651380
Skip to the end of its test output to see the options it offers you.
13661381

13671382
=item *
@@ -1380,8 +1395,6 @@ previous version bump.
13801395

13811396
=head3 Bump the feature bundles
13821397

1383-
I<You MUST SKIP this step for RC and MAINT>
1384-
13851398
If this was a BLEAD-FINAL release (i.e. the first release of a new maint
13861399
series, 5.x.0 where x is even), then bump the version in the blead branch
13871400
in git, e.g. 5.12.0 to 5.13.0.
@@ -1393,7 +1406,11 @@ marker); e.g.
13931406
"5.14" => [qw(switch say state unicode_strings)],
13941407
+ "5.15" => [qw(switch say state unicode_strings)],
13951408

1396-
Run F<regen/feature.pl> to propagate the changes to F<lib/feature.pm>.
1409+
Run:
1410+
1411+
$ ./perl regen/feature.pl
1412+
1413+
It will propagate the changes to F<lib/feature.pm>.
13971414

13981415
After bumping the version, follow the section L</"Update INSTALL"> to
13991416
ensure all version number references are correct.
@@ -1449,8 +1466,7 @@ Commit your changes:
14491466

14501467
$ git status
14511468
$ git diff
1452-
B<review the delta carefully>
1453-
1469+
# Review the delta carefully
14541470
$ git commit -a -m 'Bump the perl version in various places for 5.X.Y'
14551471

14561472
At this point you may want to compare the commit with a previous bump to

0 commit comments

Comments
 (0)