| 1 | Release instructions for dual-life ExtUtils::CBuilder |
| 2 | |
| 3 | 1. Check out a tag/commit corresponding to the release point. This |
| 4 | should generally be a Perl release (dev or stable). Make sure |
| 5 | your working tree is clear of extraneous files. E.g. |
| 6 | |
| 7 | $ git checkout v5.15.8 |
| 8 | $ git clean -dxf |
| 9 | |
| 10 | 2. Rsync the ExtUtils-CBuilder directory to a temporary directory for |
| 11 | release. E.g. |
| 12 | |
| 13 | $ rsync -av --delete dist/ExtUtils-CBuilder /tmp |
| 14 | |
| 15 | 3. Change to the temp directory |
| 16 | |
| 17 | $ cd /tmp/ExtUtils-CBuilder |
| 18 | |
| 19 | 4. Look at the Changes file. If it was not kept up to date in blead, |
| 20 | take a minute to feel sad, then update it. Remember to copy the |
| 21 | changes back to blead later. |
| 22 | |
| 23 | 5. Configure and then make a MANIFEST |
| 24 | |
| 25 | $ perl Makefile.PL |
| 26 | $ make manifest |
| 27 | |
| 28 | 6. Build a release directory and examine its contents, paying particular |
| 29 | attention to the MANIFEST and the META files |
| 30 | |
| 31 | $ make distdir |
| 32 | |
| 33 | 7. Test the release directory |
| 34 | |
| 35 | $ make disttest |
| 36 | |
| 37 | 8. If all looks good, create a tarball and upload it to CPAN (maybe |
| 38 | install CPAN::Uploader or an equivalent tool) |
| 39 | |
| 40 | $ make dist |
| 41 | $ cpan_upload ExtUtils-CBuilder-X.YYYZZZ.tar.gz |
| 42 | |
| 43 | 9. Update Porting/Maintainers.pl in the Perl repo with the new tarball |
| 44 | name for ExtUtils-CBuilder. |
| 45 | |
| 46 | 10. If you updated Changes, copy that back to blead now |
| 47 | |
| 48 | 11. Commit any changes to blead (or submit it as a patch if you don't have a |
| 49 | commit bit) |