README.patching
1Patching instructions for ExtUtils::CBuilder
2
31. Check for any changes to .pm files since dev or stable Perl release. E.g.
4to check for changes since v5.15.8:
5
6 $ cd dist/ExtUtils-CBuilder
7 $ git log v5.15.8..blead -- .
8
92. If you are making the first change since the last Perl release, you need to
10bump the $VERSION in all .pm files and update the Changes file with the new
11version. In the Changes file, put the expected *NEXT* release of Perl (dev or
12stable) as the release date and version. E.g. after v5.15.8, I added this line
13to Changes to indicate what will be next release:
14
15 0.280206 - 2012-03-20 (Perl v5.15.9)
16
173. Add an entry to Changes for your work
18
194. Update Makefile.PL, MANIFEST.SKIP or other support files as necessary. E.g.
20update Makefile.PL with any changes to prerequisites.
21
225. Commit all changes (preferably to a branch)
23
246. Run Configure/make/make test and check for errors. If there are any, fix them.
25
267. If all is well, push your commits to blead or send a patch to p5p if you do
27not have commit access to the Perl 5 repository
28
README.release
1Release instructions for dual-life ExtUtils::CBuilder
2
31. Check out a tag/commit corresponding to the release point. This
4should generally be a Perl release (dev or stable). Make sure
5your working tree is clear of extraneous files. E.g.
6
7 $ git checkout v5.15.8
8 $ git clean -dxf
9
102. Rsync the ExtUtils-CBuilder directory to a temporary directory for
11release. E.g.
12
13 $ rsync -av --delete dist/ExtUtils-CBuilder /tmp
14
153. Change to the temp directory
16
17 $ cd /tmp/ExtUtils-CBuilder
18
194. Look at the Changes file. If it was not kept up to date in blead,
20take a minute to feel sad, then update it. Remember to copy the
21changes back to blead later.
22
235. Configure and then make a MANIFEST
24
25 $ perl Makefile.PL
26 $ make manifest
27
286. Build a release directory and examine its contents, paying particular
29attention to the MANIFEST and the META files
30
31 $ make distdir
32
337. Test the release directory
34
35 $ make disttest
36
378. If all looks good, create a tarball and upload it to CPAN (maybe
38install CPAN::Uploader or an equivalent tool)
39
40 $ make dist
41 $ cpan_upload ExtUtils-CBuilder-X.YYYZZZ.tar.gz
42
439. Update Porting/Maintainers.pl in the Perl repo with the new tarball
44name for ExtUtils-CBuilder.
45
4610. If you updated Changes, copy that back to blead now
47
4811. Commit any changes to blead (or submit it as a patch if you don't have a
49commit bit)
50