]> git.donarmstrong.com Git - debhelper.git/blob - dh_debstd.1
r275: No idea.
[debhelper.git] / dh_debstd.1
1 .TH DH_DEBSTD 1
2 .SH NAME
3 dh_debstd \- mimic debstd with debhelper commands
4 .SH SYNOPSIS
5 .B dh_debstd
6 .I "[-v] [--no-act] [-m] [-c] [-u] [-s] [[changelog] file ...]"
7 .SH "DESCRIPTION"
8 dh_debstd is a program that mimics the behavior of debstd, by
9 calling other debhelper commands. Its behavior is not a complete nor an
10 exact copy of what debstd does, but it should be close enough to be usable.
11 .P
12 dh_debstd is not intended to really be used in building an official debian
13 package. Instead, it is intended to help you convert your package that uses
14 debstd over to debhelper. If you run dh_debstd with the same parameters you
15 passed to debstd, and use the --verbose and --no-act flags, you can see what
16 debhelper commands dh_debstd runs, and copy those commands into debian/rules
17 to get a start on converting to debhelper.
18 .P
19 See
20 .BR debstd (1)
21 for a complete description of what this program does.
22 .SH "DEBHELPER STYLE OPTIONS"
23 .TP
24 .B \-v, \--verbose
25 Verbose mode; show all commands that modify the package build directory.
26 .TP
27 .B \--no-act
28 Do not really do anything. If used with -v, the result is that this command
29 will output a list of what it would have done.
30 .SH "DEBSTD STYLE OPTIONS"
31 .TP
32 .B \-m
33 Switch off automatic man page installation.
34 .TP
35 .B \-c
36 Switch off automatic file compression.
37 .TP
38 .B \-u
39 Enable generation of symlinks to undocumented(7) man page.
40 .TP
41 .B \-s
42 Switch off md5sum file generation.
43 .TP
44 .B changelog
45 Install this file as the upstream changelog. Only happens if it's name
46 contains "change", "news", or "history" (not case sensative).
47 .TP
48 .B file ...
49 Install these files as documentation.
50 .SH NOTES
51 Unlike debstd, dh_debstd does not automatically modify maintainer scripts
52 such as the postinst, posrm, etc. To get those scripts to be modified, you
53 have to place "#DEBHELPER#" in them at the location you want debhelper to
54 insert commands. To help you remember to do that, a warning message will be
55 generated if dh_debstd notices scripts without "#DEBHELPER#" in them.
56 .SH ENVIRONMENT
57 .TP
58 .I DH_VERBOSE
59 Enables verbose mode
60 .TP
61 .I DH_NO_ACT
62 Enables no-act mode
63 .SH "SEE ALSO"
64 .TP
65 .BR /usr/share/doc/debhelper/from-debstd
66 .TP
67 .BR debstd (1)
68 .TP
69 .BR debhelper (1)
70 .SH BUGS
71 It doesn't completly mimic debstd. Some things debstd handles are not supported
72 by debhelper. Everything that is not supported will generate a warning
73 message if you try to use it.
74 .SH AUTHOR
75 Joey Hess <joeyh@master.debian.org>