.TH DH_COMPRESS 1 "" "Debhelper Commands" "Debhelper Commands" .SH NAME dh_compress \- compress files and fix symlinks in package build directories .SH SYNOPSIS .B dh_compress .I "[debhelper options] [-Xitem] [-A] [file ...]" .SH "DESCRIPTION" dh_compress 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. .P By default, dh_compress compresses files that debian policy mandates should be compressed, namely all files in usr/info, usr/man, usr/X11R6/man, and all files in usr/doc that are larger than 4k in size, except the copyright file, .html files and .gif files, and all changelog files. It skips any files that appear to be already compressed (based on their extentions). .P If a debian/package.compress file exists (debian/compress may be used for the first binary package in debian/control), however, it will be ran as a shell script, and all filenames that the shell script outputs will be compressed instead of the default files. Note that the shell script will be run from inside the package build directory. .SH EXAMPLE Here is a sample debian/compress file that causes dh_compress to compress the same files as it would by default. This is a good starting point for customization of what files are compressed: .PP find usr/info usr/share/info usr/man usr/share/man usr/X11*/man -type f find usr/doc usr/share/doc -type f \\ \\( -size +4k -or -name "changelog*" \\) \\ \\( -name changelog.html -or ! -name "*.htm*" \\) \\ ! -name "*.gif" ! -iname "*.gz" \\ ! -iname "*.taz" ! -iname "*.tgz" ! -iname "*.z" \\ ! -name "copyright" .SH OPTIONS .TP .B debhelper options See .BR debhelper (1) for a list of options common to all debhelper commands. .TP .B \-Xitem, \--exclude=item Exclude files that contain "item" anywhere in their filename from being compressed. For example, -X.jpeg will exclude jpeg's from compression. You may use this option multiple times to build up a list of things to exclude. You can accomplish the same thing by using a debian/compress file, but this is easier. .TP .B \-A, \--all Compress all files specified by command line parameters in ALL packages acted on. .TP .B file ... Add these files to the list of files to compress. .SH NOTES The debian/compress file applies to the first binary package listed in your control file. For the other packages, you can make files named debian/package.compress, where "package" is the name of the package they apply to. (This works for the first binary package too.) .SH ENVIRONMENT See .BR debhelper (1) for a list of environment variables that affect all debhelper commands. .SH "SEE ALSO" .BR debhelper (1) .SH BUGS Filenames with spaces in them may not properly be compressed. .SH "CONFORMS TO" Debian policy, version 3.0.0.0 .SH AUTHOR Joey Hess