summaryrefslogtreecommitdiff
path: root/Porting/release_managers_guide.pod
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2011-07-21 11:29:01 +0200
committerNicholas Clark <nick@ccl4.org>2011-07-21 11:29:01 +0200
commitd5c37431deed6dedf93a85a51fd4124ff0997036 (patch)
tree4669474138fcadafbb387dd4802a802b37e2e06b /Porting/release_managers_guide.pod
parentc493c0a1e017a7a6f724bd4ac82466013a065609 (diff)
downloadperl-d5c37431deed6dedf93a85a51fd4124ff0997036.tar.gz
Add "clean build and test" as a step in the release manager's guide.
Some of the post-release steps can cause test failures (and hence black smoke) if not addressed at the time.
Diffstat (limited to 'Porting/release_managers_guide.pod')
-rw-r--r--Porting/release_managers_guide.pod11
1 files changed, 11 insertions, 0 deletions
diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod
index d2a6d036d9..ad4b2d78ad 100644
--- a/Porting/release_managers_guide.pod
+++ b/Porting/release_managers_guide.pod
@@ -931,6 +931,17 @@ Then follow the section L<"Bump the version number"> to bump the version
in the remaining files and test and commit.
+=head3 clean build and test
+
+Run a clean build and test to make sure nothing obvious is broken.
+
+In particular, F<Porting/perldelta_template.pod> is intentionally exempted
+from podchecker tests, to avoid false positives about placeholder text.
+However, once it's copied to F<pod/perldelta.pod> the contents can now
+cause test failures. Problems should resolved either by replacing placeholder
+text with correct text, or following the instructions output by
+F<t/porting/podcheck.t> on how to update its exceptions database.
+
=head3 push commits
Finally, push any commits done above.