version 1, including all changes.
.
| Rev |
Author |
# |
Line |
| 1 |
perry |
1 |
DH_COMPRESS |
| |
|
2 |
!!!DH_COMPRESS |
| |
|
3 |
NAME |
| |
|
4 |
SYNOPSIS |
| |
|
5 |
DESCRIPTION |
| |
|
6 |
OPTIONS |
| |
|
7 |
CONFORMS TO |
| |
|
8 |
SEE ALSO |
| |
|
9 |
AUTHOR |
| |
|
10 |
---- |
| |
|
11 |
!!NAME |
| |
|
12 |
|
| |
|
13 |
|
| |
|
14 |
dh_compress - compress files and fix symlinks in package build directories |
| |
|
15 |
!!SYNOPSIS |
| |
|
16 |
|
| |
|
17 |
|
| |
|
18 |
__dh_compress__ [[''debhelper options''] |
| |
|
19 |
[[__-X__''item''] [[__-A__] [[''file |
| |
|
20 |
...''] |
| |
|
21 |
!!DESCRIPTION |
| |
|
22 |
|
| |
|
23 |
|
| |
|
24 |
dh_compress is a debhelper program that is responsible for |
| |
|
25 |
compressing the files in package build directories, and |
| |
|
26 |
makes sure that any symlinks that pointed to the files |
| |
|
27 |
before they were compressed are updated to point to the new |
| |
|
28 |
files. |
| |
|
29 |
|
| |
|
30 |
|
| |
|
31 |
By default, dh_compress compresses files that debian policy |
| |
|
32 |
mandates should be compressed, namely all files in |
| |
|
33 |
usr/share/info, usr/share/man, usr/X11R6/man, files in |
| |
|
34 |
usr/share/doc that are larger than 4k in size, (except the |
| |
|
35 |
copyright file, .html files, and files that appear to be |
| |
|
36 |
already compressed based on their extensions), and all |
| |
|
37 |
changelog files. |
| |
|
38 |
|
| |
|
39 |
|
| |
|
40 |
If a debian/package.compress file exists, however, it will |
| |
|
41 |
be ran as a shell script, and all filenames that the shell |
| |
|
42 |
script outputs will be compressed instead of the default |
| |
|
43 |
files. The shell script will be run from inside the package |
| |
|
44 |
build directory. Note though that using -X is a much better |
| |
|
45 |
idea in general; you should only use a |
| |
|
46 |
debian/package.compress file if you really have |
| |
|
47 |
to. |
| |
|
48 |
!!OPTIONS |
| |
|
49 |
|
| |
|
50 |
|
| |
|
51 |
__-X__''item'', |
| |
|
52 |
__--exclude=__''item'' |
| |
|
53 |
|
| |
|
54 |
|
| |
|
55 |
Exclude files that contain ``item'' anywhere in their |
| |
|
56 |
filename from being compressed. For example, -X.jpeg will |
| |
|
57 |
exclude jpeg's from compression. You may use this option |
| |
|
58 |
multiple times to build up a list of things to exclude. You |
| |
|
59 |
can accomplish the same thing by using a debian/compress |
| |
|
60 |
file, but this is easier. |
| |
|
61 |
|
| |
|
62 |
|
| |
|
63 |
__-A__, __--all__ |
| |
|
64 |
|
| |
|
65 |
|
| |
|
66 |
Compress all files specified by command line parameters in |
| |
|
67 |
ALL packages acted on. |
| |
|
68 |
|
| |
|
69 |
|
| |
|
70 |
''file ...'' |
| |
|
71 |
|
| |
|
72 |
|
| |
|
73 |
Add these files to the list of files to |
| |
|
74 |
compress. |
| |
|
75 |
!!CONFORMS TO |
| |
|
76 |
|
| |
|
77 |
|
| |
|
78 |
Debian policy, version 3.0 |
| |
|
79 |
!!SEE ALSO |
| |
|
80 |
|
| |
|
81 |
|
| |
|
82 |
debhelper(1) |
| |
|
83 |
|
| |
|
84 |
|
| |
|
85 |
This program is a part of debhelper. |
| |
|
86 |
!!AUTHOR |
| |
|
87 |
|
| |
|
88 |
|
| |
|
89 |
Joey Hess |
| |
|
90 |
---- |
