diff options
author | Jesse Vincent <jesse@bestpractical.com> | 2011-01-01 18:46:20 +0800 |
---|---|---|
committer | Jesse Vincent <jesse@bestpractical.com> | 2011-01-01 18:59:28 +0800 |
commit | edcf105d70e5423fd928c776e086fe31a4a543f4 (patch) | |
tree | 55e11dcb878fb42c5ee28b42305d6ffddcfbd10f | |
parent | b85802c5d04fcd6e5c969a5c56136e05061f05d7 (diff) | |
download | perl-edcf105d70e5423fd928c776e086fe31a4a543f4.tar.gz |
Document 'test_porting' and start a section on how committing to blead
-rw-r--r-- | pod/perlrepository.pod | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/pod/perlrepository.pod b/pod/perlrepository.pod index 1af48e23d7..0ae0ce49e8 100644 --- a/pod/perlrepository.pod +++ b/pod/perlrepository.pod @@ -915,6 +915,35 @@ deleted or modified. Think long and hard about whether you want to push a local tag to perl.git before doing so. (Pushing unannotated tags is not allowed.) +=head1 Committing to blead + +If you are a committer, you have the right to commit changes directly to +the 'blead' branch, which will become the next production release of Perl. + +Before pushing I<any> local change to blead, it's incredibly important +that you do a few things, lest other committers come after you with +pitchforks and torches: + +=over + +=item * + +Make sure you have a good commit message. See </Commit message> elsewhere in +this document + +=item * + +Run the test suite. You might not think that one typo fix would break +a test file. You'd be wrong + +=item * + +If you don't run the full test suite, at least C<make test_porting>. +This will run basic sanity checks. To see which sanity checks, have a +look in F<t/porting>. + +=back + =head1 Committing to maintenance versions Maintenance versions should only be altered to add critical bug fixes, @@ -934,6 +963,9 @@ using the C<git cherry-pick> command. It is recommended to use the B<-x> option to C<git cherry-pick> in order to record the SHA1 of the original commit in the new commit message. +Before pushing any change to a maint version, make sure you've satisfied +the steps in L</Committing to blead> above. + =head1 Grafts The perl history contains one mistake which was not caught in the |