3 dh_compress \- compress files and fix symlinks in package build directories
6 .I "[-v] [-a] [-i] [-Xitem] [--no-act] [-ppackage] [-Ptmpdir]"
8 dh_compress is a debhelper program that is responsible for compressing
9 the files in package build directories, and makes sure that any symlinks
10 that pointed to the files before they were compressed are updated to point
13 By default, dh_compress compresses files that debian policy mandates should
14 be compressed, namely all files in usr/info, usr/man, usr/X11R6/man, and
15 all files in usr/doc that are larger than 4k in size, except
16 the copyright file, .html files and .gif files, and all changelog files.
18 If a debian/compress file exits, however, it will be ran as a shell script,
19 and all filenames that the shell script outputs will be compressed instead
20 of the default files. Note that the shell script will be run from inside the
21 package build directory.
23 Here is a sample debian/compress file that causes dh_compress to compress
24 the same files as it would by default. This is a good starting point for
25 customization of what files are compressed:
27 find usr/info usr/man usr/X11*/man -type f
28 find usr/doc -type f \\
29 \\( -size +4k -or -name "changelog*" \\) \\
30 ! -name "*.htm*" ! -name "*.gif" \\
35 Verbose mode; show all commands that modify the package build directory.
38 Compress files for all architecture dependent packages.
41 Compress files for all architecture independent packages.
44 Do not really do anything. If used with -v, the result is that this command
45 will output a list of what it would have done.
47 .B \-ppackage, \--package=package
48 Compress files for the package named "package".
50 .B \-Ptmpdir, \--tmpdir=tmpdir
51 Use "tmpdir" for package build directory.
53 .B \-Xitem, \--exclude=item
54 Exclude files that contain "item" anywhere in their filename from being
55 compressed. For example, -X=.jpeg will exclude jpeg's from compression.
56 You may use this option multiple times to build up a list of things to
57 exclude. You can accomplish the same thing by using a debian/compress file,
65 arguments are cumulative. If none are specified, then all packages listed in
66 the control file will have their files compressed.
68 The debian/compress file applies to the first binary package listed in your
69 control file. For the other packages, you can make files named
70 debian/package.compress, where "package" is the name of the package they
71 apply to. (This works for the first binary package too.)
78 Enables no-act mode (see above).
80 .BR /usr/doc/debhelper/README
82 Filenames with spaces in them may not properly be compressed.
84 Debian policy, version 2.3.0.0
86 Joey Hess <joeyh@master.debian.org>