perl5160delta: Document wrap_op_checker

[perl5.git] / Porting / release_managers_guide.pod

diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod
index d2ff51f..67cd001 100644 (file)
--- a/Porting/release_managers_guide.pod
+++ b/Porting/release_managers_guide.pod
@@ -220,13 +220,13 @@ directory to the original name.
 
 =item *
 
-Restore any C<.gitignore> file. This can be done by issueing 
-C<git checkout .gitignore> in the C<cpan/Distro> directory.
+Restore any F<.gitignore> file. This can be done by issueing 
+C<git checkout .gitignore> in the F<cpan/Distro> directory.
 
 =item *
 
 Remove files we do not need. That is, remove any files that match the
-entries in C<@IGNORE> in C<Porting/Maintainer.pl>, and anything that 
+entries in C<@IGNORE> in F<Porting/Maintainer.pl>, and anything that 
 matches the C<EXCLUDED> section of the distro's entry in the C<%Modules>
 hash.
 
@@ -257,7 +257,7 @@ C<perl Porting/manisort --output MANIFEST.sort; mv MANIFEST.sort MANIFEST>.
 =item *
 
 For any files that have an execute bit set, either remove the execute
-bit, or edit C<Porting/exec-bit.txt>
+bit, or edit F<Porting/exec-bit.txt>
 
 =item *
 
@@ -269,11 +269,11 @@ Run the tests for the package.
 
 =item *
 
-Run the tests in C<t/porting>.
+Run the tests in F<t/porting>.
 
 =item *
 
-Update the C<DISTRIBUTION> entry in C<Porting/Maintainers.pl>.
+Update the C<DISTRIBUTION> entry in F<Porting/Maintainers.pl>.
 
 =item *
 
@@ -288,7 +288,7 @@ If everything is ok, commit the changes.
 For entries with a non-simple C<FILES> section, or with a C<MAP>, you
 may have to take more steps than listed above.
 
-C<Porting/sync-with-cpan> is a script that automates most of the steps
+F<Porting/sync-with-cpan> is a script that automates most of the steps
 above; but see the comments at the beginning of the file.
 
 
@@ -606,6 +606,8 @@ Update this version's entry in the C<%released> hash with today's date.
 =item *
 
 Make sure that the script has correctly updated the C<CAVEATS> section
+(Note, the C<CAVEATS> section is in
+F<dist/Module-CoreList/lib/Module/CoreList.pod>)
 
 =back
 
@@ -615,7 +617,7 @@ Finally, commit the new version of Module::CoreList:
 (unless this is for MAINT; in which case commit it to blead first, then
 cherry-pick it back).
 
-    $ git commit -m 'Update Module::CoreList for 5.x.y' dist/Module-CoreList/lib/Module/CoreList.pm
+    $ git commit -m 'Update Module::CoreList for 5.x.y' dist/Module-CoreList/lib/Module/CoreList.pm dist/Module-CoreList/lib/Module/CoreList.pod
 
 =for checklist skip RC
 
@@ -672,7 +674,13 @@ C</tmp/perl-5.x.y-pretest/bin/perl -V> are as expected,
 especially as regards version numbers, patch and/or RC levels, and @INC
 paths. Note that as they have been been built from a git working
 directory, they will still identify themselves using git tags and
-commits.
+commits. (Note that for an odd-numbered version, perl will install
+itself as C<perl5.x.y>). C<perl -v> will identify itself as:
+
+ This is perl 5, version X, subversion Y (v5.X.Y (v5.X.Z-NNN-deadbeef))
+
+where 5.X.Z is the latest tag, Z the number of commits since this tag,
+and C<< deadbeef >> commit of that tag.
 
 Then delete the temporary installation.
 
@@ -1214,6 +1222,8 @@ to link to this new release. Then make a pull request to Leo Lapworth.
 If this fails for some reason and you cannot cajole anybody else into
 submitting that change, you can mail Leo as last resort.
 
+This repository can be found on L<github|https://github.com/perlorg/perlweb>.
+
 =for checklist end
 
 =head1 SOURCE