.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_COMPRESS 1"
.TH DH_COMPRESS 1 "2020-03-27" "12.10ubuntu1" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
dh_compress \- compress files and fix symlinks in package build directories
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdh_compress\fR [\fIdebhelper options\fR] [\fB\-X\fR\fIitem\fR] [\fB\-A\fR] [\fIfile\fR ...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdh_compress\fR 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.
.PP
By default, \fBdh_compress\fR compresses files that Debian policy mandates should
be compressed, namely all files in \fIusr/share/info\fR, \fIusr/share/man\fR,
files in \fIusr/share/doc\fR that are larger than 4k in size,
(except the \fIcopyright\fR file, \fI.html\fR and other web files, image files, and files
that appear to be already compressed based on their extensions), and all
\&\fIchangelog\fR files. Plus \s-1PCF\s0 fonts underneath \fIusr/share/fonts/X11/\fR
.SH "FILES"
.IX Header "FILES"
.IP "debian/\fIpackage\fR.compress" 4
.IX Item "debian/package.compress"
These files are deprecated.
.Sp
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 \fB\-X\fR is a much better idea in
general; you should only use a \fIdebian/package.compress\fR file if you really
need to.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-X\fR\fIitem\fR, \fB\-\-exclude=\fR\fIitem\fR" 4
.IX Item "-Xitem, --exclude=item"
Exclude files that contain \fIitem\fR anywhere in their filename from being
compressed. For example, \fB\-X.tiff\fR will exclude \s-1TIFF\s0 files from compression.
You may use this option multiple times to build up a list of things to
exclude.
.IP "\fB\-A\fR, \fB\-\-all\fR" 4
.IX Item "-A, --all"
Compress all files specified by command line parameters in \s-1ALL\s0 packages
acted on.
.IP "\fIfile\fR ..." 4
.IX Item "file ..."
Add these files to the list of files to compress.
.SH "CONFORMS TO"
.IX Header "CONFORMS TO"
Debian policy, version 3.0
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7)
.PP
This program is a part of debhelper.
.SH "AUTHOR"
.IX Header "AUTHOR"
Joey Hess <joeyh@debian.org>
