X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_compress;h=ff98cb9de6d9c99785b8f41229708f7485fdb259;hb=e2a6d4cec4a7ee952cf6a7f250d80f1d75a38f95;hp=7a930bc329754774067b661a031383f21e4ccf11;hpb=053f6f8b4e7431d32511aef209188a084e8c7e79;p=debhelper.git diff --git a/dh_compress b/dh_compress index 7a930bc..ff98cb9 100755 --- a/dh_compress +++ b/dh_compress @@ -1,11 +1,78 @@ #!/usr/bin/perl -w -# -# Compresses files and makes sure that symlinks pointing to the -# compressed files get fixed. + +=head1 NAME + +dh_compress - compress files and fix symlinks in package build directories + +=cut use strict; use Cwd; use Debian::Debhelper::Dh_Lib; + +=head1 SYNOPSIS + +B [S>] [B<-X>I] [B<-A>] [S ...>] + +=head1 DESCRIPTION + +B is a debhelper program that is responsible for compressing +the files in package build directories, and makes sure that any symlinks +that pointed to the files before they were compressed are updated to point +to the new files. + +By default, B compresses files that Debian policy mandates should +be compressed, namely all files in F, F, +files in F that are larger than 4k in size, +(except the F file, F<.html> and other web files, image files, and files +that appear to be already compressed based on their extensions), and all +F files. Plus PCF fonts underneath F + +=head1 FILES + +=over 4 + +=item debian/I.compress + +These files are deprecated. + +If this file exists, the default files are not compressed. Instead, the +file is ran as a shell script, and all filenames that the shell script +outputs will be compressed. The shell script will be run from inside the +package build directory. Note though that using B<-X> is a much better idea in +general; you should only use a F file if you really +need to. + +=back + +=head1 OPTIONS + +=over 4 + +=item B<-X>I, B<--exclude=>I + +Exclude files that contain F anywhere in their filename from being +compressed. For example, B<-X.tiff> will exclude TIFF files from compression. +You may use this option multiple times to build up a list of things to +exclude. + +=item B<-A>, B<--all> + +Compress all files specified by command line parameters in ALL packages +acted on. + +=item I ... + +Add these files to the list of files to compress. + +=back + +=head1 CONFORMS TO + +Debian policy, version 3.0 + +=cut + init(); foreach my $package (@{$dh{DOPACKAGES}}) { @@ -25,25 +92,35 @@ foreach my $package (@{$dh{DOPACKAGES}}) { push @files, @ARGV; } if ($compress) { - # The config file is a sh script that outputs the files to be compressed + # The compress file is a sh script that outputs the files to be compressed # (typically using find). + warning("$compress is deprecated; use -X or avoid calling dh_compress instead"); push @files, split(/\n/,`sh $olddir/$compress 2>/dev/null`); } else { - # By default, fall back to what the policy manual says to - # compress. Note that all the excludes of odd things like _z + # Note that all the excludes of odd things like _z # are because gzip refuses to compress such files, assumming # they are zip files. I looked at the gzip source to get the # complete list of such extensions: ".gz", ".z", ".taz", # ".tgz", "-gz", "-z", "_z" push @files, split(/\n/,` - find usr/info usr/share/info usr/man usr/share/man usr/X11*/man -type f ! -name "*.gz" 2>/dev/null || true; - find usr/doc usr/share/doc -type f \\( -size +4k -or -name "changelog*" \\) \\ + find usr/info usr/share/info usr/man usr/share/man usr/X11*/man -type f ! -iname "*.gz" \\ + ! -iname "*.gif" ! -iname "*.png" ! -iname "*.jpg" \\ + ! -iname "*.jpeg" \\ + 2>/dev/null || true; + find usr/share/doc \\ + \\( -type d -name _sources -prune -false \\) -o \\ + -type f \\( -size +4k -or -name "changelog*" -or -name "NEWS*" \\) \\ \\( -name changelog.html -or ! -iname "*.htm*" \\) \\ - ! -iname "*.gif" ! -iname "*.png" ! -iname "*.jpg" ! -iname "*.jpeg" ! -iname "*.gz" \\ - ! -iname "*.taz" ! -iname "*.tgz" ! -iname "*.z" \\ - ! -iname "*-gz" ! -iname "*-z" ! -iname "*_z" \\ - ! -name "copyright" 2>/dev/null || true + ! -iname "*.gif" ! -iname "*.png" ! -iname "*.jpg" \\ + ! -iname "*.jpeg" ! -iname "*.gz" ! -iname "*.taz" \\ + ! -iname "*.tgz" ! -iname "*.z" ! -iname "*.bz2" \\ + ! -iname "*-gz" ! -iname "*-z" ! -iname "*_z" \\ + ! -iname "*.jar" ! -iname "*.zip" ! -iname "*.css" \\ + ! -iname "*.svg" ! -iname "*.svgz" ! -iname "*.js" \\ + ! -name "index.sgml" ! -name "objects.inv" \\ + ! -name "copyright" 2>/dev/null || true; + find usr/share/fonts/X11 -type f -name "*.pcf" 2>/dev/null || true; `); } @@ -90,7 +167,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) { # Make executables not be anymore. xargs(\@f,"chmod","a-x"); - xargs(\@f,"gzip","-9f"); + xargs(\@f,"gzip","-9nf"); } # Now change over any files we can that used to be hard links so @@ -102,18 +179,38 @@ foreach my $package (@{$dh{DOPACKAGES}}) { doit("ln","$hardlinks{$_}.gz","$_.gz"); } - verbose_print("cd $olddir"); + verbose_print("cd '$olddir'"); chdir($olddir); # Fix up symlinks that were pointing to the uncompressed files. - open (FIND,"find $tmp -type l |"); - while () { - chomp; - my ($directory)=m:(.*)/:; - my $linkval=readlink($_); - if (! -e "$directory/$linkval" && -e "$directory/$linkval.gz") { - doit("rm","-f",$_); - doit("ln","-sf","$linkval.gz","$_.gz"); + my %links = map { chomp; $_ => 1 } `find $tmp -type l`; + my $changed; + # Keep looping through looking for broken links until no more + # changes are made. This is done in case there are links pointing + # to links, pointing to compressed files. + do { + $changed = 0; + foreach my $link (keys %links) { + my ($directory) = $link =~ m:(.*)/:; + my $linkval = readlink($link); + if (! -e "$directory/$linkval" && -e "$directory/$linkval.gz") { + doit("rm","-f",$link); + doit("ln","-sf","$linkval.gz","$link.gz"); + delete $links{$link}; + $changed++; + } } - } + } while $changed; } + +=head1 SEE ALSO + +L + +This program is a part of debhelper. + +=head1 AUTHOR + +Joey Hess + +=cut