summaryrefslogtreecommitdiff
path: root/dh_debstd.1
blob: 8e2d545303a4f93aaf03b7e829e8678fcad95a5e (plain)
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
66
67
68
69
70
71
72
73
74
75
.TH DH_DEBSTD 1
.SH NAME
dh_debstd \- mimic debstd with debhelper commands
.SH SYNOPSIS
.B dh_debstd
.I "[-v] [--no-act] [-m] [-c] [-u] [-s] [[changelog] file ...]"
.SH "DESCRIPTION"
dh_debstd is a program that mimics the behavior of debstd, by
calling other debhelper commands. Its behavior is not a complete nor an
exact copy of what debstd does, but it should be close enough to be usable.
.P
dh_debstd is not intended to really be used in building an official debian
package. Instead, it is intended to help you convert your package that uses
debstd over to debhelper. If you run dh_debstd with the same parameters you
passed to debstd, and use the --verbose and --no-act flags, you can see what
debhelper commands dh_debstd runs, and copy those commands into debian/rules
to get a start on converting to debhelper.
.P
See
.BR debstd (1)
for a complete description of what this program does.
.SH "DEBHELPER STYLE OPTIONS"
.TP
.B \-v, \--verbose
Verbose mode; show all commands that modify the package build directory.
.TP
.B \--no-act
Do not really do anything. If used with -v, the result is that this command
will output a list of what it would have done.
.SH "DEBSTD STYLE OPTIONS"
.TP
.B \-m
Switch off automatic man page installation.
.TP
.B \-c
Switch off automatic file compression.
.TP
.B \-u
Enable generation of symlinks to undocumented(7) man page.
.TP
.B \-s
Switch off md5sum file generation.
.TP
.B changelog
Install this file as the upstream changelog. Only happens if it's name
contains "change", "news", or "history" (not case sensative).
.TP
.B file ...
Install these files as documentation.
.SH NOTES
Unlike debstd, dh_debstd does not automatically modify maintainer scripts
such as the postinst, posrm, etc. To get those scripts to be modified, you
have to place "#DEBHELPER#" in them at the location you want debhelper to
insert commands. To help you remember to do that, a warning message will be
generated if dh_debstd notices scripts without "#DEBHELPER#" in them.
.SH ENVIRONMENT
.TP
.I DH_VERBOSE
Enables verbose mode
.TP
.I DH_NO_ACT
Enables no-act mode
.SH "SEE ALSO"
.TP
.BR /usr/share/doc/debhelper/from-debstd
.TP
.BR debstd (1)
.TP
.BR debhelper (1)
.SH BUGS
It doesn't completly mimic debstd. Some things debstd handles are not supported
by debhelper. Everything that is not supported will generate a warning
message if you try to use it.
.SH AUTHOR
Joey Hess <joeyh@master.debian.org>