summaryrefslogtreecommitdiff
path: root/Porting/release_managers_guide.pod
diff options
context:
space:
mode:
authorLeon Brocard <acme@astray.com>2011-07-12 09:08:57 +0100
committerLeon Brocard <acme@astray.com>2011-07-12 09:08:57 +0100
commit0dcf3caac0d8a710d26d7cb042a4f5bd46af288d (patch)
treed35889e0d5ef10cc61201fc802761cf31fe7a15f /Porting/release_managers_guide.pod
parent4000c4db548709df1a7c23190f040b9f654e0aad (diff)
downloadperl-0dcf3caac0d8a710d26d7cb042a4f5bd46af288d.tar.gz
Make Porting/makerel create smaller archives with 7z and advdef
It automatically will use these to create archives ~5% smaller, otherwise falls back to gzip and bzip2. Also, document in Porting/release_managers_guide.pod.
Diffstat (limited to 'Porting/release_managers_guide.pod')
-rw-r--r--Porting/release_managers_guide.pod24
1 files changed, 10 insertions, 14 deletions
diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod
index eb84850a98..6c5f6a3ba4 100644
--- a/Porting/release_managers_guide.pod
+++ b/Porting/release_managers_guide.pod
@@ -586,6 +586,16 @@ and you'll need to use a new version number for your release.
=head3 build the tarball
+Before you run the following, you might want to install 7-Zip (the
+C<p7-full> package under Debian or the C<p7zip> port on MacPorts) or
+the AdvanceCOMP suite (e.g. the C<advancecomp> package under Debian,
+or the C<advancecomp> port on macports - 7-Zip on Windows is the
+same code as AdvanceCOMP, so Windows users get the smallest files
+first time). These compress about 5% smaller than gzip and bzip2.
+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.
+
Create a tarball. Use the C<-s> option to specify a suitable suffix for
the tarball and directory name:
@@ -610,20 +620,6 @@ your changes were all committed, you can override the suffix with:
XXX if we go for extra tags and branches stuff, then add the extra details
here
-Optionally, you might want to compress your tarball more. Unix F<gzip>
-doesn't actually produce the smallest possible DEFLATE output. If you have the
-AdvanceCOMP suite (e.g. the C<advancecomp> port on macports), you can run
-
- $ advdef -z -4 ../perl-x.y.z-RC1.tar.gz
-
-which will probably shrink your tarball by about 5%. 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.
-
-(7-Zip on Windows is the same code as AdvanceCOMP, so Windows users get the
-smallest files first time)
-
-
Finally, clean up the temporary directory, e.g.
$ rm -rf ../perl-x.y.z-RC1