In perl.git, the branch blead has been updated <http://perl5.git.perl.org/perl.git/commitdiff/2174049d55b865d9bed8adad15157d3061d5ae10?hp=29179484f257f0cbf448b1d9ee80035b7268a540>
- Log ----------------------------------------------------------------- commit 2174049d55b865d9bed8adad15157d3061d5ae10 Author: Chris 'BinGOs' Williams <[email protected]> Date: Tue Nov 25 19:01:40 2014 +0000 Update release manager documents for producing .xz tarballs ----------------------------------------------------------------------- Summary of changes: Porting/release_announcement_template.txt | 1 + Porting/release_managers_guide.pod | 13 +++++++++---- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/Porting/release_announcement_template.txt b/Porting/release_announcement_template.txt index 5f2e897..0e11e6a 100644 --- a/Porting/release_announcement_template.txt +++ b/Porting/release_announcement_template.txt @@ -14,6 +14,7 @@ SHA1 digests for this release are: [TAR.GZ SHA1] perl-5.[VERSION.SUBVERSION].tar.gz [TAR.BZ2 SHA1] perl-5.[VERSION.SUBVERSION].tar.bz2 + [TAR.XZ SHA1] perl-5.[VERSION.SUBVERSION].tar.xz You can find a full list of changes in the file "perldelta.pod" located in the "pod" directory inside the release and on the web. diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod index 6db408b..29d04c7 100644 --- a/Porting/release_managers_guide.pod +++ b/Porting/release_managers_guide.pod @@ -851,6 +851,11 @@ Over the lifetime of your distribution this will save a lot of people a small amount of download time and disk space, which adds up. +In order to produce the C<xz> tarball, XZ Utils are required. The C<xz> +utility is included with most modern UNIX-type operating systems and +is available for Cygwin. A Windows port is available from +L<http://tukaani.org/xz/>. + Create a tarball. Use the C<-s> option to specify a suitable suffix for the tarball and directory name: @@ -860,13 +865,13 @@ the tarball and directory name: # git clean should not output anything! $ git status # and there's nothing lying around - $ perl Porting/makerel -b -s RC1 # for a release candidate - $ perl Porting/makerel -b # for a final release + $ perl Porting/makerel -bx -s RC1 # for a release candidate + $ perl Porting/makerel -bx # for a final release This creates the directory F<../perl-x.y.z-RC1> or similar, copies all the MANIFEST files into it, sets the correct permissions on them, then tars it up as F<../perl-x.y.z-RC1.tar.gz>. With C<-b>, it also creates a -C<tar.bz2> file. +C<tar.bz2> file. The C<-x> also produces a C<tar.xz> file. If you're getting your tarball suffixed with -uncommitted and you're sure your changes were all committed, you can override the suffix with: @@ -886,7 +891,7 @@ Once you have a tarball it's time to test the tarball (not the repository). =head4 Copy the tarball to a web server -Copy the tarballs (.gz and possibly .bz2) to a web server somewhere you +Copy the tarballs (.gz and possibly .bz2 and .xz) to a web server somewhere you have access to. =head4 Download the tarball to another machine -- Perl5 Master Repository
