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