1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
.TH dh_make 1L "Debian Utilities" "DEBIAN" \" -*- nroff -*-
.SH NAME
dh_make \- Debianize a sourcecode package
.SH SYNOPSIS
\fBdh_make\fP [\fBnative\fP]
.SH DESCRIPTION
dh_make is a tool to convert a regular sourcecodepackage into one formatted
according to the requirements of the
debian project. dh_make should be invoked withinn the sourcecode directory
which should be named <packagename>-<version>. The packagename must be all
lowercase, digits and dashes. If the directory name does not conform to the scheme then please
rename the directory before using dh_make.
.br
.SH PACKAGE CLASSES
.TP
.B Single
The package will generate a single binary .deb package. This is the standard
case if you dont know what to do choose this.
.TP
.B Multi
The package will generate multiple binary .deb packages from one source
package. Choose this for larger packages.
.TP
.B Library
The package will generate at least two binaries. One library package
containing just the lib in /usr/lib and another *-dev_*.deb package
containing documentation and C headers.
.SH ACTIONS PERFORMED
.B dh_make
copies the archive on the higher directory level into
<packagename>-<version>.orig if that directory does not exist.
The orig archive is needed for other debian
tools to generate the diffs to the original sources required by the debian
packaging format.
.PP
Then dh_make proceeds to generate a "debian" subdirectory and the necessary
control files in the subdirectory. Those control files are customized with the
packagename and version extracted from the directory name and the
username and the e-mail address build from /etc/mailname and from /etc/passwd
(Sorry no YP support right now).
If the environment variable
.B EMAIL
is set then that EMAIL address is used for the e-mail address of the
maintainer instead of looking it up in the environment. eg (for bash)
.PP
export EMAIL="jsmith@debian.org"
.PP
dh_make will also generate example files that are also customized for the
package generated. You can remove all files with *.ex if you wish. Renaming
those to their name without the .ex at the end will activate that feature
of debhelper.
.SS OPTIONS
.TP
.I native
Do not generate a .orig archive. The package is a native Debian package that
does not need any diffs. The version number will not have a debian release
number in it.
.SH SEE ALSO
.BR /usr/doc/debhelper/README
and
.B dpkg(1)
.SS AUTHOR
Craig Small <csmall@debian.org>
Christoph Lameter <clameter@debian.org>
|
