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