Be a bit clearer about always needing to regen perl.pod and friends at release time
Jesse Vincent [Sat, 1 Aug 2009 18:39:24 +0000 (19:39 +0100)]
Porting/release_managers_guide.pod

index 1900034..2f7728e 100644 (file)
@@ -626,24 +626,14 @@ Rafael to update http://dev.perl.org/perl5/
 
 I<You MUST SKIP this step for SNAPSHOT, RC>
 
-
 Create a new empty perlNNNdelta.pod file for the current release + 1;
 see F<Porting/how_to_write_a_perldelta.pod>.
 [ XXX Perhaps we should have an empty template file we can copy in. ]
 
 In addition, edit F<pod.lst>, adding the new entry as 'D', and unmark previous
-entry as 'D', then run C<perl pod/buildtoc --build-all> to update the
-following files:
-
-    MANIFEST
-    pod/perl.pod
-    win32/pod.mak
-    vms/descrip_mms.template
+entry as 'D',
 
-(F<vms/descrip_mms.template> still needs a manual edit to bump the
-C<perldelta.pod> entry - it would be good for someone to figure out the fix.)
-
-and change perlNNNdelta references to the new version in these files
+Change perlNNNdelta references to the new version in these files
 
     INSTALL
     win32/Makefile.mk
@@ -661,6 +651,19 @@ on the previous filename to look for suitable candidates.
 
 =item *
 
+Run C<perl pod/buildtoc --build-all> to update the following files:
+
+    MANIFEST
+    pod/perl.pod
+    win32/pod.mak
+    vms/descrip_mms.template
+
+If you modified perldelta.pod, (F<vms/descrip_mms.template> will
+needs a manual edit to bump the C<perldelta.pod> entry - it would
+be good for someone to figure out the fix.)
+
+=item *
+
 I<You MUST SKIP this step for SNAPSHOT, RC, BLEAD>
 
 If this was a maint release, then edit F<Porting/mergelog> to change