summaryrefslogtreecommitdiff
path: root/dh_compress.1
diff options
context:
space:
mode:
Diffstat (limited to 'dh_compress.1')
-rw-r--r--dh_compress.173
1 files changed, 0 insertions, 73 deletions
diff --git a/dh_compress.1 b/dh_compress.1
deleted file mode 100644
index bab5c199..00000000
--- a/dh_compress.1
+++ /dev/null
@@ -1,73 +0,0 @@
-.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 <joeyh@master.debian.org>