]> git.donarmstrong.com Git - debhelper.git/blob - dh_debstd.1
r248: Removed symlink files.
[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 debhelper command 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 (see above).
63 .SH "SEE ALSO"
64 .BR /usr/doc/debhelper/from-debstd
65 ,
66 .BR debstd (1)
67 .SH BUGS
68 It doesn't completly mimic debstd. Some things debstd handles are not supported
69 by debhelper. With the exception of buildinfo.Debian files, everything that
70 is not supported will generate a warning message.
71 .SH AUTHOR
72 Joey Hess <joeyh@master.debian.org>