# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
-#
+#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2006-01-22 0:12+0100\n"
+"POT-Creation-Date: 2009-07-01 15:31-0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: ENCODING"
-# type: =head1
-#: dh_installpam:3 dh_installemacsen:3 dh_installinfo:3 dh_strip:3 dh_installppp:3 dh_compress:3 dh_md5sums:3 dh_installexamples:3 dh_installcron:3 dh_installinit:3 dh_usrlocal:3 dh_gconf:3 dh_installmodules:3 dh_installmenu:3 dh_installlogrotate:3 debhelper.pod:1 dh_clean:3 dh_undocumented:3 dh_testversion:3 dh_testdir:3 dh_shlibdeps:3 dh_scrollkeeper:3 dh_installdirs:3 dh_link:3 dh_installdebconf:3 dh_installmime:3 dh_installwm:3 dh_installdeb:3 dh_builddeb:3 dh_gencontrol:3 dh_install:3 dh_makeshlibs:3 dh_perl:3 dh_fixperms:3 dh_listpackages:3 dh_installman:3 dh_testroot:3 dh_movefiles:3 dh_desktop:3 dh_suidregister:3 dh_installchangelogs:3 dh_python:3 dh_installdocs:3 dh_installcatalogs:3 dh_installmanpages:3 dh_installxfonts:3 dh_installlogcheck:3
+#. type: =head1
+#: debhelper.pod:1 dh_builddeb:3 dh_clean:3 dh_compress:3 dh_desktop:3 dh_fixperms:3 dh_gconf:3 dh_gencontrol:3 dh_installcatalogs:3 dh_installchangelogs:3 dh_installcron:3 dh_installdebconf:3 dh_installdeb:3 dh_installdirs:3 dh_installdocs:3 dh_installemacsen:3 dh_installexamples:3 dh_installinfo:3 dh_installinit:3 dh_installlogcheck:3 dh_installlogrotate:3 dh_installmanpages:3 dh_installman:3 dh_installmenu:3 dh_installmime:3 dh_installmodules:3 dh_installpam:3 dh_install:3 dh_installppp:3 dh_installwm:3 dh_installxfonts:3 dh_link:3 dh_listpackages:3 dh_makeshlibs:3 dh_md5sums:3 dh_movefiles:3 dh_perl:3 dh_python:3 dh_scrollkeeper:3 dh_shlibdeps:3 dh_strip:3 dh_suidregister:3 dh_testdir:3 dh_testroot:3 dh_testversion:3 dh_undocumented:3 dh_usrlocal:3
msgid "NAME"
msgstr ""
-# type: textblock
-#: dh_installpam:5
-msgid "dh_installpam - install pam support files"
+#. type: textblock
+#: debhelper.pod:3
+msgid "debhelper - the debhelper tool suite"
msgstr ""
-# type: =head1
-#: dh_installpam:12 dh_installemacsen:12 dh_installinfo:12 dh_strip:13 dh_installppp:12 dh_compress:13 dh_md5sums:13 dh_installexamples:12 dh_installcron:12 dh_installinit:12 dh_usrlocal:15 dh_gconf:12 dh_installmodules:14 dh_installmenu:12 dh_installlogrotate:12 debhelper.pod:5 dh_clean:12 dh_undocumented:12 dh_testversion:12 dh_testdir:12 dh_shlibdeps:13 dh_scrollkeeper:12 dh_installdirs:12 dh_link:13 dh_installdebconf:12 dh_installmime:12 dh_installwm:12 dh_installdeb:12 dh_builddeb:12 dh_gencontrol:12 dh_install:13 dh_makeshlibs:12 dh_perl:14 dh_fixperms:12 dh_listpackages:12 dh_installman:13 dh_testroot:7 dh_movefiles:12 dh_desktop:12 dh_suidregister:7 dh_installchangelogs:12 dh_python:13 dh_installdocs:12 dh_installcatalogs:14 dh_installmanpages:13 dh_installxfonts:12 dh_installlogcheck:12
+#. type: =head1
+#: debhelper.pod:5 dh_builddeb:12 dh_clean:12 dh_compress:13 dh_desktop:12 dh_fixperms:12 dh_gconf:12 dh_gencontrol:12 dh_installcatalogs:14 dh_installchangelogs:12 dh_installcron:12 dh_installdebconf:12 dh_installdeb:12 dh_installdirs:12 dh_installdocs:12 dh_installemacsen:12 dh_installexamples:12 dh_installinfo:12 dh_installinit:12 dh_installlogcheck:12 dh_installlogrotate:12 dh_installmanpages:13 dh_installman:13 dh_installmenu:12 dh_installmime:12 dh_installmodules:14 dh_installpam:12 dh_install:13 dh_installppp:12 dh_installwm:12 dh_installxfonts:12 dh_link:13 dh_listpackages:12 dh_makeshlibs:12 dh_md5sums:13 dh_movefiles:12 dh_perl:14 dh_python:13 dh_scrollkeeper:12 dh_shlibdeps:13 dh_strip:13 dh_suidregister:7 dh_testdir:12 dh_testroot:7 dh_testversion:12 dh_undocumented:12 dh_usrlocal:15
msgid "SYNOPSIS"
msgstr ""
-# type: textblock
-#: dh_installpam:14
-msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
+#. type: textblock
+#: debhelper.pod:7
+msgid ""
+"B<dh_>I<*> [B<-v>] [B<-a>] [B<-i>] [B<-s>] [B<--no-act>] [B<-ppackage>] "
+"[B<-Npackage] [-Ptmpdir>]"
msgstr ""
-# type: =head1
-#: dh_installpam:16 dh_installemacsen:16 dh_installinfo:16 dh_strip:17 dh_installppp:16 dh_compress:17 dh_md5sums:17 dh_installexamples:16 dh_installcron:16 dh_installinit:16 dh_usrlocal:19 dh_gconf:16 dh_installmodules:18 dh_installmenu:16 dh_installlogrotate:16 debhelper.pod:9 dh_clean:16 dh_undocumented:16 dh_testversion:16 dh_testdir:16 dh_shlibdeps:17 dh_scrollkeeper:16 dh_installdirs:16 dh_link:17 dh_installdebconf:16 dh_installmime:16 dh_installwm:16 dh_installdeb:16 dh_builddeb:16 dh_gencontrol:16 dh_install:17 dh_makeshlibs:16 dh_perl:18 dh_fixperms:16 dh_listpackages:16 dh_installman:17 dh_testroot:11 dh_movefiles:16 dh_desktop:16 dh_suidregister:11 dh_installchangelogs:16 dh_python:17 dh_installdocs:16 dh_installcatalogs:18 dh_installmanpages:17 dh_installxfonts:16 dh_installlogcheck:16
+#. type: =head1
+#: debhelper.pod:9 dh_builddeb:16 dh_clean:16 dh_compress:17 dh_desktop:16 dh_fixperms:16 dh_gconf:16 dh_gencontrol:16 dh_installcatalogs:18 dh_installchangelogs:16 dh_installcron:16 dh_installdebconf:16 dh_installdeb:16 dh_installdirs:16 dh_installdocs:16 dh_installemacsen:16 dh_installexamples:16 dh_installinfo:16 dh_installinit:16 dh_installlogcheck:16 dh_installlogrotate:16 dh_installmanpages:17 dh_installman:17 dh_installmenu:16 dh_installmime:16 dh_installmodules:18 dh_installpam:16 dh_install:17 dh_installppp:16 dh_installwm:16 dh_installxfonts:16 dh_link:17 dh_listpackages:16 dh_makeshlibs:16 dh_md5sums:17 dh_movefiles:16 dh_perl:18 dh_python:17 dh_scrollkeeper:16 dh_shlibdeps:17 dh_strip:17 dh_suidregister:11 dh_testdir:16 dh_testroot:11 dh_testversion:16 dh_undocumented:16 dh_usrlocal:19
msgid "DESCRIPTION"
msgstr ""
-# type: textblock
-#: dh_installpam:18
+#. type: textblock
+#: debhelper.pod:11
msgid ""
-"dh_installpam is a debhelper program that is responsible for installing "
-"files used by PAM into package build directories."
+"Debhelper is used to help you build a debian package. The philosophy behind "
+"debhelper is to provide a collection of small, simple, and easily understood "
+"tools that are used in debian/rules to automate various common aspects of "
+"building a package. This means less work for you, the packager. It also, to "
+"some degree means that these tools can be changed if debian policy changes, "
+"and packages that use them will require only a rebuild to comply with the "
+"new policy."
msgstr ""
-# type: textblock
-#: dh_installpam:21
+#. type: textblock
+#: debhelper.pod:19
msgid ""
-"If a file named debian/package.pam exists, then it is installed into "
-"etc/pam.d/package in the package build directory."
+"A typical debian/rules file that uses debhelper will call several debhelper "
+"commands in sequence, or use L<dh(1)> to automate this process. Examples of "
+"rules files that use debhelper are in F</usr/share/doc/debhelper/examples/>"
msgstr ""
-# type: =head1
-#: dh_installpam:24 dh_installemacsen:34 dh_installinfo:36 dh_strip:35 dh_installppp:26 dh_compress:38 dh_md5sums:28 dh_installexamples:29 dh_installcron:24 dh_installinit:33 dh_usrlocal:38 dh_gconf:34 dh_installmodules:35 dh_installmenu:33 dh_installlogrotate:22 dh_clean:25 dh_testversion:34 dh_testdir:23 dh_shlibdeps:26 dh_scrollkeeper:31 dh_installdirs:32 dh_link:48 dh_installdebconf:59 dh_installmime:30 dh_installwm:30 dh_builddeb:21 dh_gencontrol:26 dh_install:43 dh_makeshlibs:24 dh_perl:28 dh_fixperms:31 dh_installman:54 dh_movefiles:32 dh_installchangelogs:40 dh_python:35 dh_installdocs:51 dh_installcatalogs:42 dh_installmanpages:40
-msgid "OPTIONS"
+#. type: textblock
+#: debhelper.pod:23
+msgid ""
+"To create a new debian package using debhelper, you can just copy one of the "
+"sample rules files and edit it by hand. Or you can try the dh-make package, "
+"which contains a L<dh_make|dh_make(1)> command that partially automates the "
+"process. For a more gentle introduction, the maint-guide debian package "
+"contains a tutorial about making your first package using debhelper."
msgstr ""
-# type: =item
-#: dh_installpam:28 dh_installppp:30 dh_installcron:28 dh_installinit:72 dh_installmodules:43 dh_installlogrotate:26
-msgid "B<--name=>I<name>"
+#. type: =head1
+#: debhelper.pod:29
+msgid "DEBHELPER COMMANDS"
msgstr ""
-# type: textblock
-#: dh_installpam:30
+#. type: textblock
+#: debhelper.pod:31
msgid ""
-"Look for files named debian/package.name.pam and install them as "
-"etc/pam.d/name, instead of using the usual files and installing them as the "
-"package name."
-msgstr ""
-
-# type: =head1
-#: dh_installpam:52 dh_installemacsen:108 dh_installinfo:122 dh_strip:221 dh_installppp:56 dh_compress:189 dh_md5sums:86 dh_installexamples:102 dh_installcron:61 dh_installinit:197 dh_usrlocal:113 dh_gconf:90 dh_installmodules:102 dh_installmenu:79 dh_installlogrotate:50 debhelper.pod:437 dh_clean:106 dh_undocumented:28 dh_testversion:74 dh_testdir:43 dh_shlibdeps:148 dh_scrollkeeper:75 dh_installdirs:87 dh_link:212 dh_installdebconf:135 dh_installmime:84 dh_installwm:94 dh_installdeb:93 dh_builddeb:78 dh_gencontrol:73 dh_install:251 dh_makeshlibs:183 dh_perl:140 dh_fixperms:107 dh_listpackages:28 dh_installman:210 dh_testroot:26 dh_movefiles:162 dh_desktop:43 dh_suidregister:117 dh_installchangelogs:125 dh_python:266 dh_installdocs:233 dh_installcatalogs:105 dh_installmanpages:197 dh_installxfonts:83 dh_installlogcheck:51
-msgid "SEE ALSO"
+"Here is the complete list of available debhelper commands. See their man "
+"pages for additional documentation."
msgstr ""
-# type: textblock
-#: dh_installpam:54 dh_installemacsen:110 dh_installinfo:124 dh_strip:223 dh_installppp:58 dh_compress:191 dh_md5sums:88 dh_installexamples:104 dh_installcron:63 dh_installinit:199 dh_usrlocal:115 dh_gconf:92 dh_installmodules:104 dh_installlogrotate:52 dh_clean:108 dh_undocumented:30 dh_testversion:76 dh_testdir:45 dh_installdirs:89 dh_link:214 dh_installdebconf:137 dh_installmime:86 dh_installwm:96 dh_installdeb:95 dh_builddeb:80 dh_gencontrol:75 dh_install:253 dh_makeshlibs:185 dh_perl:142 dh_fixperms:109 dh_listpackages:30 dh_installman:212 dh_testroot:28 dh_movefiles:164 dh_suidregister:119 dh_installchangelogs:127 dh_python:268 dh_installdocs:235 dh_installcatalogs:107 dh_installmanpages:199 dh_installxfonts:85 dh_installlogcheck:53
-msgid "L<debhelper(7)>"
+#. type: textblock
+#: debhelper.pod:36
+msgid "#LIST#"
msgstr ""
-# type: textblock
-#: dh_installpam:56 dh_installemacsen:112 dh_installinfo:126 dh_strip:225 dh_installppp:60 dh_compress:193 dh_md5sums:90 dh_installexamples:106 dh_installcron:65 dh_installinit:201 dh_usrlocal:117 dh_gconf:94 dh_installmodules:106 dh_installmenu:85 dh_installlogrotate:54 dh_clean:110 dh_undocumented:32 dh_testversion:78 dh_testdir:47 dh_shlibdeps:152 dh_scrollkeeper:79 dh_installdirs:91 dh_link:216 dh_installdebconf:139 dh_installmime:88 dh_installwm:98 dh_installdeb:97 dh_builddeb:82 dh_gencontrol:77 dh_install:255 dh_makeshlibs:187 dh_perl:144 dh_fixperms:111 dh_listpackages:32 dh_installman:214 dh_testroot:30 dh_movefiles:166 dh_desktop:47 dh_suidregister:121 dh_installchangelogs:129 dh_python:270 dh_installdocs:237 dh_installmanpages:201 dh_installxfonts:87
-msgid "This program is a part of debhelper."
+#. type: textblock
+#: debhelper.pod:40
+msgid ""
+"If a program's name starts with \"dh_\", and the program is not on the above "
+"list, then it is not part of the debhelper package, but it should still work "
+"like the other programs described on this page."
msgstr ""
-# type: =head1
-#: dh_installpam:58 dh_installemacsen:114 dh_installinfo:128 dh_strip:227 dh_installppp:62 dh_compress:195 dh_md5sums:92 dh_installexamples:108 dh_installcron:67 dh_installinit:203 dh_usrlocal:119 dh_gconf:96 dh_installmodules:108 dh_installmenu:87 dh_installlogrotate:56 debhelper.pod:451 dh_clean:112 dh_undocumented:34 dh_testversion:80 dh_testdir:49 dh_shlibdeps:154 dh_scrollkeeper:81 dh_installdirs:93 dh_link:218 dh_installdebconf:141 dh_installmime:90 dh_installwm:100 dh_installdeb:99 dh_builddeb:84 dh_gencontrol:79 dh_install:257 dh_makeshlibs:189 dh_perl:146 dh_fixperms:113 dh_listpackages:34 dh_installman:216 dh_testroot:32 dh_movefiles:168 dh_desktop:49 dh_suidregister:123 dh_installchangelogs:131 dh_python:272 dh_installdocs:239 dh_installcatalogs:111 dh_installmanpages:203 dh_installxfonts:89 dh_installlogcheck:57
-msgid "AUTHOR"
+#. type: =head1
+#: debhelper.pod:44
+msgid "DEBHELPER CONFIG FILES"
msgstr ""
-# type: textblock
-#: dh_installpam:60 dh_installemacsen:116 dh_installinfo:130 dh_strip:229 dh_installppp:64 dh_compress:197 dh_md5sums:94 dh_installexamples:110 dh_installcron:69 dh_installinit:205 dh_installmodules:110 dh_installmenu:89 dh_installlogrotate:58 debhelper.pod:453 dh_clean:114 dh_undocumented:36 dh_testversion:82 dh_testdir:51 dh_shlibdeps:156 dh_installdirs:95 dh_link:220 dh_installdebconf:143 dh_installmime:92 dh_installwm:102 dh_installdeb:101 dh_builddeb:86 dh_gencontrol:81 dh_install:259 dh_makeshlibs:191 dh_fixperms:115 dh_listpackages:36 dh_installman:218 dh_testroot:34 dh_movefiles:170 dh_suidregister:125 dh_installchangelogs:133 dh_installdocs:241 dh_installmanpages:205 dh_installxfonts:91
-msgid "Joey Hess <joeyh@debian.org>"
+#. type: textblock
+#: debhelper.pod:46
+msgid ""
+"Many debhelper commands make use of files in F<debian/> to control what they "
+"do. Besides the common F<debian/changelog> and F<debian/control>, which are "
+"in all packages, not just those using debhelper, some additional files can "
+"be used to configure the behavior of specific debhelper commands. These "
+"files are typically named debian/package.foo (where \"package\" of course, "
+"is replaced with the package that is being acted on)."
msgstr ""
-# type: textblock
-#: dh_installemacsen:5
-msgid "dh_installemacsen - register an emacs add on package"
+#. type: textblock
+#: debhelper.pod:53
+msgid ""
+"For example, dh_installdocs uses files named debian/package.docs to list the "
+"documentation files it will install. See the man pages of individual "
+"commands for details about the names and formats of the files they use. "
+"Generally, these files will list files to act on, one file per line. Some "
+"programs in debhelper use pairs of files and destinations or slightly more "
+"complicated formats."
msgstr ""
-# type: textblock
-#: dh_installemacsen:14
+#. type: textblock
+#: debhelper.pod:60
msgid ""
-"B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
-"[B<--flavor=>I<foo>]"
+"Note that if a package is the first (or only) binary package listed in "
+"debian/control, debhelper will use debian/foo if no debian/package.foo file "
+"can be found."
msgstr ""
-# type: textblock
-#: dh_installemacsen:18
+#. type: textblock
+#: debhelper.pod:64
msgid ""
-"dh_installemacsen is a debhelper program that is responsible for installing "
-"files used by the debian emacsen-common package into package build "
-"directories."
+"In some rare cases, you may want to have different versions of these files "
+"for different architectures or OSes. If files named debian/package.foo.ARCH "
+"or debian/package.foo.OS exist, where \"ARCH\" and \"OS\" are the same as "
+"the output of \"dpkg-architecture -qDEB_HOST_ARCH\" / \"dpkg-architecture "
+"-qDEB_HOST_ARCH_OS\", then they will be used in preference to other, more "
+"general files."
msgstr ""
-# type: textblock
-#: dh_installemacsen:22
+#. type: textblock
+#: debhelper.pod:71
msgid ""
-"It also automatically generates the postinst and prerm commands needed to "
-"register a package as an emacs add on package. See L<dh_installdeb(1)> for "
-"an explanation of how this works."
+"In many cases, these config files are used to specify various types of "
+"files. Documentation or example files to install, files to move, and so on. "
+"When appropriate, in cases like these, you can use standard shell wildcard "
+"characters ('?' and '*' and '[..]' character classes) in the files."
msgstr ""
-# type: textblock
-#: dh_installemacsen:26
+#. type: textblock
+#: debhelper.pod:76
msgid ""
-"If a file named debian/package.emacsen-install exists, then it is installed "
-"into usr/lib/emacsen-common/packages/install/package in the package build "
-"directory. Similarly, debian/package.emacsen-remove is installed into "
-"usr/lib/emacsen-common/packages/remove/package . And similarly, "
-"debian/package.emacsen-startup is installed into "
-"etc/emacs/site-start.d/50<package>.el (by default)."
+"You can also put comments in these files; lines beginning with \"#\" are "
+"ignored."
msgstr ""
-# type: =item
-#: dh_installemacsen:38 dh_installinfo:45 dh_installinit:37 dh_usrlocal:42 dh_installmodules:39 dh_installmenu:37 dh_scrollkeeper:35 dh_installdebconf:63 dh_installmime:34 dh_installwm:40 dh_makeshlibs:58 dh_python:56 dh_installdocs:60 dh_installcatalogs:46
-msgid "B<-n>, B<--noscripts>"
+#. type: =head1
+#: debhelper.pod:79
+msgid "SHARED DEBHELPER OPTIONS"
msgstr ""
-# type: textblock
-#: dh_installemacsen:40 dh_installinfo:47 dh_installdocs:62
-msgid "Do not modify postinst/prerm scripts."
+#. type: textblock
+#: debhelper.pod:81
+msgid "The following command line options are supported by all debhelper programs."
msgstr ""
-# type: =item
-#: dh_installemacsen:42 dh_installwm:34
-msgid "B<--priority=>I<n>"
+#. type: =item
+#: debhelper.pod:85
+msgid "B<-v>, B<--verbose>"
msgstr ""
-# type: textblock
-#: dh_installemacsen:44
-msgid "Sets the priority number of a site-start.d file. Default is 50."
+#. type: textblock
+#: debhelper.pod:87
+msgid "Verbose mode: show all commands that modify the package build directory."
msgstr ""
-# type: =item
-#: dh_installemacsen:46
-msgid "B<--flavor=>I<foo>"
+#. type: =item
+#: debhelper.pod:89
+msgid "B<--no-act>"
msgstr ""
-# type: textblock
-#: dh_installemacsen:48
+#. type: textblock
+#: debhelper.pod:91
msgid ""
-"Sets the flavor a site-start.d file will be installed in. Default is "
-"\"emacs\", alternatives include \"xemacs\" and \"emacs20\"."
+"Do not really do anything. If used with -v, the result is that the command "
+"will output what it would have done."
msgstr ""
-# type: =head1
-#: dh_installemacsen:53 dh_installinfo:56 dh_strip:74 dh_installexamples:50 dh_installinit:99 dh_usrlocal:48 dh_installmodules:52 debhelper.pod:158 dh_scrollkeeper:41 dh_installmime:40 dh_installwm:49 dh_installman:70 dh_movefiles:58 dh_installdocs:87 dh_installcatalogs:52 dh_installxfonts:36
-msgid "NOTES"
+#. type: =item
+#: debhelper.pod:94
+msgid "B<-a>, B<--arch>"
msgstr ""
-# type: textblock
-#: dh_installemacsen:55 dh_installinfo:58 dh_installinit:101 dh_usrlocal:50 dh_installmodules:54 dh_scrollkeeper:43 dh_installmime:42 dh_installwm:51 dh_installcatalogs:54
-msgid ""
-"Note that this command is not idempotent. \"dh_clean -k\" should be called "
-"between invocations of this command. Otherwise, it may cause multiple "
-"instances of the same text to be added to maintainer scripts."
+#. type: textblock
+#: debhelper.pod:96
+msgid "Act on all architecture dependent packages."
msgstr ""
-# type: textblock
-#: dh_installinfo:5
-msgid "dh_installinfo - install and register info files"
+#. type: =item
+#: debhelper.pod:98
+msgid "B<-i>, B<--indep>"
msgstr ""
-# type: textblock
-#: dh_installinfo:14
-msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [B<-n>] [S<I<file ...>>]"
+#. type: textblock
+#: debhelper.pod:100
+msgid "Act on all architecture independent packages."
msgstr ""
-# type: textblock
-#: dh_installinfo:18
-msgid ""
-"dh_installinfo is a debhelper program that is responsible for installing "
-"info files and registering the files it installs with install-info."
+#. type: =item
+#: debhelper.pod:102
+msgid "B<->I<ppackage>, B<--package=>I<package>"
msgstr ""
-# type: textblock
-#: dh_installinfo:21
+#. type: textblock
+#: debhelper.pod:104
msgid ""
-"It determines some information about the info files by parsing them, in "
-"particular, it looks at the INFO-DIR-SECTION line to determine what section "
-"the info file belongs in."
+"Act on the package named \"package\". This option may be specified multiple "
+"times to make debhelper operate on a given set of packages."
+msgstr ""
+
+#. type: =item
+#: debhelper.pod:107
+msgid "B<-s>, B<--same-arch>"
msgstr ""
-# type: textblock
-#: dh_installinfo:25
+#. type: textblock
+#: debhelper.pod:109
msgid ""
-"Any filenames specified as parameters will be installed into the first "
-"package dh_installinfo is told to act on. By default, this is the first "
-"binary package in debian/control, but if you use -p, -i, or -a flags, it "
-"will be the first package specified by those flags."
+"This is a smarter version of the -a flag, that is used in some rare "
+"circumstances. It understands that if the control file lists \"Architecture: "
+"i386\" for the package, the package should not be acted on on other "
+"architectures. So this flag makes the command act on all \"Architecture: "
+"any\" packages, as well as on any packages that have the current "
+"architecture explicitly specified. Contrast to the -a flag, which makes the "
+"command work on all packages that are not architecture independent."
msgstr ""
-# type: textblock
-#: dh_installinfo:30
-msgid "Files named debian/package.info can list other files to be installed."
+#. type: =item
+#: debhelper.pod:117
+msgid "B<-N>I<package>, B<--no-package=>I<package>"
msgstr ""
-# type: textblock
-#: dh_installinfo:32
+#. type: textblock
+#: debhelper.pod:119
msgid ""
-"dh_installinfo will automatically generate the postinst and prerm commands "
-"needed to interface with install-info, updating the info . See "
-"L<dh_installdeb(1)> for an explanation of how this works."
+"Do not act on the specified package even if an -a, -i, or -p option lists "
+"the package as one that should be acted on."
msgstr ""
-# type: =item
-#: dh_installinfo:40 dh_compress:50 dh_installexamples:33 debhelper.pod:151 dh_installdirs:36 dh_link:52 dh_installman:58 dh_installdocs:55
-msgid "B<-A>, B<--all>"
+#. type: =item
+#: debhelper.pod:122
+msgid "B<--remaining-packages>"
msgstr ""
-# type: textblock
-#: dh_installinfo:42 dh_installman:60 dh_installdocs:57
+#. type: textblock
+#: debhelper.pod:124
msgid ""
-"Install all files specified by command line parameters in ALL packages acted "
-"on."
+"Do not act on the packages which have already been acted on by this "
+"debhelper command earlier (i.e. if the command is present in the package "
+"debhelper log). For example, if you need to call the command with special "
+"options only for a couple of binary packages, pass this option to the last "
+"call of the command to process the rest of packages with default settings."
msgstr ""
-# type: =item
-#: dh_installinfo:49 dh_compress:55 dh_installexamples:38 dh_clean:50 dh_testdir:27 dh_movefiles:49 dh_installdocs:69 dh_installmanpages:44
-msgid "I<file ...>"
+#. type: =item
+#: debhelper.pod:130
+msgid "B<--ignore=>I<file>"
msgstr ""
-# type: textblock
-#: dh_installinfo:51
+#. type: textblock
+#: debhelper.pod:132
msgid ""
-"Install these info files into the first package acted on. (Or in all "
-"packages if -A is specified)."
+"Ignore the specified file. This can be used if debian/ contains a debhelper "
+"config file that a debhelper command should not act on. Note that "
+"debian/compat, debian/control, and debian/changelog can't be ignored, but "
+"then, there should never be a reason to ignore those files."
msgstr ""
-# type: textblock
-#: dh_strip:5
-msgid "dh_strip - strip executables, shared libraries, and some static libraries"
+#. type: textblock
+#: debhelper.pod:137
+msgid ""
+"For example, if upstream ships a debian/init that you don't want "
+"dh_installinit to install, use --ignore=debian/init"
msgstr ""
-# type: textblock
-#: dh_strip:15
-msgid ""
-"B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] [--dbg-package=package] "
-"[--keep-debug]"
+#. type: =item
+#: debhelper.pod:140
+msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
msgstr ""
-# type: textblock
-#: dh_strip:19
-msgid ""
-"dh_strip is a debhelper program that is responsible for stripping "
-"executables, shared libraries, and static libraries that are not used for "
-"debugging."
+#. type: textblock
+#: debhelper.pod:142
+msgid "Use \"tmpdir\" for package build directory. The default is debian/<package>"
msgstr ""
-# type: textblock
-#: dh_strip:23
-msgid ""
-"This program examines your package build directories and works out what to "
-"strip on its own. It uses L<file(1)> and file permissions and filenames to "
-"figure out what files are shared libraries (*.so), executable binaries, and "
-"static (lib*.a) and debugging libraries (lib*_g.a, debug/*.so), and strips "
-"each as much as is possible. (Which is not at all for debugging libraries.) "
-"In general it seems to make very good guesses, and will do the right thing "
-"in almost all cases."
+#. type: =item
+#: debhelper.pod:144
+msgid "B<--mainpackage=>I<package>"
msgstr ""
-# type: textblock
-#: dh_strip:31
+#. type: textblock
+#: debhelper.pod:146
msgid ""
-"Since it is very hard to automatically guess if a file is a module, and hard "
-"to determine how to strip a module, dh_strip does not currently deal with "
-"stripping binary modules such as .o files."
+"This little-used option changes the package which debhelper considers the "
+"\"main package\", that is, the first one listed in debian/control, and the "
+"one for which debian/foo files can be used instead of the usual "
+"debian/package.foo files."
msgstr ""
-# type: =item
-#: dh_strip:39 dh_compress:42 dh_md5sums:37 debhelper.pod:146 dh_shlibdeps:36 dh_makeshlibs:62
-msgid "B<-X>I<item>, B<--exclude=>I<item>"
+#. type: =head1
+#: debhelper.pod:153
+msgid "COMMON DEBHELPER OPTIONS"
msgstr ""
-# type: textblock
-#: dh_strip:41
+#. type: textblock
+#: debhelper.pod:155
msgid ""
-"Exclude files that contain \"item\" anywhere in their filename from being "
-"stripped. You may use this option multiple times to build up a list of "
-"things to exclude."
+"The following command line options are supported by some debhelper "
+"programs. See the man page of each program for a complete explanation of "
+"what each option does."
msgstr ""
-# type: =item
-#: dh_strip:45
-msgid "B<--dbg-package=>I<package>"
+#. type: =item
+#: debhelper.pod:161
+msgid "B<-n>"
msgstr ""
-# type: textblock
-#: dh_strip:47
-msgid ""
-"Causes dh_strip to save debug symbols stripped from the packages it acts on "
-"as independent files in the package build directory of the specified "
-"debugging package."
+#. type: textblock
+#: debhelper.pod:163
+msgid "Do not modify postinst/postrm/etc scripts."
msgstr ""
-# type: textblock
-#: dh_strip:51
-msgid ""
-"For example, if your packages are lifoo and foo and you want to include a "
-"foo-dbg package with debugging symbols, use dh_strip --dbg-package=foo-dbg."
+#. type: =item
+#: debhelper.pod:165 dh_compress:43 dh_makeshlibs:66 dh_md5sums:37 dh_shlibdeps:36 dh_strip:39
+msgid "B<-X>I<item>, B<--exclude=>I<item>"
msgstr ""
-# type: textblock
-#: dh_strip:54
+#. type: textblock
+#: debhelper.pod:167
msgid ""
-"Note that this option behaves significantly different in debhelper "
-"compatibility levels 4 and below. Instead of specifying the name of a debug "
-"package to put symbols in, it specifies a package (or packages) which should "
-"have separated debug symbols, and the separated symbols are placed in "
-"packages with \"-dbg\" added to their name."
+"Exclude an item from processing. This option may be used multiple times, to "
+"exclude more than one thing."
msgstr ""
-# type: textblock
-#: dh_strip:60
+#. type: =item
+#: debhelper.pod:170 dh_compress:51 dh_installdirs:32 dh_installdocs:53 dh_installexamples:33 dh_installinfo:32 dh_installman:62 dh_link:52
+msgid "B<-A>, B<--all>"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:172
msgid ""
-"Note that if you use this option, your package should build-depend on "
-"binutils (>= 2.14.90.0.7)."
+"Makes files or other items that are specified on the command line take "
+"effect in ALL packages acted on, not just the first."
msgstr ""
-# type: =item
-#: dh_strip:63
-msgid "B<-k>, B<--keep-debug>"
+#. type: =head1
+#: debhelper.pod:177
+msgid "BUILD SYSTEM OPTIONS"
msgstr ""
-# type: textblock
-#: dh_strip:65
+#. type: textblock
+#: debhelper.pod:179
msgid ""
-"Debug symbols will be retained, but split into an independent file in "
-"usr/lib/debug/ in the package build directory. --dbg-package is easier to "
-"use than this option, but this option is more flexible."
+"The following command line options are supported by all of the dh_auto_* "
+"debhelper programs. These programs support a variety of build systems, and "
+"normally heuristically determine which to use, and how to use them. You can "
+"use these command line options to override the default behavior."
msgstr ""
-# type: textblock
-#: dh_strip:69
-msgid ""
-"Note that if you use this option, your package should build-depend on "
-"binutils (>= 2.12.90.0.9)."
+#. type: =item
+#: debhelper.pod:186
+msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>"
msgstr ""
-# type: textblock
-#: dh_strip:76
+#. type: textblock
+#: debhelper.pod:188
msgid ""
-"If the DEB_BUILD_OPTIONS environment variable contains \"nostrip\", nothing "
-"will be stripped, in accordance with Debian policy."
+"Force use of the specified I<buildsystem>, instead of trying to auto-select "
+"one which might be applicable for the package."
msgstr ""
-# type: =head1
-#: dh_strip:79 dh_compress:61 dh_usrlocal:54 dh_perl:58 dh_python:62
-msgid "CONFORMS TO"
+#. type: =item
+#: debhelper.pod:191
+msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>"
msgstr ""
-# type: textblock
-#: dh_strip:81 dh_perl:60
-msgid "Debian policy, version 3.0.1"
+#. type: textblock
+#: debhelper.pod:193
+msgid ""
+"Assume that the original package source tree is at the specified "
+"I<directory> rather than the top level directory of the Debian source "
+"package tree."
msgstr ""
-# type: textblock
-#: dh_installppp:5
-msgid "dh_installppp - install ppp ip-up and ip-down files"
+#. type: =item
+#: debhelper.pod:197
+msgid "B<-B>[I<directory>], B<--builddirectory>=[I<directory>]"
msgstr ""
-# type: textblock
-#: dh_installppp:14
-msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
+#. type: textblock
+#: debhelper.pod:199
+msgid ""
+"Enable out of source building and use the specified I<directory> as the "
+"build directory. If I<directory> parameter is omitted, a default build "
+"directory will chosen."
msgstr ""
-# type: textblock
-#: dh_installppp:18
+#. type: textblock
+#: debhelper.pod:203
msgid ""
-"dh_installppp is a debhelper program that is responsible for installing ppp "
-"ip-up and ip-down scripts. into package build directories."
+"If this option is not specified, building will be done in source by default "
+"unless the build system requires or prefers out of source tree building. In "
+"such a case, the default build directory will be used even if "
+"L<--builddirectory> is not specified."
msgstr ""
-# type: textblock
-#: dh_installppp:21
+#. type: textblock
+#: debhelper.pod:208
msgid ""
-"If a file named debian/package.ppp.ip-up exists, then it is installed into "
-"etc/ppp/ip-up.d/package in the package build directory. Files named "
-"debian/package.ppp.ip-down are installed to etc/ppp/ip-down.d/package"
+"If the build system prefers out of source tree building but still allows in "
+"source building, the latter can be re-enabled by passing a build directory "
+"path that is the same as the source directory path."
msgstr ""
-# type: textblock
-#: dh_installppp:32
+#. type: =item
+#: debhelper.pod:212
+msgid "B<--list>, B<-l>"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:214
msgid ""
-"Look for files named debian/package.name.ppp.ip-* and install them as "
-"etc/ppp/ip-*/name, instead of using the usual files and installing them as "
-"the package name."
+"List all build systems supported by debhelper on this system. The list "
+"includes both default and third party build systems (marked as such). Also "
+"shows which build system would be automatically selected, or which one is "
+"manually specified with the I<--buildsystem> option."
msgstr ""
-# type: textblock
-#: dh_compress:5
-msgid "dh_compress - compress files and fix symlinks in package build directories"
+#. type: =head1
+#: debhelper.pod:221 dh_installcatalogs:52 dh_installdocs:81 dh_installemacsen:54 dh_installexamples:50 dh_installinit:110 dh_installman:79 dh_installmime:41 dh_installmodules:60 dh_installwm:53 dh_installxfonts:37 dh_movefiles:58 dh_strip:68 dh_usrlocal:49
+msgid "NOTES"
msgstr ""
-# type: textblock
-#: dh_compress:15
-msgid ""
-"B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file "
-"...>>]"
+#. type: =head2
+#: debhelper.pod:223
+msgid "Multiple binary package support"
msgstr ""
-# type: textblock
-#: dh_compress:19
+#. type: textblock
+#: debhelper.pod:225
msgid ""
-"dh_compress is a debhelper program that is responsible for compressing the "
-"files in package build directories, and makes sure that any symlinks that "
-"pointed to the files before they were compressed are updated to point to the "
-"new files."
+"If your source package generates more than one binary package, debhelper "
+"programs will default to acting on all binary packages when run. If your "
+"source package happens to generate one architecture dependent package, and "
+"another architecture independent package, this is not the correct behavior, "
+"because you need to generate the architecture dependent packages in the "
+"binary-arch debian/rules target, and the architecture independent packages "
+"in the binary-indep debian/rules target."
msgstr ""
-# type: textblock
-#: dh_compress:24
+#. type: textblock
+#: debhelper.pod:233
msgid ""
-"By default, dh_compress compresses files that debian policy mandates should "
-"be compressed, namely all files in usr/share/info, usr/share/man, "
-"usr/X11R6/man, files in usr/share/doc that are larger than 4k in size, "
-"(except the copyright file, .html and .css files, and files that appear to "
-"be already compressed based on their extensions), and all changelog "
-"files. Plus PCF fonts underneath usr/X11R6/lib/X11/fonts/"
+"To facilitate this, as well as give you more control over which packages are "
+"acted on by debhelper programs, all debhelper programs accept the B<-a>, "
+"B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If "
+"none are given, debhelper programs default to acting on all packages listed "
+"in the control file."
+msgstr ""
+
+#. type: =head2
+#: debhelper.pod:239
+msgid "Automatic generation of debian install scripts"
msgstr ""
-# type: textblock
-#: dh_compress:31
+#. type: textblock
+#: debhelper.pod:241
msgid ""
-"If a debian/package.compress file exists, however, it will be ran as a shell "
-"script, and all filenames that the shell script outputs will be compressed "
-"instead of the default files. The shell script will be run from inside the "
-"package build directory. Note though that using -X is a much better idea in "
-"general; you should only use a debian/package.compress file if you really "
-"have to."
+"Some debhelper commands will automatically generate parts of debian "
+"maintainer scripts. If you want these automatically generated things "
+"included in your existing debian maintainer scripts, then you need to add "
+"\"#DEBHELPER#\" to your scripts, in the place the code should be added. "
+"\"#DEBHELPER#\" will be replaced by any auto-generated code when you run "
+"dh_installdeb."
msgstr ""
-# type: textblock
-#: dh_compress:44
+#. type: textblock
+#: debhelper.pod:248
msgid ""
-"Exclude files that contain \"item\" anywhere in their filename from being "
-"compressed. For example, -X.jpeg will exclude jpeg files from compression. "
-"You may use this option multiple times to build up a list of things to "
-"exclude. You can accomplish the same thing by using a debian/compress file, "
-"but this is easier."
+"If a script does not exist at all and debhelper needs to add something to "
+"it, then debhelper will create the complete script."
msgstr ""
-# type: textblock
-#: dh_compress:52
+#. type: textblock
+#: debhelper.pod:251
msgid ""
-"Compress all files specified by command line parameters in ALL packages "
-"acted on."
+"All debhelper commands that automatically generate code in this way let it "
+"be disabled by the -n parameter (see above)."
msgstr ""
-# type: textblock
-#: dh_compress:57
-msgid "Add these files to the list of files to compress."
+#. type: textblock
+#: debhelper.pod:254
+msgid ""
+"Note that the inserted code will be shell code, so you cannot directly use "
+"it in a perl script. If you would like to embed it into a perl script, here "
+"is one way to do that (note that I made sure that $1, $2, etc are set with "
+"the set command):"
msgstr ""
-# type: textblock
-#: dh_compress:63
-msgid "Debian policy, version 3.0"
+#. type: verbatim
+#: debhelper.pod:259
+#, no-wrap
+msgid ""
+" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
+" #DEBHELPER#\n"
+" EOF\n"
+" system ($temp) / 256 == 0\n"
+" \tor die \"Problem with debhelper scripts: $!\";\n"
+"\n"
msgstr ""
-# type: textblock
-#: dh_md5sums:5
-msgid "dh_md5sums - generate DEBIAN/md5sums file"
+#. type: =head2
+#: debhelper.pod:265
+msgid "Automatic generation of miscellaneous dependencies."
msgstr ""
-# type: textblock
-#: dh_md5sums:15
+#. type: textblock
+#: debhelper.pod:267
msgid ""
-"B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
-"[B<--include-conffiles>]"
+"Some debhelper commands may make the generated package need to depend on "
+"some other packages. For example, if you use L<dh_installdebconf(1)>, your "
+"package will generally need to depend on debconf. Or if you use "
+"L<dh_installxfonts(1)>, your package will generally need to depend on a "
+"particular version of xutils. Keeping track of these miscellaneous "
+"dependencies can be annoying since they are dependant on how debhelper does "
+"things, so debhelper offers a way to automate it."
msgstr ""
-# type: textblock
-#: dh_md5sums:19
+#. type: textblock
+#: debhelper.pod:275
msgid ""
-"dh_md5sums is a debhelper program that is responsible for generating a "
-"DEBIAN/md5sums file, which lists the md5sums of each file in the package. "
-"These files are used by the debsums package."
+"All commands of this type, besides documenting what dependencies may be "
+"needed on their man pages, will automatically generate a substvar called "
+"${misc:Depends}. If you put that token into your debian/control file, it "
+"will be expanded to the dependencies debhelper figures you need."
msgstr ""
-# type: textblock
-#: dh_md5sums:23
+#. type: textblock
+#: debhelper.pod:280
msgid ""
-"All files in DEBIAN/ are omitted from the md5sums file, as are all conffiles "
-"(unless you use the --include-conffiles switch)."
+"This is entirely independent of the standard ${shlibs:Depends} generated by "
+"L<dh_makeshlibs(1)>, and the ${perl:Depends} generated by L<dh_perl(1)>. "
+"You can choose not to use any of these, if debhelper's guesses don't match "
+"reality."
msgstr ""
-# type: textblock
-#: dh_md5sums:26
-msgid "The md5sums file is installed with proper permissions and ownerships."
+#. type: =head2
+#: debhelper.pod:285
+msgid "Package build directories"
msgstr ""
-# type: =item
-#: dh_md5sums:32
-msgid "B<-x>, B<--include-conffiles>"
+#. type: textblock
+#: debhelper.pod:287
+msgid ""
+"By default, all debhelper programs assume that the temporary directory used "
+"for assembling the tree of files in a package is debian/<package>."
msgstr ""
-# type: textblock
-#: dh_md5sums:34
+#. type: textblock
+#: debhelper.pod:290
msgid ""
-"Include conffiles in the md5sums list. Note that this information is "
-"redundant since it is included elsewhere in debian packages."
+"Sometimes, you might want to use some other temporary directory. This is "
+"supported by the -P flag. For example, \"dh_installdocs -Pdebian/tmp\", will "
+"use debian/tmp as the temporary directory. Note that if you use -P, the "
+"debhelper programs can only be acting on a single package at a time. So if "
+"you have a package that builds many binary packages, you will need to also "
+"use the -p flag to specify which binary package the debhelper program will "
+"act on."
msgstr ""
-# type: textblock
-#: dh_md5sums:39
-msgid ""
-"Exclude files that contain \"item\" anywhere in their filename from being "
-"listed in the md5sums file."
+#. type: =head2
+#: debhelper.pod:298
+msgid "Debhelper compatibility levels"
msgstr ""
-# type: textblock
-#: dh_installexamples:5
-msgid "dh_installexamples - install example files into package build directories"
+#. type: textblock
+#: debhelper.pod:300
+msgid ""
+"From time to time, major non-backwards-compatible changes need to be made to "
+"debhelper, to keep it clean and well-designed as needs change and its author "
+"gains more experience. To prevent such major changes from breaking existing "
+"packages, the concept of debhelper compatibility levels was introduced. You "
+"tell debhelper which compatibility level it should use, and it modifies its "
+"behavior in various ways."
msgstr ""
-# type: textblock
-#: dh_installexamples:14
+#. type: textblock
+#: debhelper.pod:307
msgid ""
-"B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
-"[S<I<file ...>>]"
+"Tell debhelper what compatibility level to use by writing a number to "
+"debian/compat. For example, to turn on V7 mode:"
msgstr ""
-# type: textblock
-#: dh_installexamples:18
+#. type: verbatim
+#: debhelper.pod:310
+#, no-wrap
msgid ""
-"dh_installexamples is a debhelper program that is responsible for installing "
-"examples into usr/share/doc/package/examples in package build directories."
+" % echo 7 > debian/compat\n"
+"\n"
msgstr ""
-# type: textblock
-#: dh_installexamples:22
+#. type: textblock
+#: debhelper.pod:312
msgid ""
-"Any file names specified as parameters will be installed into the first "
-"package dh_installexamples is told to act on. By default, this is the first "
-"binary package in debian/control, but if you use -p, -i, or -a flags, it "
-"will be the first package specified by those flags."
+"Unless otherwise indicated, all debhelper documentation assumes that you are "
+"using the most recent compatibility level, and in most cases does not "
+"indicate if the behavior is different in an earlier compatibility level, so "
+"if you are not using the most recent compatibility level, you're advised to "
+"read below for notes about what is different in earlier compatibility "
+"levels."
msgstr ""
-# type: textblock
-#: dh_installexamples:27
-msgid "Files named debian/package.examples can list other files to be installed."
+#. type: textblock
+#: debhelper.pod:319
+msgid "These are the available compatibility levels:"
msgstr ""
-# type: textblock
-#: dh_installexamples:35
-msgid ""
-"Install any files specified by command line parameters in ALL packages acted "
-"on."
+#. type: =item
+#: debhelper.pod:323
+msgid "V1"
msgstr ""
-# type: textblock
-#: dh_installexamples:40
+#. type: textblock
+#: debhelper.pod:325
msgid ""
-"Install these files as examples into the first package acted on. (Or into "
-"all packages if -A is specified.)"
+"This is the original debhelper compatibility level, and so it is the default "
+"one. In this mode, debhelper will use debian/tmp as the package tree "
+"directory for the first binary package listed in the control file, while "
+"using debian/<package> for all other packages listed in the control file."
msgstr ""
-# type: =item
-#: dh_installexamples:43 dh_install:47 dh_movefiles:44 dh_installdocs:64
-msgid "B<-Xitem>, B<--exclude=item>"
+#. type: textblock
+#: debhelper.pod:330 debhelper.pod:337 debhelper.pod:360 debhelper.pod:389
+msgid "This mode is deprecated."
msgstr ""
-# type: textblock
-#: dh_installexamples:45 dh_install:49 dh_movefiles:46
-msgid ""
-"Exclude files that contain \"item\" anywhere in their filename from being "
-"installed."
+#. type: =item
+#: debhelper.pod:332
+msgid "V2"
msgstr ""
-# type: textblock
-#: dh_installexamples:52
+#. type: textblock
+#: debhelper.pod:334
msgid ""
-"Note that dh_installexamples will happily copy entire directory hierarchies "
-"if you ask it to (similar to cp -a). If it is asked to install a directory, "
-"it will install the complete contents of the directory."
+"In this mode, debhelper will consistently use debian/<package> as the "
+"package tree directory for every package that is built."
msgstr ""
-# type: textblock
-#: dh_installcron:5
-msgid "dh_installcron - install cron scripts into etc/cron.*"
+#. type: =item
+#: debhelper.pod:339
+msgid "V3"
msgstr ""
-# type: textblock
-#: dh_installcron:14
-msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
+#. type: textblock
+#: debhelper.pod:341
+msgid "This mode works like V2, with the following additions:"
msgstr ""
-# type: textblock
-#: dh_installcron:18
-msgid ""
-"dh_installcron is a debhelper program that is responsible for installing "
-"cron scripts into etc/cron.*/ in package build directories. The files "
-"debian/package.cron.daily, debian/package.cron.weekly, "
-"debian/package.cron.monthly, debian/package.cron.hourly, and "
-"debian/package.cron.d are installed."
+#. type: =item
+#: debhelper.pod:345 debhelper.pod:350 debhelper.pod:354 debhelper.pod:368 debhelper.pod:373 debhelper.pod:378 debhelper.pod:383 debhelper.pod:397 debhelper.pod:401 debhelper.pod:406 debhelper.pod:410 debhelper.pod:422 debhelper.pod:427 debhelper.pod:433 debhelper.pod:439 debhelper.pod:454 debhelper.pod:461 debhelper.pod:465 debhelper.pod:469
+msgid "-"
msgstr ""
-# type: textblock
-#: dh_installcron:30
+#. type: textblock
+#: debhelper.pod:347
msgid ""
-"Look for files named debian/package.name.cron.* and install them as "
-"etc/cron.*/name, instead of using the usual files and installing them as the "
-"package name."
+"Debhelper config files support globbing via * and ?, when appropriate. To "
+"turn this off and use those characters raw, just prefix with a backslash."
msgstr ""
-# type: textblock
-#: dh_installinit:5
-msgid "dh_installinit - install init scripts into package build directories"
+#. type: textblock
+#: debhelper.pod:352
+msgid "dh_makeshlibs makes the postinst and postrm scripts call ldconfig."
msgstr ""
-# type: textblock
-#: dh_installinit:14
-msgid ""
-"B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
-"[B<-r>] [B<-d>] [S<B<--> I<params>>]"
+#. type: textblock
+#: debhelper.pod:356
+msgid "Every file in etc/ is automatically flagged as a conffile by dh_installdeb."
msgstr ""
-# type: textblock
-#: dh_installinit:18
-msgid ""
-"dh_installinit is a debhelper program that is responsible for installing "
-"init scripts and associated defaults files into package build directories."
+#. type: =item
+#: debhelper.pod:362
+msgid "V4"
msgstr ""
-# type: textblock
-#: dh_installinit:21
+#. type: textblock
+#: debhelper.pod:364
+msgid "Changes from V3 are:"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:370
msgid ""
-"It also automatically generates the postinst and postrm and prerm commands "
-"needed to set up the symlinks in /etc/rc*.d/ and to start and stop the init "
-"scripts."
+"dh_makeshlibs -V will not include the debian part of the version number in "
+"the generated dependency line in the shlibs file."
msgstr ""
-# type: textblock
-#: dh_installinit:25
+#. type: textblock
+#: debhelper.pod:375
msgid ""
-"If a file named debian/package.init exists, then it is installed into "
-"etc/init.d/package in the package build directory, with \"package\" replaced "
-"by the package name."
+"You are encouraged to put the new ${misc:Depends} into debian/control to "
+"supplement the ${shlibs:Depends} field."
msgstr ""
-# type: textblock
-#: dh_installinit:29
+#. type: textblock
+#: debhelper.pod:380
msgid ""
-"If a file named debian/package.default exists, then it is installed into "
-"etc/default/package in the package build directory, with \"package\" "
-"replaced by the package name."
+"dh_fixperms will make all files in bin/ directories and in etc/init.d "
+"executable."
msgstr ""
-# type: textblock
-#: dh_installinit:39
-msgid "Do not modify postinst/postrm/prerm scripts."
+#. type: textblock
+#: debhelper.pod:385
+msgid "dh_link will correct existing links to conform with policy."
msgstr ""
-# type: =item
-#: dh_installinit:41
-msgid "B<-o>, B<--onlyscripts>"
+#. type: =item
+#: debhelper.pod:391
+msgid "V5"
msgstr ""
-# type: textblock
-#: dh_installinit:43
+#. type: textblock
+#: debhelper.pod:393
+msgid "Changes from V4 are:"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:399
+msgid "Comments are ignored in debhelper config files."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:403
msgid ""
-"Only modify postinst/postrm/prerm scripts, do not actually install any init "
-"script or default files. May be useful if the init script is shipped and/or "
-"installed by upstream in a way that doesn't make it easy to let "
-"dh_installinit find it."
+"dh_strip --dbg-package now specifies the name of a package to put debugging "
+"symbols in, not the packages to take the symbols from."
msgstr ""
-# type: =item
-#: dh_installinit:48
-msgid "B<-r>, B<--no-restart-on-upgrade>"
+#. type: textblock
+#: debhelper.pod:408
+msgid "dh_installdocs skips installing empty files."
msgstr ""
-# type: textblock
-#: dh_installinit:50
-msgid "Do not restart init script on upgrade."
+#. type: textblock
+#: debhelper.pod:412
+msgid "dh_install errors out if wildcards expand to nothing."
msgstr ""
-# type: =item
-#: dh_installinit:52
-msgid "B<--no-start>"
+#. type: =item
+#: debhelper.pod:416
+msgid "V6"
msgstr ""
-# type: textblock
-#: dh_installinit:54
-msgid ""
-"Do not start the init script on install or upgrade, or stop it on removal. "
-"Only call update-rc.d. Useful for rcS scripts."
+#. type: textblock
+#: debhelper.pod:418
+msgid "Changes from V5 are:"
msgstr ""
-# type: =item
-#: dh_installinit:57
-msgid "B<-d>, B<--remove-d>"
-msgstr ""
-
-# type: textblock
-#: dh_installinit:59
+#. type: textblock
+#: debhelper.pod:424
msgid ""
-"Remove trailing \"d\" from the name of the package, and use the result for "
-"the filename the init script is installed as in etc/init.d/ , and the "
-"default file is installed as in etc/default/ . This may be useful for "
-"daemons with names ending in \"d\". (Note: this takes precedence over the "
-"--init-script parameter described below.)"
-msgstr ""
-
-# type: =item
-#: dh_installinit:65
-msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
-msgstr ""
-
-# type: =item
-#: dh_installinit:67 dh_shlibdeps:32 dh_installdebconf:67 dh_builddeb:37 dh_gencontrol:32
-msgid "B<--> I<params>"
+"Commands that generate maintainer script fragments will order the fragments "
+"in reverse order for the prerm and postrm scripts."
msgstr ""
-# type: textblock
-#: dh_installinit:69
+#. type: textblock
+#: debhelper.pod:429
msgid ""
-"Pass \"params\" to L<update-rc.d(8)>. If not specified, \"defaults\" will be "
-"passed to L<update-rc.d(8)>."
+"dh_installwm will install a slave manpage link for x-window-manager.1.gz, if "
+"it sees the man page in usr/share/man/man1 in the package build directory."
msgstr ""
-# type: textblock
-#: dh_installinit:74
+#. type: textblock
+#: debhelper.pod:435
msgid ""
-"Install the init script (and default file) using the filename I<name> "
-"instead of the default filename, which is the package name. When this "
-"parameter is used, dh_installinit looks for and installs files named "
-"debian/package.name.init and debian/package.name.default, instead of the "
-"usual debian/package.init and debian/package.default."
+"dh_builddeb did not previously delete everything matching DH_ALWAYS_EXCLUDE, "
+"if it was set to a list of things to exclude, such as \"CVS:.svn:.git\". Now "
+"it does."
msgstr ""
-# type: =item
-#: dh_installinit:80
-msgid "B<--init-script=>I<scriptname>"
+#. type: textblock
+#: debhelper.pod:441
+msgid ""
+"dh_installman allows overwriting existing man pages in the package build "
+"directory. In previous compatibility levels it silently refuses to do this."
msgstr ""
-# type: textblock
-#: dh_installinit:82
-msgid ""
-"Use \"scriptname\" as the filename the init script is installed as in "
-"etc/init.d/ (and also use it as the filename for the defaults file, if it is "
-"installed). If you use this parameter, dh_installinit will look to see if a "
-"file in the debian/ directory exists that looks like \"package.scriptname\" "
-"and if so will install it as the init script in preference to the files it "
-"normally installs."
+#. type: =item
+#: debhelper.pod:446
+msgid "V7"
msgstr ""
-# type: textblock
-#: dh_installinit:89
-msgid "This parameter is deprecated, use the --name parameter instead."
+#. type: textblock
+#: debhelper.pod:448
+msgid "This is the recommended mode of operation."
msgstr ""
-# type: =item
-#: dh_installinit:91
-msgid "B<--error-handler=>I<function>"
+#. type: textblock
+#: debhelper.pod:450
+msgid "Changes from V6 are:"
msgstr ""
-# type: textblock
-#: dh_installinit:93
+#. type: textblock
+#: debhelper.pod:456
msgid ""
-"Call the named shell function if running the init script fails. The function "
-"should be provided in the prerm and postinst scripts, before the #DEBHELPER# "
-"token."
+"dh_install, will fall back to looking for files in debian/tmp if it doesn't "
+"find them in the current directory (or wherever you tell it look using "
+"--sourcedir). This allows dh_install to interoperate with dh_auto_install, "
+"which installs to debian/tmp, without needing any special parameters."
msgstr ""
-# type: textblock
-#: dh_usrlocal:5
-msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
+#. type: textblock
+#: debhelper.pod:463
+msgid "dh_clean will read debian/clean and delete files listed there."
msgstr ""
-# type: textblock
-#: dh_usrlocal:17
-msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
+#. type: textblock
+#: debhelper.pod:467
+msgid "dh_clean will delete toplevel *-stamp files."
msgstr ""
-# type: textblock
-#: dh_usrlocal:21
+#. type: textblock
+#: debhelper.pod:471
msgid ""
-"dh_usrlocal is a debhelper program that can be used for building packages "
-"that will provide a subdirectory in /usr/local when installed."
+"dh_installchangelogs will guess at what file is the upstream changelog if "
+"none is specified."
msgstr ""
-# type: textblock
-#: dh_usrlocal:24
-msgid ""
-"It finds subdirectories of usr/local in the package build directory, and "
-"removes them, replacing them with maintainer script snippets (unless B<-n> "
-"is used) to create the directories at install time, and remove them when the "
-"package is removed, in a manner compliant with Debian policy. See "
-"L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
-"snippets."
+#. type: =head2
+#: debhelper.pod:478
+msgid "Doc directory symlinks"
msgstr ""
-# type: textblock
-#: dh_usrlocal:31
+#. type: textblock
+#: debhelper.pod:480
msgid ""
-"If the directories found in the build tree have unusual owners, groups, or "
-"permissions, then those values will be preserved in the directories made by "
-"the postinst script. However, as a special exception, if a directory is "
-"owned by root.root, it will be treated as if it is owned by root.staff and "
-"is mode 2775. This is useful, since that is the group and mode policy "
-"recommends for directories in /usr/local."
+"Sometimes it is useful to make a package not contain a "
+"/usr/share/doc/package directory at all, instead placing just a dangling "
+"symlink in the binary package, that points to some other doc "
+"directory. Policy says this is ok if your package depends on the package "
+"whose doc directory it uses. To accomplish this, just don't tell debhelper "
+"to install any documentation files into the package, and use dh_link to set "
+"up the symlink (or do it by hand), and debhelper should do the right thing: "
+"notice it is a dangling symlink and not try to install a copyright file or "
+"changelog."
msgstr ""
-# type: textblock
-#: dh_usrlocal:44
-msgid "Do not modify F<postinst>/F<prerm> scripts."
+#. type: =head2
+#: debhelper.pod:489
+msgid "udebs"
msgstr ""
-# type: textblock
-#: dh_usrlocal:56
-msgid "Debian policy, version 2.2"
+#. type: textblock
+#: debhelper.pod:491
+msgid ""
+"Debhelper includes support for udebs. To create a udeb with debhelper, add "
+"\"XC-Package-Type: udeb\" to the package's stanza in debian/control, and "
+"build-depend on debhelper (>= 4.2). Debhelper will try to create udebs that "
+"comply with debian-installer policy, by making the generated package files "
+"end in \".udeb\", not installing any documentation into a udeb, skipping "
+"over preinst, postrm, prerm, and config scripts, etc."
msgstr ""
-# type: textblock
-#: dh_usrlocal:121
-msgid "Andrew Stribblehill <ads@debian.org>"
+#. type: =head2
+#: debhelper.pod:498
+msgid "Other notes"
msgstr ""
-# type: textblock
-#: dh_gconf:5
-msgid "dh_gconf - generate GConf schema registration scripts"
+#. type: textblock
+#: debhelper.pod:500
+msgid ""
+"In general, if any debhelper program needs a directory to exist under "
+"debian/, it will create it. I haven't bothered to document this in all the "
+"man pages, but for example, dh_installdeb knows to make "
+"debian/<package>/DEBIAN/ before trying to put files there, dh_installmenu "
+"knows you need a debian/<package>/usr/share/menu/ before installing the menu "
+"files, etc."
msgstr ""
-# type: textblock
-#: dh_gconf:14
-msgid "B<dh_gconf> [S<I<debhelper options>>] [B<-p<package>>]"
+#. type: textblock
+#: debhelper.pod:506
+msgid ""
+"Once your package uses debhelper to build, be sure to add debhelper to your "
+"Build-Depends line in debian/control. You should build-depend on a version "
+"of debhelper equal to (or greater than) the debhelper compatibility level "
+"your package uses. So if your package used compatibility level 7:"
msgstr ""
-# type: textblock
-#: dh_gconf:18
+#. type: verbatim
+#: debhelper.pod:512
+#, no-wrap
msgid ""
-"dh_gconf is a debhelper program that is responsible for registering GConf "
-"schemas."
+" Build-Depends: debhelper (>= 7)\n"
+"\n"
msgstr ""
-# type: textblock
-#: dh_gconf:21
-msgid ""
-"It automatically generates the postinst and prerm fragments needed to "
-"register and unregister the schemas in usr/share/gconf/schemas, using "
-"gconf-schemas."
+#. type: =head1
+#: debhelper.pod:514
+msgid "ENVIRONMENT"
msgstr ""
-# type: textblock
-#: dh_gconf:25
-msgid ""
-"If a file named debian/package.gconf-defaults exists, then it is installed "
-"into usr/share/gconf/defaults/10_package in the package build directory, "
-"with \"package\" replaced by the package name. Some postinst and postrm "
-"fragments will be generated to launch update-gconf-defaults."
+#. type: =item
+#: debhelper.pod:518
+msgid "DH_VERBOSE"
msgstr ""
-# type: textblock
-#: dh_gconf:30
+#. type: textblock
+#: debhelper.pod:520
msgid ""
-"The gconf-schemas and update-gconf-defaults scripts are provided by the "
-"gconf2 package. An appropriate dependency will be generated in "
-"${misc:Depends}."
+"Set to 1 to enable verbose mode. Debhelper will output every command it runs "
+"that modifies files on the build system."
msgstr ""
-# type: =item
-#: dh_gconf:38
-msgid "B<--priority> I<priority>"
+#. type: =item
+#: debhelper.pod:523
+msgid "DH_COMPAT"
msgstr ""
-# type: textblock
-#: dh_gconf:40
+#. type: textblock
+#: debhelper.pod:525
msgid ""
-"Use I<priority> (which should be a 2-digit number) as the defaults priority "
-"instead of 10. Higher values than ten can be used by derived distributions "
-"(20), CDD distributions (50), or site-specific packages (90)."
+"Temporarily specifies what compatibility level debhelper should run at, "
+"overriding any value in debian/compat."
msgstr ""
-# type: textblock
-#: dh_gconf:98
-msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>"
+#. type: =item
+#: debhelper.pod:528
+msgid "DH_NO_ACT"
msgstr ""
-# type: textblock
-#: dh_installmodules:5
-msgid "dh_installmodules - register modules with modutils"
+#. type: textblock
+#: debhelper.pod:530
+msgid "Set to 1 to enable no-act mode."
msgstr ""
-# type: textblock
-#: dh_installmodules:16
-msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
+#. type: =item
+#: debhelper.pod:532
+msgid "DH_OPTIONS"
msgstr ""
-# type: textblock
-#: dh_installmodules:20
+#. type: textblock
+#: debhelper.pod:534
msgid ""
-"dh_installmodules is a debhelper program that is responsible for registering "
-"kernel modules with modutils."
+"Anything in this variable will be prepended to the command line arguments of "
+"all debhelper commands. Command-specific options will be ignored by commands "
+"that do not support them."
msgstr ""
-# type: textblock
-#: dh_installmodules:23
+#. type: textblock
+#: debhelper.pod:538
msgid ""
-"Files named debian/package.modules will be installed as etc/modutils/package "
-"in the package build directory. This is for use by modutils. Files named "
-"debian/package.modprobe will be installed in etc/modprobe.d/package in the "
-"package build directory, to be used by module-init-tools's version of "
-"modprobe."
+"This is useful in some situations, for example, if you need to pass -p to "
+"all debhelper commands that will be run. One good way to set DH_OPTIONS is "
+"by using \"Target-specific Variable Values\" in your debian/rules file. See "
+"the make documentation for details on doing this."
msgstr ""
-# type: textblock
-#: dh_installmodules:29
-msgid ""
-"Then postinst and postrm commands are automatically generated to register "
-"the modules when the package is installed. See L<dh_installdeb(1)> for an "
-"explanation of how this works. Note that this will be done for any package "
-"this program acts on which has either a package.modules file, or has .o or "
-".ko files in /lib/modules."
+#. type: =item
+#: debhelper.pod:543
+msgid "DH_ALWAYS_EXCLUDE"
msgstr ""
-# type: textblock
-#: dh_installmodules:41 dh_installmenu:39 dh_installmime:36 dh_makeshlibs:60 dh_python:58
-msgid "Do not modify postinst/postrm scripts."
+#. type: textblock
+#: debhelper.pod:545
+msgid ""
+"If set, this adds the value the variable is set to to the -X options of all "
+"commands that support the -X option. Moreover, dh_builddeb will rm -rf "
+"anything that matches the value in your package build tree."
msgstr ""
-# type: textblock
-#: dh_installmodules:45
+#. type: textblock
+#: debhelper.pod:549
msgid ""
-"Use \"name\" as the filename the modules file is installed in "
-"etc/modutils/. When this parameter is used, dh_installmodules looks for and "
-"installs files named debian/package.name.modules instead of the usual "
-"debian/package.modules."
+"This can be useful if you are doing a build from a CVS source tree, in which "
+"case setting DH_ALWAYS_EXCLUDE=CVS will prevent any CVS directories from "
+"sneaking into the package you build. Or, if a package has a source tarball "
+"that (unwisely) includes CVS directories, you might want to export "
+"DH_ALWAYS_EXCLUDE=CVS in debian/rules, to make it take effect wherever your "
+"package is built."
msgstr ""
-# type: textblock
-#: dh_installmenu:5
-msgid "dh_installmenu - install debian menu files into package build directories"
+#. type: textblock
+#: debhelper.pod:556
+msgid ""
+"Multiple things to exclude can be separated with colons, as in "
+"DH_ALWAYS_EXCLUDE=CVS:.svn"
msgstr ""
-# type: textblock
-#: dh_installmenu:14
-msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
+#. type: =head1
+#: debhelper.pod:561 dh_builddeb:88 dh_clean:130 dh_compress:192 dh_desktop:27 dh_fixperms:122 dh_gconf:104 dh_gencontrol:79 dh_installcatalogs:109 dh_installchangelogs:147 dh_installcron:61 dh_installdebconf:118 dh_installdeb:94 dh_installdirs:83 dh_installdocs:223 dh_installemacsen:111 dh_installexamples:103 dh_installinfo:74 dh_installinit:224 dh_installlogcheck:51 dh_installlogrotate:50 dh_installmanpages:197 dh_installman:251 dh_installmenu:80 dh_installmime:85 dh_installmodules:124 dh_installpam:52 dh_install:267 dh_installppp:56 dh_installwm:107 dh_installxfonts:86 dh_link:223 dh_listpackages:29 dh_makeshlibs:227 dh_md5sums:89 dh_movefiles:164 dh_perl:152 dh_python:282 dh_scrollkeeper:28 dh_shlibdeps:168 dh_strip:227 dh_suidregister:117 dh_testdir:44 dh_testroot:27 dh_testversion:75 dh_undocumented:28 dh_usrlocal:114
+msgid "SEE ALSO"
msgstr ""
-# type: textblock
-#: dh_installmenu:18
-msgid ""
-"dh_installmenu is a debhelper program that is responsible for installing "
-"files used by the debian menu package into package build directories."
+#. type: =item
+#: debhelper.pod:565
+msgid "F</usr/share/doc/debhelper/examples/>"
msgstr ""
-# type: textblock
-#: dh_installmenu:21
-msgid ""
-"It also automatically generates the postinst and postrm commands needed to "
-"interface with the debian menu package. See L<dh_installdeb(1)> for an "
-"explanation of how this works."
+#. type: textblock
+#: debhelper.pod:567
+msgid "A set of example debian/rules files that use debhelper."
msgstr ""
-# type: textblock
-#: dh_installmenu:25
-msgid ""
-"If a file named debian/package.menu exists, then it is installed into "
-"usr/share/menu/package in the package build directory. This is a debian menu "
-"file. See L<menufile(5)> for its format."
+#. type: =item
+#: debhelper.pod:569
+msgid "L<http://kitenet.net/~joey/code/debhelper/>"
msgstr ""
-# type: textblock
-#: dh_installmenu:29
-msgid ""
-"If a file named debian/package.menu-method exits, then it is installed into "
-"etc/menu-methods/package in the package build directory. This is a debian "
-"menu method file."
+#. type: textblock
+#: debhelper.pod:571
+msgid "Debhelper web site."
msgstr ""
-# type: textblock
-#: dh_installmenu:81
-msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
+#. type: =head1
+#: debhelper.pod:575 dh_builddeb:94 dh_clean:136 dh_compress:198 dh_desktop:33 dh_fixperms:128 dh_gconf:110 dh_gencontrol:85 dh_installcatalogs:115 dh_installchangelogs:153 dh_installcron:67 dh_installdebconf:124 dh_installdeb:100 dh_installdirs:89 dh_installdocs:229 dh_installemacsen:117 dh_installexamples:109 dh_installinfo:80 dh_installinit:230 dh_installlogcheck:57 dh_installlogrotate:56 dh_installmanpages:203 dh_installman:257 dh_installmenu:88 dh_installmime:91 dh_installmodules:130 dh_installpam:58 dh_install:273 dh_installppp:62 dh_installwm:113 dh_installxfonts:92 dh_link:229 dh_listpackages:35 dh_makeshlibs:233 dh_md5sums:95 dh_movefiles:170 dh_perl:158 dh_python:288 dh_scrollkeeper:34 dh_shlibdeps:174 dh_strip:233 dh_suidregister:123 dh_testdir:50 dh_testroot:33 dh_testversion:81 dh_undocumented:34 dh_usrlocal:120
+msgid "AUTHOR"
msgstr ""
-# type: textblock
-#: dh_installlogrotate:5
-msgid "dh_installlogrotate - install logrotate config files"
+#. type: textblock
+#: debhelper.pod:577 dh_builddeb:96 dh_clean:138 dh_compress:200 dh_fixperms:130 dh_gencontrol:87 dh_installchangelogs:155 dh_installcron:69 dh_installdebconf:126 dh_installdeb:102 dh_installdirs:91 dh_installdocs:231 dh_installemacsen:119 dh_installexamples:111 dh_installinfo:82 dh_installinit:232 dh_installlogrotate:58 dh_installmanpages:205 dh_installman:259 dh_installmenu:90 dh_installmime:93 dh_installmodules:132 dh_installpam:60 dh_install:275 dh_installppp:64 dh_installwm:115 dh_installxfonts:94 dh_link:231 dh_listpackages:37 dh_makeshlibs:235 dh_md5sums:97 dh_movefiles:172 dh_shlibdeps:176 dh_strip:235 dh_suidregister:125 dh_testdir:52 dh_testroot:35 dh_testversion:83 dh_undocumented:36
+msgid "Joey Hess <joeyh@debian.org>"
msgstr ""
-# type: textblock
-#: dh_installlogrotate:14
-msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
+#. type: textblock
+#: dh_builddeb:5
+msgid "dh_builddeb - build debian binary packages"
msgstr ""
-# type: textblock
-#: dh_installlogrotate:18
+#. type: textblock
+#: dh_builddeb:14
msgid ""
-"dh_installlogrotate is a debhelper program that is responsible for "
-"installing logrotate config files into etc/logrotate.d in package build "
-"directories. Files named debian/package.logrotate are installed."
+"B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
+"[B<--filename=>I<name>] [S<B<--> I<params>>]"
msgstr ""
-# type: textblock
-#: dh_installlogrotate:28
+#. type: textblock
+#: dh_builddeb:18
msgid ""
-"Look for files named debian/package.name.logrotate and install them as "
-"etc/logrotate.d/name, instead of using the usual files and installing them "
-"as the package name."
+"dh_builddeb simply calls L<dpkg-deb(8)> to build a debian package or "
+"packages."
msgstr ""
-# type: textblock
-#: debhelper.pod:3
-msgid "debhelper - the debhelper tool suite"
+#. type: =head1
+#: dh_builddeb:21 dh_clean:33 dh_compress:39 dh_fixperms:31 dh_gconf:39 dh_gencontrol:26 dh_installcatalogs:42 dh_installchangelogs:44 dh_installcron:24 dh_installdebconf:50 dh_installdirs:28 dh_installdocs:49 dh_installemacsen:35 dh_installexamples:29 dh_installinfo:28 dh_installinit:33 dh_installlogrotate:22 dh_installmanpages:40 dh_installman:58 dh_installmenu:34 dh_installmime:31 dh_installmodules:43 dh_installpam:24 dh_install:47 dh_installppp:26 dh_installwm:32 dh_link:48 dh_makeshlibs:28 dh_md5sums:28 dh_movefiles:32 dh_perl:31 dh_python:39 dh_shlibdeps:26 dh_strip:35 dh_testdir:23 dh_testversion:34 dh_usrlocal:39
+msgid "OPTIONS"
msgstr ""
-# type: textblock
-#: debhelper.pod:7
-msgid ""
-"B<dh_>I<*> [B<-v>] [B<-a>] [B<-i>] [B<-s>] [B<--no-act>] [B<-ppackage>] "
-"[B<-Npackage] [-Ptmpdir>]"
+#. type: =item
+#: dh_builddeb:25
+msgid "B<--destdir=>I<directory>"
msgstr ""
-# type: textblock
-#: debhelper.pod:11
+#. type: textblock
+#: dh_builddeb:27
msgid ""
-"Debhelper is used to help you build a debian package. The philosophy behind "
-"debhelper is to provide a collection of small, simple, and easily understood "
-"tools that are used in debian/rules to automate various common aspects of "
-"building a package. This means less work for you, the packager. It also, to "
-"some degree means that these tools can be changed if debian policy changes, "
-"and packages that use them will require only a rebuild to comply with the "
-"new policy."
+"Use this if you want the generated .deb files to be put in a directory other "
+"than the default of \"..\""
msgstr ""
-# type: textblock
-#: debhelper.pod:19
-msgid ""
-"A typical debian/rules file that uses debhelper will call several debhelper "
-"commands in sequence. Debhelper commands are all named with a \"dh_\" "
-"prefix. Examples of rules files that use debhelper are in "
-"F</usr/share/doc/debhelper/examples/>"
+#. type: =item
+#: dh_builddeb:30
+msgid "B<--filename=>I<name>"
msgstr ""
-# type: textblock
-#: debhelper.pod:24
+#. type: textblock
+#: dh_builddeb:32
msgid ""
-"To create a new debian package using debhelper, you can just copy one of the "
-"sample rules files and edit it by hand. Or you can try the dh-make package, "
-"which contains a L<dh_make|dh_make(1)> command that partially automates the "
-"process. For a more gentle introduction, the maint-guide debian package "
-"contains a tutorial about making your first package using debhelper."
+"Use this if you want to force the generated .deb file to have a particular "
+"file name. Does not work well if more than one .deb is generated!"
msgstr ""
-# type: =head1
-#: debhelper.pod:30
-msgid "DEBHELPER COMMANDS"
+#. type: =item
+#: dh_builddeb:35
+msgid "B<-u>I<params>"
msgstr ""
-# type: textblock
-#: debhelper.pod:32
-msgid ""
-"Here is the complete list of available debhelper commands. See their man "
-"pages for additional documentation."
+#. type: =item
+#: dh_builddeb:37 dh_gencontrol:32 dh_installdebconf:58 dh_installinit:78 dh_makeshlibs:76 dh_shlibdeps:32
+msgid "B<--> I<params>"
msgstr ""
-# type: textblock
-#: debhelper.pod:37
-msgid "#LIST#"
+#. type: textblock
+#: dh_builddeb:39
+msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
msgstr ""
-# type: textblock
-#: debhelper.pod:41
-msgid ""
-"If a program's name starts with \"dh_\", and the program is not on the above "
-"list, then it is not part of the debhelper package, but it should still work "
-"like the other programs described on this page."
+#. type: textblock
+#: dh_builddeb:90 dh_clean:132 dh_compress:194 dh_fixperms:124 dh_gconf:106 dh_gencontrol:81 dh_installcatalogs:111 dh_installchangelogs:149 dh_installcron:63 dh_installdebconf:120 dh_installdeb:96 dh_installdirs:85 dh_installdocs:225 dh_installemacsen:113 dh_installexamples:105 dh_installinfo:76 dh_installinit:226 dh_installlogcheck:53 dh_installlogrotate:52 dh_installmanpages:199 dh_installman:253 dh_installmime:87 dh_installmodules:126 dh_installpam:54 dh_install:269 dh_installppp:58 dh_installwm:109 dh_installxfonts:88 dh_link:225 dh_listpackages:31 dh_makeshlibs:229 dh_md5sums:91 dh_movefiles:166 dh_perl:154 dh_python:284 dh_strip:229 dh_suidregister:119 dh_testdir:46 dh_testroot:29 dh_testversion:77 dh_undocumented:30 dh_usrlocal:116
+msgid "L<debhelper(7)>"
msgstr ""
-# type: =head1
-#: debhelper.pod:45
-msgid "DEBHELPER CONFIG FILES"
+#. type: textblock
+#: dh_builddeb:92 dh_clean:134 dh_compress:196 dh_desktop:31 dh_fixperms:126 dh_gconf:108 dh_gencontrol:83 dh_installchangelogs:151 dh_installcron:65 dh_installdebconf:122 dh_installdeb:98 dh_installdirs:87 dh_installdocs:227 dh_installemacsen:115 dh_installexamples:107 dh_installinfo:78 dh_installinit:228 dh_installlogrotate:54 dh_installmanpages:201 dh_installman:255 dh_installmenu:86 dh_installmime:89 dh_installmodules:128 dh_installpam:56 dh_install:271 dh_installppp:60 dh_installwm:111 dh_installxfonts:90 dh_link:227 dh_listpackages:33 dh_makeshlibs:231 dh_md5sums:93 dh_movefiles:168 dh_perl:156 dh_python:286 dh_scrollkeeper:32 dh_shlibdeps:172 dh_strip:231 dh_suidregister:121 dh_testdir:48 dh_testroot:31 dh_testversion:79 dh_undocumented:32 dh_usrlocal:118
+msgid "This program is a part of debhelper."
msgstr ""
-# type: textblock
-#: debhelper.pod:47
-msgid ""
-"Many debhelper commands make use of files in F<debian/> to control what they "
-"do. Besides the common F<debian/changelog> and F<debian/control>, which are "
-"in all packages, not just those using debhelper, some additional files can "
-"be used to configure the behavior of specific debhelper commands. These "
-"files are typically named debian/package.foo (where \"package\" of course, "
-"is replaced with the package that is being acted on)."
+#. type: textblock
+#: dh_clean:5
+msgid "dh_clean - clean up package build directories"
msgstr ""
-# type: textblock
-#: debhelper.pod:54
+#. type: textblock
+#: dh_clean:14
msgid ""
-"For example, dh_installdocs uses files named debian/package.docs to list the "
-"documentation files it will install. See the man pages of individual "
-"commands for details about the names and formats of the files they use. "
-"Generally, these files will list files to act on, one file per line. Some "
-"programs in debhelper use pairs of files and destinations or slightly more "
-"complicated formats."
+"B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
+"[S<I<file ...>>]"
msgstr ""
-# type: textblock
-#: debhelper.pod:61
+#. type: verbatim
+#: dh_clean:18
+#, no-wrap
msgid ""
-"Note that if a package is the first (or only) binary package listed in "
-"debian/control, debhelper will use debian/foo if no debian/package.foo file "
-"can be found."
+"dh_clean is a debhelper program that is responsible for cleaning up after "
+"a\n"
+"package is built. It removes the package build directories, and removes "
+"some\n"
+"other files including debian/files, and any detritus left behind by other\n"
+"debhelper commands. It also removes common files that should not appear in "
+"a\n"
+"debian diff:\n"
+" #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS .deps/* *.P *-stamp\n"
+"\n"
msgstr ""
-# type: textblock
-#: debhelper.pod:65
-msgid ""
-"In some rare cases, you may want to have different versions of these files "
-"for different architectures. If files named debian/package.foo.arch exist, "
-"where \"arch\" is the same as the output of \"dpkg --print-architecture\", "
-"then they will be used in preference to other, more general files."
+#. type: textblock
+#: dh_clean:25
+msgid "The debian/clean file can list other files to be removed."
msgstr ""
-# type: textblock
-#: debhelper.pod:70
+#. type: textblock
+#: dh_clean:27
msgid ""
-"In many cases, these config files are used to specify various types of "
-"files. Documentation or example files to install, files to move, and so on. "
-"When appropriate, in cases like these, you can use standard shell wildcard "
-"characters ('?' and '*' and '[..]' character classes) in the files."
+"It does not run \"make clean\" to clean up after the build process. Use "
+"L<dh_auto_clean(1)> to do things like that."
msgstr ""
-# type: textblock
-#: debhelper.pod:75
+#. type: textblock
+#: dh_clean:30
msgid ""
-"You can also put comments in these files; lines beginning with \"#\" are "
-"ignored."
+"dh_clean (or \"dh clean\") should be the last debhelper command run in the "
+"clean target in debian/rules."
msgstr ""
-# type: =head1
-#: debhelper.pod:78
-msgid "SHARED DEBHELPER OPTIONS"
+#. type: =item
+#: dh_clean:37 dh_installchangelogs:48
+msgid "B<-k>, B<--keep>"
msgstr ""
-# type: textblock
-#: debhelper.pod:80
-msgid "The following command line options are supported by all debhelper programs."
+#. type: textblock
+#: dh_clean:39
+msgid "This is deprecated, use L<dh_prep(1)> instead."
msgstr ""
-# type: =item
-#: debhelper.pod:84
-msgid "B<-v>, B<--verbose>"
+#. type: =item
+#: dh_clean:41
+msgid "B<-d>, B<--dirs-only>"
msgstr ""
-# type: textblock
-#: debhelper.pod:86
-msgid "Verbose mode: show all commands that modify the package build directory."
+#. type: textblock
+#: dh_clean:43
+msgid ""
+"Only clean the package build directories, do not clean up any other files at "
+"all."
msgstr ""
-# type: =item
-#: debhelper.pod:88
-msgid "B<--no-act>"
+#. type: =item
+#: dh_clean:46
+msgid "B<-X>I<item> B<--exclude=>I<item>"
msgstr ""
-# type: textblock
-#: debhelper.pod:90
+#. type: textblock
+#: dh_clean:48
msgid ""
-"Do not really do anything. If used with -v, the result is that the command "
-"will output what it would have done."
-msgstr ""
-
-# type: =item
-#: debhelper.pod:93
-msgid "B<-a>, B<--arch>"
+"Exclude files that contain \"item\" anywhere in their filename from being "
+"deleted, even if they would normally be deleted. You may use this option "
+"multiple times to build up a list of things to exclude."
msgstr ""
-# type: textblock
-#: debhelper.pod:95
-msgid "Act on all architecture dependent packages."
+#. type: =item
+#: dh_clean:52 dh_compress:56 dh_installdocs:63 dh_installexamples:38 dh_installinfo:37 dh_installmanpages:44 dh_movefiles:49 dh_testdir:27
+msgid "I<file ...>"
msgstr ""
-# type: =item
-#: debhelper.pod:97
-msgid "B<-i>, B<--indep>"
+#. type: textblock
+#: dh_clean:54
+msgid "Delete these files too."
msgstr ""
-# type: textblock
-#: debhelper.pod:99
-msgid "Act on all architecture independent packages."
+#. type: textblock
+#: dh_compress:5
+msgid "dh_compress - compress files and fix symlinks in package build directories"
msgstr ""
-# type: =item
-#: debhelper.pod:101
-msgid "B<->I<ppackage>, B<--package=>I<package>"
+#. type: textblock
+#: dh_compress:15
+msgid ""
+"B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file "
+"...>>]"
msgstr ""
-# type: textblock
-#: debhelper.pod:103
+#. type: textblock
+#: dh_compress:19
msgid ""
-"Act on the package named \"package\". This option may be specified multiple "
-"times to make debhelper operate on a given set of packages."
+"dh_compress is a debhelper program that is responsible for compressing the "
+"files in package build directories, and makes sure that any symlinks that "
+"pointed to the files before they were compressed are updated to point to the "
+"new files."
msgstr ""
-# type: =item
-#: debhelper.pod:106
-msgid "B<-s>, B<--same-arch>"
+#. type: textblock
+#: dh_compress:24
+msgid ""
+"By default, dh_compress compresses files that debian policy mandates should "
+"be compressed, namely all files in usr/share/info, usr/share/man, "
+"usr/X11R6/man, files in usr/share/doc that are larger than 4k in size, "
+"(except the copyright file, .html and .css files, image files, and files "
+"that appear to be already compressed based on their extensions), and all "
+"changelog files. Plus PCF fonts underneath usr/X11R6/lib/X11/fonts/ and "
+"usr/share/fonts/X11/"
msgstr ""
-# type: textblock
-#: debhelper.pod:108
+#. type: textblock
+#: dh_compress:32
msgid ""
-"This is a smarter version of the -a flag, that is used in some rare "
-"circumstances. It understands that if the control file lists \"Architecture: "
-"i386\" for the package, the package should not be acted on on other "
-"architectures. So this flag makes the command act on all \"Architecture: "
-"any\" packages, as well as on any packages that have the current "
-"architecture explicitly specified. Contrast to the -a flag, which makes the "
-"command work on all packages that are not architecture independent."
+"If a debian/package.compress file exists, the default files are not "
+"compressed. Instead, the debian/packages.compress is ran as a shell script, "
+"and all filenames that the shell script outputs will be compressed. The "
+"shell script will be run from inside the package build directory. Note "
+"though that using -X is a much better idea in general; you should only use a "
+"debian/package.compress file if you really need to."
msgstr ""
-# type: =item
-#: debhelper.pod:116
-msgid "B<-N>I<package>, B<--no-package=>I<package>"
+#. type: textblock
+#: dh_compress:45
+msgid ""
+"Exclude files that contain \"item\" anywhere in their filename from being "
+"compressed. For example, -X.tiff will exclude tiff files from compression. "
+"You may use this option multiple times to build up a list of things to "
+"exclude. You can accomplish the same thing by using a debian/compress file, "
+"but this is easier."
msgstr ""
-# type: textblock
-#: debhelper.pod:118
+#. type: textblock
+#: dh_compress:53
msgid ""
-"Do not act on the specified package even if an -a, -i, or -p option lists "
-"the package as one that should be acted on."
+"Compress all files specified by command line parameters in ALL packages "
+"acted on."
msgstr ""
-# type: =item
-#: debhelper.pod:121
-msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
+#. type: textblock
+#: dh_compress:58
+msgid "Add these files to the list of files to compress."
msgstr ""
-# type: textblock
-#: debhelper.pod:123
-msgid "Use \"tmpdir\" for package build directory. The default is debian/<package>"
+#. type: =head1
+#: dh_compress:62 dh_perl:61 dh_python:66 dh_strip:74 dh_usrlocal:55
+msgid "CONFORMS TO"
msgstr ""
-# type: =item
-#: debhelper.pod:125
-msgid "B<--mainpackage=>I<package>"
+#. type: textblock
+#: dh_compress:64
+msgid "Debian policy, version 3.0"
msgstr ""
-# type: textblock
-#: debhelper.pod:127
-msgid ""
-"This little-used option changes the package which debhelper considers the "
-"\"main package\", that is, the first one listed in debian/control, and the "
-"one for which debian/foo files can be used instead of the usual "
-"debian/package.foo files."
+#. type: textblock
+#: dh_desktop:5
+msgid "dh_desktop - deprecated no-op"
msgstr ""
-# type: =head1
-#: debhelper.pod:134
-msgid "COMMON DEBHELPER OPTIONS"
+#. type: textblock
+#: dh_desktop:14
+msgid "B<dh_desktop> [S<I<debhelper options>>]"
msgstr ""
-# type: textblock
-#: debhelper.pod:136
+#. type: textblock
+#: dh_desktop:18
msgid ""
-"The following command line options are supported by some debhelper "
-"programs. See the man page of each program for a complete explanation of "
-"what each option does."
+"dh_desktop was a debhelper program that registers .desktop files. However, "
+"it no longer does anything, and is now deprecated."
msgstr ""
-# type: =item
-#: debhelper.pod:142
-msgid "B<-n>"
+#. type: textblock
+#: dh_desktop:29 dh_scrollkeeper:30
+msgid "L<debhelper>"
msgstr ""
-# type: textblock
-#: debhelper.pod:144
-msgid "Do not modify postinst/postrm/etc scripts."
+#. type: textblock
+#: dh_desktop:35 dh_scrollkeeper:36
+msgid "Ross Burton <ross@burtonini.com>"
msgstr ""
-# type: textblock
-#: debhelper.pod:148
-msgid ""
-"Exclude an item from processing. This option may be used multiple times, to "
-"exclude more than one thing."
+#. type: textblock
+#: dh_fixperms:5
+msgid "dh_fixperms - fix permissions of files in package build directories"
msgstr ""
-# type: textblock
-#: debhelper.pod:153
-msgid ""
-"Makes files or other items that are specified on the command line take "
-"effect in ALL packages acted on, not just the first."
+#. type: textblock
+#: dh_fixperms:14
+msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
msgstr ""
-# type: =head2
-#: debhelper.pod:160
-msgid "Multiple binary package support"
+#. type: textblock
+#: dh_fixperms:18
+msgid ""
+"dh_fixperms is a debhelper program that is responsible for setting the "
+"permissions of files and directories in package build directories to a sane "
+"state -- a state that complies with Debian policy."
msgstr ""
-# type: textblock
-#: debhelper.pod:162
+#. type: textblock
+#: dh_fixperms:22
msgid ""
-"If your source package generates more than one binary package, debhelper "
-"programs will default to acting on all binary packages when run. If your "
-"source package happens to generate one architecture dependent package, and "
-"another architecture independent package, this is not the correct behavior, "
-"because you need to generate the architecture dependent packages in the "
-"binary-arch debian/rules target, and the architecture independent packages "
-"in the binary-indep debian/rules target."
+"dh_fixperms makes all files in usr/share/doc in the package build directory "
+"(excluding files in the examples/ directory) be mode 644. It also changes "
+"the permissions of all man pages to mode 644. It makes all files be owned by "
+"root, and it removes group and other write permission from all files. It "
+"removes execute permissions from any libraries, headers, perl modules, or "
+"desktop files that have it set. It makes all files in the standard bin and "
+"sbin directories, usr/games/ and etc/init.d executable (since v4). Finally, "
+"it removes the setuid and setgid bits from all files in the package."
msgstr ""
-# type: textblock
-#: debhelper.pod:170
-msgid ""
-"To facilitate this, as well as give you more control over which packages are "
-"acted on by debhelper programs, all debhelper programs accept the B<-a>, "
-"B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If "
-"none are given, debhelper programs default to acting on all packages listed "
-"in the control file."
+#. type: =item
+#: dh_fixperms:35
+msgid "B<-X>I<item>, B<--exclude> I<item>"
msgstr ""
-# type: textblock
-#: debhelper.pod:176
+#. type: textblock
+#: dh_fixperms:37
msgid ""
-"See F</usr/share/doc/debhelper/examples/rules.multi> for an example of how "
-"to use this in a package that generates multiple binary packages."
+"Exclude files that contain \"item\" anywhere in their filename from having "
+"their permissions changed. You may use this option multiple times to build "
+"up a list of things to exclude."
msgstr ""
-# type: =head2
-#: debhelper.pod:179
-msgid "Automatic generation of debian install scripts"
+#. type: textblock
+#: dh_gconf:5
+msgid "dh_gconf - generate GConf schema registration scripts"
+msgstr ""
+
+#. type: textblock
+#: dh_gconf:14
+msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=<number>>]"
msgstr ""
-# type: textblock
-#: debhelper.pod:181
+#. type: textblock
+#: dh_gconf:18
msgid ""
-"Some debhelper commands will automatically generate parts of debian "
-"maintainer scripts. If you want these automatically generated things "
-"included in your existing debian maintainer scripts, then you need to add "
-"\"#DEBHELPER#\" to your scripts, in the place the code should be added. "
-"\"#DEBHELPER#\" will be replaced by any auto-generated code when you run "
-"dh_installdeb."
+"dh_gconf is a debhelper program that is responsible for registering GConf "
+"schemas."
msgstr ""
-# type: textblock
-#: debhelper.pod:188
+#. type: textblock
+#: dh_gconf:21
msgid ""
-"If a script does not exist at all and debhelper needs to add something to "
-"it, then debhelper will create the complete script."
+"It automatically generates the postinst and prerm fragments needed to "
+"register and unregister the schemas in usr/share/gconf/schemas, using "
+"gconf-schemas."
msgstr ""
-# type: textblock
-#: debhelper.pod:191
+#. type: textblock
+#: dh_gconf:25
msgid ""
-"All debhelper commands that automatically generate code in this way let it "
-"be disabled by the -n parameter (see above)."
+"If a file named debian/package.gconf-defaults exists, then it is installed "
+"into usr/share/gconf/defaults/10_package in the package build directory, "
+"with \"package\" replaced by the package name. Some postinst and postrm "
+"fragments will be generated to launch update-gconf-defaults."
msgstr ""
-# type: textblock
-#: debhelper.pod:194
+#. type: textblock
+#: dh_gconf:30
msgid ""
-"Note that the inserted code will be shell code, so you cannot directly use "
-"it in a perl script. If you would like to embed it into a perl script, here "
-"is one way to do that (note that I made sure that $1, $2, etc are set with "
-"the set command):"
+"If a file named debian/package.gconf-mandatory exists, then it is installed "
+"into usr/share/gconf/mandatory/10_package in the package build directory, "
+"with \"package\" replaced by the package name, and similar postinst and "
+"postrm fragments will be generated."
msgstr ""
-# type: verbatim
-#: debhelper.pod:199
-#, no-wrap
+#. type: textblock
+#: dh_gconf:35
msgid ""
-" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n"
-" #DEBHELPER#\n"
-" EOF\n"
-" system ($temp) / 256 == 0\n"
-" \tor die \"Problem with debhelper scripts: $!\";\n"
-"\n"
+"The gconf-schemas and update-gconf-defaults scripts are provided by the "
+"gconf2 package. An appropriate dependency will be generated in "
+"${misc:Depends}."
msgstr ""
-# type: =head2
-#: debhelper.pod:205
-msgid "Automatic generation of miscellaneous dependencies."
+#. type: =item
+#: dh_gconf:43
+msgid "B<--priority> I<priority>"
msgstr ""
-# type: textblock
-#: debhelper.pod:207
+#. type: textblock
+#: dh_gconf:45
msgid ""
-"Some debhelper commands may make the generated package need to depend on "
-"some other packages. For example, if you use L<dh_installdebconf(1)>, your "
-"package will generally need to depend on debconf. Or if you use "
-"L<dh_installxfonts(1)>, your package will generally need to depend on a "
-"particular version of xutils. Keeping track of these miscellaneous "
-"dependencies can be annoying since they are dependant on how debhelper does "
-"things, so debhelper offers a way to automate it."
+"Use I<priority> (which should be a 2-digit number) as the defaults priority "
+"instead of 10. Higher values than ten can be used by derived distributions "
+"(20), CDD distributions (50), or site-specific packages (90)."
msgstr ""
-# type: textblock
-#: debhelper.pod:215
-msgid ""
-"All commands of this type, besides documenting what dependencies may be "
-"needed on their man pages, will automatically generate a substvar called "
-"${misc:Depends}. If you put that token into your debian/control file, it "
-"will be expanded to the dependencies debhelper figures you need."
+#. type: textblock
+#: dh_gconf:112
+msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>"
msgstr ""
-# type: textblock
-#: debhelper.pod:220
-msgid ""
-"This is entirely independent of the standard ${shlibs:Depends} generated by "
-"L<dh_makeshlibs(1)>, and the ${perl:Depends} generated by L<dh_perl(1)>. "
-"You can choose not to use any of these, if debhelper's guesses don't match "
-"reality."
+#. type: textblock
+#: dh_gencontrol:5
+msgid "dh_gencontrol - generate and install control file"
msgstr ""
-# type: =head2
-#: debhelper.pod:225
-msgid "Package build directories"
+#. type: textblock
+#: dh_gencontrol:14
+msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
msgstr ""
-# type: textblock
-#: debhelper.pod:227
+#. type: textblock
+#: dh_gencontrol:18
msgid ""
-"By default, all debhelper programs assume that the temporary directory used "
-"for assembling the tree of files in a package is debian/<package>."
+"dh_gencontrol is a debhelper program that is responsible for generating "
+"control files, and installing them into the DEBIAN directory with the proper "
+"permissions."
msgstr ""
-# type: textblock
-#: debhelper.pod:230
+#. type: textblock
+#: dh_gencontrol:22
msgid ""
-"Sometimes, you might want to use some other temporary directory. This is "
-"supported by the -P flag. For example, \"dh_installdocs -Pdebian/tmp\", will "
-"use debian/tmp as the temporary directory. Note that if you use -P, the "
-"debhelper programs can only be acting on a single package at a time. So if "
-"you have a package that builds many binary packages, you will need to also "
-"use the -p flag to specify which binary package the debhelper program will "
-"act on."
+"This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
+"it once for each package being acted on, and passes in some additional "
+"useful flags."
msgstr ""
-# type: =head2
-#: debhelper.pod:238
-msgid "Debhelper compatibility levels"
+#. type: =item
+#: dh_gencontrol:30
+msgid "B<-u>I<params>, B<--dpkg-gencontrol-params>=I<params>"
msgstr ""
-# type: textblock
-#: debhelper.pod:240
-msgid ""
-"From time to time, major non-backwards-compatible changes need to be made to "
-"debhelper, to keep it clean and well-designed as needs change and its author "
-"gains more experience. To prevent such major changes from breaking existing "
-"packages, the concept of debhelper compatibility levels was introduced. You "
-"tell debhelper which compatibility level it should use, and it modifies its "
-"behavior in various ways."
+#. type: textblock
+#: dh_gencontrol:34
+msgid "Pass \"params\" to L<dpkg-gencontrol(1)>."
msgstr ""
-# type: textblock
-#: debhelper.pod:247
-msgid ""
-"Tell debhelper what compatibility level to use by writing a number to "
-"debian/compat. For example, to turn on V5 mode:"
+#. type: textblock
+#: dh_installcatalogs:5
+msgid "dh_installcatalogs - install and register SGML Catalogs"
msgstr ""
-# type: verbatim
-#: debhelper.pod:250
-#, no-wrap
+#. type: textblock
+#: dh_installcatalogs:16
+msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
+msgstr ""
+
+#. type: textblock
+#: dh_installcatalogs:20
msgid ""
-" % echo 5 > debian/compat\n"
-"\n"
+"dh_installcatalogs is a debhelper program that installs and registers SGML "
+"catalogs. It complies with the Debian XML/SGML policy."
msgstr ""
-# type: textblock
-#: debhelper.pod:252
+#. type: textblock
+#: dh_installcatalogs:23
msgid ""
-"Unless otherwise indicated, all debhelper documentation assumes that you are "
-"using the most recent compatibility level, and in most cases does not "
-"indicate if the behavior is different in an earlier compatibility level, so "
-"if you are not using the most recent compatibility level, you're advised to "
-"read below for notes about what is different in earlier compatibility "
-"levels."
+"The file F<debian/I<package>.sgmlcatalogs> contains the catalogs to be "
+"installed per package. Each line in that file should be of the form "
+"C<source dest>, where C<source> indicates where the catalog resides in the "
+"source tree, and C<dest> indicates the destination location for the catalog "
+"under the package build area. C<dest> should start with "
+"F</usr/share/sgml/>."
msgstr ""
-# type: textblock
-#: debhelper.pod:259
-msgid "These are the available compatibility levels:"
+#. type: textblock
+#: dh_installcatalogs:30
+msgid ""
+"Catalogs will be registered in a supercatalog, in "
+"F</etc/sgml/I<package>.cat>."
msgstr ""
-# type: =item
-#: debhelper.pod:263
-msgid "V1"
+#. type: textblock
+#: dh_installcatalogs:33
+msgid ""
+"This command automatically adds maintainer script snippets for registering "
+"and unregistering the catalogs and \"supercatalogs\" (unless B<-n> is "
+"used). These snippets are inserted into the maintainer scripts by "
+"dh_installdeb; see L<dh_installdeb(1)> for an explanation of Debhelper "
+"maintainer script snippets."
msgstr ""
-# type: textblock
-#: debhelper.pod:265
+#. type: textblock
+#: dh_installcatalogs:39
msgid ""
-"This is the original debhelper compatibility level, and so it is the default "
-"one. In this mode, debhelper will use debian/tmp as the package tree "
-"directory for the first binary package listed in the control file, while "
-"using debian/<package> for all other packages listed in the control file."
+"A dependency on B<sgml-base> will be added to C<${misc:Depends}>, so be sure "
+"your package uses that variable in F<debian/control>."
msgstr ""
-# type: textblock
-#: debhelper.pod:270 debhelper.pod:277 debhelper.pod:300
-msgid "This mode is deprecated."
+#. type: =item
+#: dh_installcatalogs:46 dh_installdebconf:54 dh_installemacsen:39 dh_installinit:37 dh_installmenu:38 dh_installmime:35 dh_installmodules:47 dh_installwm:42 dh_makeshlibs:62 dh_python:60 dh_usrlocal:43
+msgid "B<-n>, B<--noscripts>"
msgstr ""
-# type: =item
-#: debhelper.pod:272
-msgid "V2"
+#. type: textblock
+#: dh_installcatalogs:48
+msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
msgstr ""
-# type: textblock
-#: debhelper.pod:274
+#. type: textblock
+#: dh_installcatalogs:54 dh_installdocs:87 dh_installemacsen:56 dh_installinit:112 dh_installmime:43 dh_installmodules:62 dh_installwm:55 dh_usrlocal:51
msgid ""
-"In this mode, debhelper will consistently use debian/<package> as the "
-"package tree directory for every package that is built."
+"Note that this command is not idempotent. L<dh_prep(1)> should be called "
+"between invocations of this command. Otherwise, it may cause multiple "
+"instances of the same text to be added to maintainer scripts."
msgstr ""
-# type: =item
-#: debhelper.pod:279
-msgid "V3"
+#. type: textblock
+#: dh_installcatalogs:113
+msgid "F</usr/share/doc/sgml-base-doc/>"
msgstr ""
-# type: textblock
-#: debhelper.pod:281
-msgid "This mode works like V2, with the following additions:"
+#. type: textblock
+#: dh_installcatalogs:117
+msgid "Adam Di Carlo <aph@debian.org>"
msgstr ""
-# type: =item
-#: debhelper.pod:285 debhelper.pod:290 debhelper.pod:294 debhelper.pod:308 debhelper.pod:313 debhelper.pod:318 debhelper.pod:323 debhelper.pod:336 debhelper.pod:340 debhelper.pod:345 debhelper.pod:349
-msgid "-"
+#. type: textblock
+#: dh_installchangelogs:5
+msgid "dh_installchangelogs - install changelogs into package build directories"
msgstr ""
-# type: textblock
-#: debhelper.pod:287
+#. type: textblock
+#: dh_installchangelogs:14
msgid ""
-"Debhelper config files support globbing via * and ?, when appropriate. To "
-"turn this off and use those characters raw, just prefix with a backslash."
-msgstr ""
-
-# type: textblock
-#: debhelper.pod:292
-msgid "dh_makeshlibs makes the postinst and postrm scripts call ldconfig."
+"B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] "
+"[I<upstream>]"
msgstr ""
-# type: textblock
-#: debhelper.pod:296
-msgid "Every file in etc/ is automatically flagged as a conffile by dh_installdeb."
+#. type: textblock
+#: dh_installchangelogs:18
+msgid ""
+"dh_installchangelogs is a debhelper program that is responsible for "
+"installing changelogs into package build directories."
msgstr ""
-# type: =item
-#: debhelper.pod:302
-msgid "V4"
+#. type: textblock
+#: dh_installchangelogs:21
+msgid ""
+"dh_installchangelogs determines if the package is a debian native package, "
+"and if so, it installs debian/changelog into usr/share/doc/package/changelog "
+"in the package build directory. Otherwise, it installs debian/changelog into "
+"usr/share/doc/package/changelog.Debian in the package build directory. (If "
+"files named debian/package.changelog exist, they will be used in preference "
+"to debian/changelog.)"
msgstr ""
-# type: textblock
-#: debhelper.pod:304
-msgid "Changes from V3 are:"
+#. type: textblock
+#: dh_installchangelogs:28
+msgid ""
+"Parallelling the debian changelog handling, this program also takes care of "
+"NEWS.Debian files. If there is a debian/NEWS file, it is installed as "
+"usr/share/doc/package/NEWS.Debian. debian/package.NEWS files can also be "
+"used."
msgstr ""
-# type: textblock
-#: debhelper.pod:310
+#. type: textblock
+#: dh_installchangelogs:33
msgid ""
-"dh_makeshlibs -V will not include the debian part of the version number in "
-"the generated dependency line in the shlibs file."
+"An upstream changelog file may be specified as an option. If none is "
+"specified, a few common filenames are tried. (In compatibility level 7 and "
+"above.)"
msgstr ""
-# type: textblock
-#: debhelper.pod:315
+#. type: textblock
+#: dh_installchangelogs:37
msgid ""
-"You are encouraged to put the new ${misc:Depends} into debian/control to "
-"supplement the ${shlibs:Depends} field."
+"If there is an upstream changelog file, it will be be installed as "
+"usr/share/doc/package/changelog in the package build directory. If the "
+"changelog is a html file (determined by file extension), it will be "
+"installed as usr/share/doc/package/changelog.html instead, and will be "
+"converted to plain text with html2text to generate "
+"usr/share/doc/package/changelog."
msgstr ""
-# type: textblock
-#: debhelper.pod:320
+#. type: textblock
+#: dh_installchangelogs:50
msgid ""
-"dh_fixperms will make all files in bin/ directories and in etc/init.d "
-"executable."
+"Keep the original name of the upstream changelog. This will be accomplished "
+"by installing the upstream changelog as \"changelog\", and making a symlink "
+"from that to the original name of the changelog file. This can be useful if "
+"the upstream changelog has an unusual name, or if other documentation in the "
+"package refers to the changelog file."
msgstr ""
-# type: textblock
-#: debhelper.pod:325
-msgid "dh_link will correct existing links to conform with policy."
+#. type: =item
+#: dh_installchangelogs:56 dh_installdocs:58 dh_installexamples:43 dh_install:69 dh_link:57 dh_movefiles:44
+msgid "B<-Xitem>, B<--exclude=item>"
msgstr ""
-# type: =item
-#: debhelper.pod:329
-msgid "V5"
+#. type: textblock
+#: dh_installchangelogs:58
+msgid ""
+"Exclude upstream changelog files that contain \"item\" anywhere in their "
+"filename from being installed."
msgstr ""
-# type: textblock
-#: debhelper.pod:331
-msgid "This is the recommended mode of operation. It does everything V4 does, plus:"
+#. type: =item
+#: dh_installchangelogs:61
+msgid "I<upstream>"
msgstr ""
-# type: textblock
-#: debhelper.pod:338
-msgid "Comments are ignored in debhelper config files."
+#. type: textblock
+#: dh_installchangelogs:63
+msgid "Install this file as the upstream changelog."
msgstr ""
-# type: textblock
-#: debhelper.pod:342
-msgid ""
-"dh_strip --dbg-package now specifies the name of a package to put debugging "
-"symbols in, not the packages to take the symbols from."
+#. type: textblock
+#: dh_installcron:5
+msgid "dh_installcron - install cron scripts into etc/cron.*"
msgstr ""
-# type: textblock
-#: debhelper.pod:347
-msgid "dh_installdocs skips installing empty files."
+#. type: textblock
+#: dh_installcron:14
+msgid "B<dh_installcron> [S<B<debhelper options>>] [B<--name=>I<name>]"
msgstr ""
-# type: textblock
-#: debhelper.pod:351
-msgid "dh_install errors out if wildcards expand to nothing."
+#. type: textblock
+#: dh_installcron:18
+msgid ""
+"dh_installcron is a debhelper program that is responsible for installing "
+"cron scripts into etc/cron.*/ in package build directories. The files "
+"debian/package.cron.daily, debian/package.cron.weekly, "
+"debian/package.cron.monthly, debian/package.cron.hourly, and "
+"debian/package.cron.d are installed."
msgstr ""
-# type: =head2
-#: debhelper.pod:357
-msgid "Doc directory symlinks"
+#. type: =item
+#: dh_installcron:28 dh_installinit:83 dh_installlogrotate:26 dh_installmodules:51 dh_installpam:28 dh_installppp:30
+msgid "B<--name=>I<name>"
msgstr ""
-# type: textblock
-#: debhelper.pod:359
+#. type: textblock
+#: dh_installcron:30
msgid ""
-"Sometimes it is useful to make a package not contain a "
-"/usr/share/doc/package directory at all, instead placing just a dangling "
-"symlink in the binary package, that points to some other doc "
-"directory. Policy says this is ok if your package depends on the package "
-"whose doc directory it uses. To accomplish this, just don't tell debhelper "
-"to install any documentation files into the package, and use dh_link to set "
-"up the symlink (or do it by hand), and debhelper should do the right thing: "
-"notice it is a dangling symlink and not try to install a copyright file or "
-"changelog."
+"Look for files named debian/package.name.cron.* and install them as "
+"etc/cron.*/name, instead of using the usual files and installing them as the "
+"package name."
msgstr ""
-# type: =head2
-#: debhelper.pod:368
-msgid "udebs"
+#. type: textblock
+#: dh_installdebconf:5
+msgid ""
+"dh_installdebconf - install files used by debconf in package build "
+"directories"
msgstr ""
-# type: textblock
-#: debhelper.pod:370
-msgid ""
-"Debhelper includes support for udebs. To create a udeb with debhelper, add "
-"\"XC-Package-Type: udeb\" to the package's stanza in debian/control, and "
-"build-depend on debhelper (>= 4.2). Debhelper will try to create udebs that "
-"comply with debian-installer policy, by making the generated package files "
-"end in \".udeb\", not installing any documentation into a udeb, skipping "
-"over preinst, postrm, prerm, and config scripts, etc."
+#. type: textblock
+#: dh_installdebconf:14
+msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
msgstr ""
-# type: =head2
-#: debhelper.pod:377
-msgid "Other notes"
+#. type: textblock
+#: dh_installdebconf:18
+msgid ""
+"dh_installdebconf is a debhelper program that is responsible for installing "
+"files used by the debconf package into package build directories."
msgstr ""
-# type: textblock
-#: debhelper.pod:379
+#. type: textblock
+#: dh_installdebconf:21
msgid ""
-"In general, if any debhelper program needs a directory to exist under "
-"debian/, it will create it. I haven't bothered to document this in all the "
-"man pages, but for example, dh_installdeb knows to make "
-"debian/<package>/DEBIAN/ before trying to put files there, dh_installmenu "
-"knows you need a debian/<package>/usr/share/menu/ before installing the menu "
-"files, etc."
+"It also automatically generates the postrm commands needed to interface with "
+"debconf. The commands are added to the maintainer scripts by "
+"dh_installdeb. See L<dh_installdeb(1)> for an explanation of how that works."
msgstr ""
-# type: textblock
-#: debhelper.pod:385
+#. type: textblock
+#: dh_installdebconf:26
msgid ""
-"Once your package uses debhelper to build, be sure to add debhelper to your "
-"Build-Depends line in debian/control. You should build-depend on a version "
-"of debhelper equal to (or greater than) the debhelper compatibility level "
-"your package uses. So if your package used compatibility level 5:"
+"Files named debian/package.config and debian/package.templates are installed "
+"into the DEBIAN directory in the package build directory. If a file named "
+"debian/package.config.debhelper exists, the contents of that file are merged "
+"into the config script as follows: If the script exists, then anywhere in it "
+"that \"#DEBHELPER#\" appears, the text of the .debhelper file is "
+"inserted. If the script does not exist, then a script is generated from the "
+".debhelper file. The .debhelper files may be created by other debhelper "
+"programs, and are shell script fragments."
msgstr ""
-# type: verbatim
-#: debhelper.pod:391
-#, no-wrap
+#. type: textblock
+#: dh_installdebconf:35
msgid ""
-" Build-Depends: debhelper (>= 5)\n"
-"\n"
+"Note that if you use debconf, your package probably needs to depend on it "
+"(it will be added to ${misc:Depends} by this program)."
msgstr ""
-# type: =head1
-#: debhelper.pod:393
-msgid "ENVIRONMENT"
+#. type: textblock
+#: dh_installdebconf:38
+msgid ""
+"Note that for your config script to be called by dpkg, your postinst needs "
+"to source debconf's confmodule. dh_installdebconf does not install this "
+"statement into postinst automatically as it it too hard to do it right."
msgstr ""
-# type: =item
-#: debhelper.pod:397
-msgid "DH_VERBOSE"
+#. type: =head1
+#: dh_installdebconf:43
+msgid "LOCALIZED TEMPLATE FILES"
msgstr ""
-# type: textblock
-#: debhelper.pod:399
+#. type: textblock
+#: dh_installdebconf:45
msgid ""
-"Set to 1 to enable verbose mode. Debhelper will output every command it runs "
-"that modifies files on the build system."
+"This program will look to see if you have a debian/po directory and if so "
+"will automatically call L<po2debconf(1)> to generate a merged templates file "
+"containing the translations. For this to work, your package should "
+"build-depend on po-debconf."
msgstr ""
-# type: =item
-#: debhelper.pod:402
-msgid "DH_COMPAT"
+#. type: textblock
+#: dh_installdebconf:56
+msgid "Do not modify postrm script."
msgstr ""
-# type: textblock
-#: debhelper.pod:404
-msgid ""
-"Temporarily specifies what compatibility level debhelper should run at, "
-"overriding any value in debian/compat."
+#. type: textblock
+#: dh_installdebconf:60
+msgid "Pass the params to po2debconf."
msgstr ""
-# type: =item
-#: debhelper.pod:407
-msgid "DH_NO_ACT"
+#. type: textblock
+#: dh_installdeb:5
+msgid "dh_installdeb - install files into the DEBIAN directory"
msgstr ""
-# type: textblock
-#: debhelper.pod:409
-msgid "Set to 1 to enable no-act mode."
+#. type: textblock
+#: dh_installdeb:14
+msgid "B<dh_installdeb> [S<I<debhelper options>>]"
msgstr ""
-# type: =item
-#: debhelper.pod:411
-msgid "DH_OPTIONS"
+#. type: textblock
+#: dh_installdeb:18
+msgid ""
+"dh_installdeb is a debhelper program that is responsible for installing "
+"files into the DEBIAN directories in package build directories with the "
+"correct permissions."
msgstr ""
-# type: textblock
-#: debhelper.pod:413
+#. type: verbatim
+#: dh_installdeb:22
+#, no-wrap
msgid ""
-"Anything in this variable will be prepended to the command line arguments of "
-"all debhelper commands. This is useful in some situations, for example, if "
-"you need to pass -p to all debhelper commands that will be run. One good way "
-"to set DH_OPTIONS is by using \"Target-specific Variable Values\" in your "
-"debian/rules file. See the make documentation for details on doing this."
+"dh_installdeb automatically installs the following files from debian/ into\n"
+"the DEBIAN directory:\n"
+" package.postinst\n"
+" package.preinst\n"
+" package.postrm\n"
+" package.prerm\n"
+" package.shlibs\n"
+" package.conffiles\n"
+" package.triggers\n"
+"\n"
msgstr ""
-# type: =item
-#: debhelper.pod:419
-msgid "DH_ALWAYS_EXCLUDE"
+#. type: textblock
+#: dh_installdeb:32
+msgid ""
+"The postinst, preinst, postrm, and prerm are handled specially: If a "
+"corresponding file named debian/package.script.debhelper exists, the "
+"contents of that file are merged into the script as follows: If the script "
+"exists, then anywhere in it that \"#DEBHELPER#\" appears, the text of the "
+".debhelper file is inserted. If the script does not exist, then a script is "
+"generated from the .debhelper file. The .debhelper files are created by "
+"other debhelper programs, such as L<dh_installmenu(1)>, and are shell script "
+"fragments."
msgstr ""
-# type: textblock
-#: debhelper.pod:421
+#. type: textblock
+#: dh_installdeb:40
msgid ""
-"If set, this adds the value the variable is set to to the -X options of all "
-"commands that support the -X option. Moreover, dh_builddeb will rm -rf "
-"anything that matches the value in your package build tree."
+"In V3 compatibility mode and higher, all files in the etc/ directory in a "
+"package will automatically be flagged as conffiles by this program, so there "
+"is no need to list them manually in package.conffiles."
msgstr ""
-# type: textblock
-#: debhelper.pod:425
-msgid ""
-"This can be useful if you are doing a build from a CVS source tree, in which "
-"case setting DH_ALWAYS_EXCLUDE=CVS will prevent any CVS directories from "
-"sneaking into the package you build. Or, if a package has a source tarball "
-"that (unwisely) includes CVS directories, you might want to export "
-"DH_ALWAYS_EXCLUDE=CVS in debian/rules, to make it take effect wherever your "
-"package is built."
+#. type: textblock
+#: dh_installdirs:5
+msgid "dh_installdirs - create subdirectories in package build directories"
msgstr ""
-# type: textblock
-#: debhelper.pod:432
-msgid ""
-"Multiple things to exclude can be separated with colons, as in "
-"DH_ALWAYS_EXCLUDE=CVS:.svn"
+#. type: textblock
+#: dh_installdirs:14
+msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir ...>>]"
msgstr ""
-# type: =item
-#: debhelper.pod:441
-msgid "F</usr/share/doc/debhelper/examples/>"
+#. type: textblock
+#: dh_installdirs:18
+msgid ""
+"dh_installdirs is a debhelper program that is responsible for creating "
+"subdirectories in package build directories."
msgstr ""
-# type: textblock
-#: debhelper.pod:443
-msgid "A set of example debian/rules files that use debhelper."
+#. type: textblock
+#: dh_installdirs:21
+msgid "A file named debian/package.dirs can list directories to be created."
msgstr ""
-# type: =item
-#: debhelper.pod:445
-msgid "L<http://kitenet.net/programs/debhelper/>"
+#. type: textblock
+#: dh_installdirs:23
+msgid ""
+"Any directory names specified as parameters will be created in the package "
+"build directory of the first package dh_installdirs is told to act on. By "
+"default, this is the first binary package in debian/control, but if you use "
+"-p, -i, or -a flags, it will be the first package specified by those flags."
msgstr ""
-# type: textblock
-#: debhelper.pod:447
-msgid "Debhelper web site."
+#. type: textblock
+#: dh_installdirs:34
+msgid ""
+"Create any directories specified by command line parameters in ALL packages "
+"acted on, not just the first."
msgstr ""
-# type: textblock
-#: dh_clean:5
-msgid "dh_clean - clean up package build directories"
+#. type: =item
+#: dh_installdirs:37
+msgid "I<dir ...>"
msgstr ""
-# type: textblock
-#: dh_clean:14
+#. type: textblock
+#: dh_installdirs:39
msgid ""
-"B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] "
-"[S<I<file ...>>]"
+"Create these directories in the package build directory of the first package "
+"acted on. (Or in all packages if -A is specified.)"
msgstr ""
-# type: verbatim
-#: dh_clean:18
-#, no-wrap
+#. type: textblock
+#: dh_installdocs:5
+msgid "dh_installdocs - install documentation into package build directories"
+msgstr ""
+
+#. type: textblock
+#: dh_installdocs:14
msgid ""
-"dh_clean is a debhelper program that is responsible for cleaning up after "
-"a\n"
-"package is built. It removes the package build directories, and removes "
-"some\n"
-"other files including debian/files, and any detritus left behind by other\n"
-"debhelper commands. It also removes common files that should not appear in "
-"a\n"
-"debian diff:\n"
-" #*# *~ DEADJOE *.orig *.rej *.SUMS TAGS core .deps/* *.P\n"
-"\n"
+"B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<file "
+"...>>]"
msgstr ""
-# type: =item
-#: dh_clean:29 dh_installchangelogs:44
-msgid "B<-k>, B<--keep>"
+#. type: textblock
+#: dh_installdocs:18
+msgid ""
+"dh_installdocs is a debhelper program that is responsible for installing "
+"documentation into usr/share/doc/package in package build directories."
msgstr ""
-# type: textblock
-#: dh_clean:31
+#. type: textblock
+#: dh_installdocs:21
msgid ""
-"Do not delete debian/files. When do you want to use this? Anytime you have a "
-"debian/rules that has 2 binary targets that build different .deb packages; "
-"for example, one target is binary-arch, and the other is binary-indep, or "
-"one target builds the shared library, and the other the -dev package. If you "
-"didn't use -k in these cases, then debian/files would be deleted in the "
-"middle, and your changes file will only contain the last binary package that "
-"was built."
+"dh_installdocs automatically installs debian/copyright if it exists. If "
+"dh_installdocs is acting on multiple packages, debian/copyright files will "
+"be installed into all packages. However, if you need to have separate "
+"copyright files for different binary packages, you can use files named "
+"debian/package.copyright."
msgstr ""
-# type: =item
-#: dh_clean:39
-msgid "B<-d>, B<--dirs-only>"
+#. type: textblock
+#: dh_installdocs:27
+msgid ""
+"Any filenames specified as parameters will be installed into the first "
+"package dh_installdocs is told to act on. By default, this is the first "
+"binary package in debian/control, but if you use B<-p>, B<-i>, or B<-a> "
+"flags, it will be the first package specified by those flags."
msgstr ""
-# type: textblock
-#: dh_clean:41
+#. type: textblock
+#: dh_installdocs:32
msgid ""
-"Only clean the package build directories, do not clean up any other files at "
-"all."
+"Also, debian/README.Debian (or debian/README.debian) and debian/TODO, if "
+"they exist, will be installed into the first binary package listed in "
+"debian/control, if dh_installdocs is acting on that package. Note that "
+"debian/TODO will be installed named TODO.Debian, if the package is not a "
+"debian native package. Also note that README.debian is installed as "
+"README.Debian, for consistency. Note that debian/package.README.Debian and "
+"debian/package.TODO can be used to specify files for subpackages."
msgstr ""
-# type: =item
-#: dh_clean:44
-msgid "B<-X>I<item> B<--exclude=>I<item>"
+#. type: textblock
+#: dh_installdocs:40
+msgid "Files named debian/package.docs can list other files to be installed."
msgstr ""
-# type: textblock
-#: dh_clean:46
+#. type: textblock
+#: dh_installdocs:42
msgid ""
-"Exclude files that contain \"item\" anywhere in their filename from being "
-"deleted, even if they would normally be deleted. You may use this option "
-"multiple times to build up a list of things to exclude."
+"Files named debian/package.doc-base, will be installed as doc-base control "
+"files. Note that the doc-id will be determined from the \"Document:\" entry "
+"in the doc-base control file in question."
msgstr ""
-# type: textblock
-#: dh_clean:52
-msgid "Delete these files too."
+#. type: textblock
+#: dh_installdocs:46
+msgid ""
+"If your package needs to register more than one document, you need multiple "
+"files. To accomplish this, you can use files named debian/package.doc-base.*"
msgstr ""
-# type: textblock
-#: dh_undocumented:5
-msgid "dh_undocumented - obsolete undocumented.7 symlink program"
+#. type: textblock
+#: dh_installdocs:55 dh_installinfo:34 dh_installman:64
+msgid ""
+"Install all files specified by command line parameters in ALL packages acted "
+"on."
msgstr ""
-# type: textblock
-#: dh_undocumented:14 dh_suidregister:9
-msgid "Do not run!"
+#. type: textblock
+#: dh_installdocs:60
+msgid ""
+"Exclude files that contain \"item\" anywhere in their filename from being "
+"installed. Note that this includes doc-base files."
msgstr ""
-# type: textblock
-#: dh_undocumented:18
+#. type: textblock
+#: dh_installdocs:65
msgid ""
-"This program used to make symlinks to the undocumented.7 man page for man "
-"pages not present in a package. Debian policy now frowns on use of the "
-"undocumented.7 man page, and so this program does nothing, and should not be "
-"used."
+"Install these files as documentation into the first package acted on. (Or in "
+"all packages if B<-A> is specified)."
msgstr ""
-# type: textblock
-#: dh_testversion:5
-msgid "dh_testversion - ensure that the correct version of debhelper is installed"
+#. type: =head1
+#: dh_installdocs:70 dh_link:70 dh_makeshlibs:82 dh_shlibdeps:66
+msgid "EXAMPLES"
msgstr ""
-# type: textblock
-#: dh_testversion:14
-msgid "B<dh_testversion> [S<I<debhelper options>>] [I<operator>] [I<version>]"
+#. type: textblock
+#: dh_installdocs:72
+msgid "This is an example of a debian/package.docs file:"
msgstr ""
-# type: textblock
-#: dh_testversion:18
-msgid "Note: This program is deprecated. You should use build dependencies instead."
+#. type: verbatim
+#: dh_installdocs:74
+#, no-wrap
+msgid ""
+" README\n"
+" TODO\n"
+" debian/notes-for-maintainers.txt\n"
+" docs/manual.txt\n"
+" docs/manual.pdf\n"
+" docs/manual-html/\n"
+"\n"
msgstr ""
-# type: textblock
-#: dh_testversion:21
+#. type: textblock
+#: dh_installdocs:83
msgid ""
-"dh_testversion compares the version of debhelper against the version you "
-"specify, and if the condition is not met, exits with an error message."
+"Note that dh_installdocs will happily copy entire directory hierarchies if "
+"you ask it to (similar to cp -a). If it is asked to install a directory, it "
+"will install the complete contents of the directory."
msgstr ""
-# type: textblock
-#: dh_testversion:24
-msgid ""
-"You can use this in your debian/rules files if a new debhelper feature is "
-"introduced, and your package requires that feature to build correctly. Use "
-"debhelper's changelog to figure out the version you need."
+#. type: textblock
+#: dh_installemacsen:5
+msgid "dh_installemacsen - register an emacs add on package"
msgstr ""
-# type: textblock
-#: dh_testversion:28
+#. type: textblock
+#: dh_installemacsen:14
msgid ""
-"Be sure not to overuse dh_testversion. If debhelper version 9.5 introduces a "
-"new dh_autofixbugs command, and your package uses it, then if someone tries "
-"to build it with debhelper 1.0, the build will fail anyway when "
-"dh_autofixbugs cannot be found, so there is no need for you to use "
-"dh_testversion."
+"B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
+"[B<--flavor=>I<foo>]"
msgstr ""
-# type: =item
-#: dh_testversion:38
-msgid "I<operator>"
+#. type: textblock
+#: dh_installemacsen:18
+msgid ""
+"dh_installemacsen is a debhelper program that is responsible for installing "
+"files used by the debian emacsen-common package into package build "
+"directories."
msgstr ""
-# type: textblock
-#: dh_testversion:40
+#. type: textblock
+#: dh_installemacsen:22
msgid ""
-"Optional comparison operator used in comparing the versions. If not "
-"specified, \">=\" is used. For descriptions of the comparison operators, see "
-"dpkg --help."
+"It also automatically generates the postinst and prerm commands needed to "
+"register a package as an emacs add on package. The commands are added to the "
+"maintainer scripts by dh_installdeb. See L<dh_installdeb(1)> for an "
+"explanation of how this works."
msgstr ""
-# type: =item
-#: dh_testversion:44
-msgid "I<version>"
+#. type: textblock
+#: dh_installemacsen:27
+msgid ""
+"If a file named debian/package.emacsen-install exists, then it is installed "
+"into usr/lib/emacsen-common/packages/install/package in the package build "
+"directory. Similarly, debian/package.emacsen-remove is installed into "
+"usr/lib/emacsen-common/packages/remove/package . And similarly, "
+"debian/package.emacsen-startup is installed into "
+"etc/emacs/site-start.d/50<package>.el (by default)."
msgstr ""
-# type: textblock
-#: dh_testversion:46
-msgid ""
-"Version number to compare against the current version of debhelper. If not "
-"specified, dh_testversion does nothing."
+#. type: textblock
+#: dh_installemacsen:41
+msgid "Do not modify postinst/prerm scripts."
msgstr ""
-# type: textblock
-#: dh_testdir:5
-msgid "dh_testdir - test directory before building debian package"
+#. type: =item
+#: dh_installemacsen:43 dh_installwm:36
+msgid "B<--priority=>I<n>"
msgstr ""
-# type: textblock
-#: dh_testdir:14
-msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file ...>>]"
+#. type: textblock
+#: dh_installemacsen:45
+msgid "Sets the priority number of a site-start.d file. Default is 50."
msgstr ""
-# type: textblock
-#: dh_testdir:18
-msgid ""
-"dh_testdir tries to make sure that you are in the correct directory when "
-"building a debian package. It makes sure that the file debian/control "
-"exists, as well as any other files you specify. If not, it exits with an "
-"error."
+#. type: =item
+#: dh_installemacsen:47
+msgid "B<--flavor=>I<foo>"
msgstr ""
-# type: textblock
-#: dh_testdir:29
-msgid "Test for the existence of these files too."
+#. type: textblock
+#: dh_installemacsen:49
+msgid ""
+"Sets the flavor a site-start.d file will be installed in. Default is "
+"\"emacs\", alternatives include \"xemacs\" and \"emacs20\"."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:5
-msgid "dh_shlibdeps - calculate shared library dependencies"
+#. type: textblock
+#: dh_installexamples:5
+msgid "dh_installexamples - install example files into package build directories"
msgstr ""
-# type: textblock
-#: dh_shlibdeps:15
+#. type: textblock
+#: dh_installexamples:14
msgid ""
-"B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
-"[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
+"B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] "
+"[S<I<file ...>>]"
msgstr ""
-# type: textblock
-#: dh_shlibdeps:19
+#. type: textblock
+#: dh_installexamples:18
msgid ""
-"dh_shlibdeps is a debhelper program that is responsible for calculating "
-"shared library dependencies for packages."
+"dh_installexamples is a debhelper program that is responsible for installing "
+"examples into usr/share/doc/package/examples in package build directories."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:22
+#. type: textblock
+#: dh_installexamples:22
msgid ""
-"This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
-"once for each package listed in the control file, passing it a list of ELF "
-"executables and shared libraries it has found."
+"Any file names specified as parameters will be installed into the first "
+"package dh_installexamples is told to act on. By default, this is the first "
+"binary package in debian/control, but if you use -p, -i, or -a flags, it "
+"will be the first package specified by those flags."
msgstr ""
-# type: =item
-#: dh_shlibdeps:30
-msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
+#. type: textblock
+#: dh_installexamples:27
+msgid "Files named debian/package.examples can list other files to be installed."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:34
-msgid "Pass \"params\" to L<dpkg-shlibdeps(1)>."
+#. type: textblock
+#: dh_installexamples:35
+msgid ""
+"Install any files specified by command line parameters in ALL packages acted "
+"on."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:38
+#. type: textblock
+#: dh_installexamples:40
msgid ""
-"Exclude files that contain \"item\" anywhere in their filename from being "
-"passed to dpkg-shlibdeps. This will make their dependencies be ignored. "
-"This may be useful in some situations, but use it with caution. This option "
-"may be used more than once to exclude more than one thing."
+"Install these files as examples into the first package acted on. (Or into "
+"all packages if -A is specified.)"
msgstr ""
-# type: =item
-#: dh_shlibdeps:43
-msgid "B<-l>I<directory>[:directory:directory:..]"
+#. type: textblock
+#: dh_installexamples:45 dh_install:71 dh_movefiles:46
+msgid ""
+"Exclude files that contain \"item\" anywhere in their filename from being "
+"installed."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:45
+#. type: textblock
+#: dh_installexamples:52
msgid ""
-"Before dpkg-shlibdeps is run, LD_LIBRARY_PATH will have added to it the "
-"specified directory (or directories -- separate with colons). This is useful "
-"for multi-binary packages where a library is built in one package and "
-"another package contains binaries linked against said library. Relative "
-"paths will be made absolute for the benefit of dpkg-shlibdeps."
+"Note that dh_installexamples will happily copy entire directory hierarchies "
+"if you ask it to (similar to cp -a). If it is asked to install a directory, "
+"it will install the complete contents of the directory."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:52
-msgid ""
-"Note that the directory given should be the complete or relative path to a "
-"directory that contains the library. See example below."
+#. type: textblock
+#: dh_installinfo:5
+msgid "dh_installinfo - install info files"
msgstr ""
-# type: =item
-#: dh_shlibdeps:55
-msgid "B<-L>I<package>, B<--libpackage=>I<package>"
+#. type: textblock
+#: dh_installinfo:14
+msgid "B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [S<I<file ...>>]"
msgstr ""
-# type: textblock
-#: dh_shlibdeps:57
+#. type: textblock
+#: dh_installinfo:18
msgid ""
-"Use the shlibs file automatically generated by dh_makeshlibs for the named "
-"package as a kind of automatically generated shlibs.local file. You can use "
-"this switch in concert with the -l switch to make dpkg-shlibdeps find a "
-"library built as part of the current package, and get the shlibs "
-"information. See example below."
-msgstr ""
-
-# type: =head1
-#: dh_shlibdeps:65 dh_link:65 dh_makeshlibs:69 dh_installdocs:76
-msgid "EXAMPLES"
+"dh_installinfo is a debhelper program that is responsible for installing "
+"info files into usr/share/info in the package build directory."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:67
+#. type: textblock
+#: dh_installinfo:21
msgid ""
-"Suppose that your source package produces libfoo1, libfoo-dev, and "
-"libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
-"depend on it. In your rules file, first run dh_makeshlibs, then "
-"dh_shlibdeps:"
+"Any filenames specified as parameters will be installed into the first "
+"package dh_installinfo is told to act on. By default, this is the first "
+"binary package in debian/control, but if you use -p, -i, or -a flags, it "
+"will be the first package specified by those flags."
msgstr ""
-# type: verbatim
-#: dh_shlibdeps:71
-#, no-wrap
-msgid ""
-"\tdh_makeshlibs\n"
-"\tdh_shlibdeps -L libfoo1 -l debian/libfoo1/usr/lib\n"
-"\n"
+#. type: textblock
+#: dh_installinfo:26
+msgid "Files named debian/package.info can list other files to be installed."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:74
+#. type: textblock
+#: dh_installinfo:39
msgid ""
-"This will have the effect of generating automatically a shlibs file for "
-"libfoo1, and using that file and the libfoo1 library in the "
-"debian/libfoo1/usr/lib directory to calculate shared library dependency "
-"information."
+"Install these info files into the first package acted on. (Or in all "
+"packages if -A is specified)."
msgstr ""
-# type: textblock
-#: dh_shlibdeps:150
-msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
+#. type: textblock
+#: dh_installinit:5
+msgid "dh_installinit - install init scripts into package build directories"
msgstr ""
-# type: textblock
-#: dh_scrollkeeper:5
-msgid "dh_scrollkeeper - generate ScrollKeeper registration scripts"
+#. type: textblock
+#: dh_installinit:14
+msgid ""
+"B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
+"[B<-R>] [B<-r>] [B<-d>] [S<B<--> I<params>>]"
msgstr ""
-# type: textblock
-#: dh_scrollkeeper:14
-msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
+#. type: textblock
+#: dh_installinit:18
+msgid ""
+"dh_installinit is a debhelper program that is responsible for installing "
+"init scripts and associated defaults files into package build directories."
msgstr ""
-# type: textblock
-#: dh_scrollkeeper:18
+#. type: textblock
+#: dh_installinit:21
msgid ""
-"B<dh_scrollkeeper> is a debhelper program that handles correctly registering "
-"OMF files that it finds in package build trees with ScrollKeeper."
+"It also automatically generates the postinst and postrm and prerm commands "
+"needed to set up the symlinks in /etc/rc*.d/ and to start and stop the init "
+"scripts."
msgstr ""
-# type: textblock
-#: dh_scrollkeeper:22
+#. type: textblock
+#: dh_installinit:25
msgid ""
-"This command automatically adds maintainer script snippets for registering "
-"and unregistering files with ScrollKeeper (unless B<-n> is used). See "
-"L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
-"snippets."
+"If a file named debian/package.init exists, then it is installed into "
+"etc/init.d/package in the package build directory, with \"package\" replaced "
+"by the package name."
msgstr ""
-# type: textblock
-#: dh_scrollkeeper:27
+#. type: textblock
+#: dh_installinit:29
msgid ""
-"It will also change any DTD declarations in the OMF and DocBook files to "
-"refer to local files instead of remote URLs. This change does not modify the "
-"source files, but the files in the package build tree."
+"If a file named debian/package.default exists, then it is installed into "
+"etc/default/package in the package build directory, with \"package\" "
+"replaced by the package name."
msgstr ""
-# type: textblock
-#: dh_scrollkeeper:37
-msgid "Do not modify F<postinst>/F<postrm> scripts."
+#. type: textblock
+#: dh_installinit:39
+msgid "Do not modify postinst/postrm/prerm scripts."
msgstr ""
-# type: textblock
-#: dh_scrollkeeper:77 dh_desktop:45
-msgid "L<debhelper>"
+#. type: =item
+#: dh_installinit:41
+msgid "B<-o>, B<--onlyscripts>"
msgstr ""
-# type: textblock
-#: dh_scrollkeeper:83 dh_desktop:51
-msgid "Ross Burton <ross@burtonini.com>"
+#. type: textblock
+#: dh_installinit:43
+msgid ""
+"Only modify postinst/postrm/prerm scripts, do not actually install any init "
+"script or default files. May be useful if the init script is shipped and/or "
+"installed by upstream in a way that doesn't make it easy to let "
+"dh_installinit find it."
msgstr ""
-# type: textblock
-#: dh_installdirs:5
-msgid "dh_installdirs - create subdirectories in package build directories"
+#. type: =item
+#: dh_installinit:48
+msgid "B<-R>, B<--restart-after-upgrade>"
msgstr ""
-# type: textblock
-#: dh_installdirs:14
-msgid "B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir ...>>]"
+#. type: textblock
+#: dh_installinit:50
+msgid ""
+"Do not stop the init script until after the package upgrade has been "
+"completed. This is different than the default behavior, which stops the "
+"script in the prerm, and starts it again in the postinst."
msgstr ""
-# type: textblock
-#: dh_installdirs:18
+#. type: textblock
+#: dh_installinit:54
msgid ""
-"dh_installdirs is a debhelper program that is responsible for creating "
-"subdirectories in package build directories."
+"This can be useful for daemons that should not have a possibly long downtime "
+"during upgrade. But you should make sure that the daemon will not get "
+"confused by the package being upgraded while it's running before using this "
+"option."
msgstr ""
-# type: textblock
-#: dh_installdirs:21
-msgid ""
-"Any directory names specified as parameters will be created in the package "
-"build directory of the first package dh_installdirs is told to act on. By "
-"default, this is the first binary package in debian/control, but if you use "
-"-p, -i, or -a flags, it will be the first package specified by those flags."
+#. type: =item
+#: dh_installinit:59
+msgid "B<-r>, B<--no-restart-on-upgrade>"
msgstr ""
-# type: textblock
-#: dh_installdirs:26
-msgid ""
-"A file named debian/package.dirs can list other directories to be created. "
-"Separate the directory names with whitespace."
+#. type: textblock
+#: dh_installinit:61
+msgid "Do not stop init script on upgrade."
msgstr ""
-# type: textblock
-#: dh_installdirs:29
-msgid ""
-"Be sure to only use directory names relative to the package build "
-"directory. Ie, \"/usr/bin\" should not be used, use \"usr/bin\" instead."
+#. type: =item
+#: dh_installinit:63
+msgid "B<--no-start>"
msgstr ""
-# type: textblock
-#: dh_installdirs:38
+#. type: textblock
+#: dh_installinit:65
msgid ""
-"Create any directories specified by command line parameters in ALL packages "
-"acted on, not just the first."
+"Do not start the init script on install or upgrade, or stop it on removal. "
+"Only call update-rc.d. Useful for rcS scripts."
msgstr ""
-# type: =item
-#: dh_installdirs:41
-msgid "I<dir ...>"
+#. type: =item
+#: dh_installinit:68
+msgid "B<-d>, B<--remove-d>"
msgstr ""
-# type: textblock
-#: dh_installdirs:43
+#. type: textblock
+#: dh_installinit:70
msgid ""
-"Create these directories in the package build directory of the first package "
-"acted on. (Or in all packages if -A is specified.)"
-msgstr ""
-
-# type: textblock
-#: dh_link:5
-msgid "dh_link - create symlinks in package build directories"
+"Remove trailing \"d\" from the name of the package, and use the result for "
+"the filename the init script is installed as in etc/init.d/ , and the "
+"default file is installed as in etc/default/ . This may be useful for "
+"daemons with names ending in \"d\". (Note: this takes precedence over the "
+"--init-script parameter described below.)"
msgstr ""
-# type: textblock
-#: dh_link:15
-msgid "B<dh_link> [S<I<debhelper options>>] [B<-A>] [S<I<source destination ...>>]"
+#. type: =item
+#: dh_installinit:76
+msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
msgstr ""
-# type: textblock
-#: dh_link:19
+#. type: textblock
+#: dh_installinit:80
msgid ""
-"dh_link is a debhelper program that creates symlinks in package build "
-"directories."
+"Pass \"params\" to L<update-rc.d(8)>. If not specified, \"defaults\" will be "
+"passed to L<update-rc.d(8)>."
msgstr ""
-# type: textblock
-#: dh_link:22
+#. type: textblock
+#: dh_installinit:85
msgid ""
-"dh_link accepts a list of pairs of source and destination files. The source "
-"files are the already existing files that will be symlinked from. The "
-"destination files are the symlinks that will be created. There B<must> be an "
-"equal number of source and destination files specified."
+"Install the init script (and default file) using the filename I<name> "
+"instead of the default filename, which is the package name. When this "
+"parameter is used, dh_installinit looks for and installs files named "
+"debian/package.name.init and debian/package.name.default, instead of the "
+"usual debian/package.init and debian/package.default."
msgstr ""
-# type: textblock
-#: dh_link:27
-msgid ""
-"The list can be specified in two ways. A file named debian/package.links can "
-"list pairs of files. If you use this file, you should put each pair of files "
-"on its own line, and separate the files within the pair with "
-"whitespace. Also, pairs of files can be specified as parameters - these "
-"pairs will only be created in the package build directory of the first "
-"package dh_link is told to act on. By default, this is the first binary "
-"package in debian/control, but if you use -p, -i, or -a flags, it will be "
-"the first package specified by those flags."
+#. type: =item
+#: dh_installinit:91
+msgid "B<--init-script=>I<scriptname>"
msgstr ""
-# type: textblock
-#: dh_link:36
+#. type: textblock
+#: dh_installinit:93
msgid ""
-"Be sure you B<do> specify the full filename to both the source and "
-"destination files (unlike you would do if you were using something like "
-"L<ln(1)>)."
+"Use \"scriptname\" as the filename the init script is installed as in "
+"etc/init.d/ (and also use it as the filename for the defaults file, if it is "
+"installed). If you use this parameter, dh_installinit will look to see if a "
+"file in the debian/ directory exists that looks like \"package.scriptname\" "
+"and if so will install it as the init script in preference to the files it "
+"normally installs."
msgstr ""
-# type: textblock
-#: dh_link:40
-msgid ""
-"dh_link will generate symlinks that comply with debian policy - absolute "
-"when policy says they should be absolute, and relative links with as short a "
-"path as possible. It will also create any subdirectories it needs to to put "
-"the symlinks in."
+#. type: textblock
+#: dh_installinit:100
+msgid "This parameter is deprecated, use the --name parameter instead."
msgstr ""
-# type: textblock
-#: dh_link:45
-msgid ""
-"dh_link also scans the package build tree for existing symlinks which do not "
-"conform to debian policy, and corrects them (v4 only)."
+#. type: =item
+#: dh_installinit:102
+msgid "B<--error-handler=>I<function>"
msgstr ""
-# type: textblock
-#: dh_link:54
+#. type: textblock
+#: dh_installinit:104
msgid ""
-"Create any links specified by command line parameters in ALL packages acted "
-"on, not just the first."
+"Call the named shell function if running the init script fails. The function "
+"should be provided in the prerm and postinst scripts, before the #DEBHELPER# "
+"token."
msgstr ""
-# type: =item
-#: dh_link:57
-msgid "I<source destination ...>"
+#. type: textblock
+#: dh_installlogcheck:5
+msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
msgstr ""
-# type: textblock
-#: dh_link:59
-msgid ""
-"Create a file named \"destination\" as a link to a file named \"source\". Do "
-"this in the package build directory of the first package acted on. (Or in "
-"all packages if -A is specified.)"
+#. type: textblock
+#: dh_installlogcheck:14
+msgid "B<dh_installlogcheck> [S<B<debhelper options>>]"
msgstr ""
-# type: verbatim
-#: dh_link:67
-#, no-wrap
+#. type: textblock
+#: dh_installlogcheck:18
msgid ""
-" dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
-"\n"
-msgstr ""
-
-# type: textblock
-#: dh_link:69
-msgid "Make bar.1 be a symlink to foo.1"
+"dh_installlogcheck is a debhelper program that is responsible for installing "
+"logcheck rule files into subdirectories of etc/logcheck/ in package build "
+"directories. The files debian/package.logcheck.cracking, "
+"debian/package.logcheck.violations, "
+"debian/package.logcheck.violations.ignore, "
+"debian/package.logcheck.ignore.workstation, "
+"debian/package.logcheck.ignore.server and "
+"debian/package.logcheck.ignore.paranoid are installed if present."
msgstr ""
-# type: verbatim
-#: dh_link:71
+#. type: verbatim
+#: dh_installlogcheck:55
#, no-wrap
msgid ""
-" dh_link var/lib/foo usr/lib/foo \\\n"
-" usr/X11R6/man/man1/foo.1x usr/share/man/man1/bar.1\n"
-"\n"
+"This program is a part of debhelper.\n"
+" \n"
msgstr ""
-# type: textblock
-#: dh_link:74
-msgid ""
-"Make /usr/lib/foo/ be a link to /var/lib/foo/, and bar.1 be a symlink to the "
-"X man page foo.1x"
+#. type: textblock
+#: dh_installlogcheck:59
+msgid "Jon Middleton <jjm@debian.org>"
msgstr ""
-# type: textblock
-#: dh_installdebconf:5
-msgid ""
-"dh_installdebconf - install files used by debconf in package build "
-"directories"
+#. type: textblock
+#: dh_installlogrotate:5
+msgid "dh_installlogrotate - install logrotate config files"
msgstr ""
-# type: textblock
-#: dh_installdebconf:14
-msgid "B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]"
+#. type: textblock
+#: dh_installlogrotate:14
+msgid "B<dh_installlogrotate> [S<I<debhelper options>>] [B<--name=>I<name>]"
msgstr ""
-# type: textblock
-#: dh_installdebconf:18
+#. type: textblock
+#: dh_installlogrotate:18
msgid ""
-"dh_installdebconf is a debhelper program that is responsible for installing "
-"files used by the debconf package into package build directories."
+"dh_installlogrotate is a debhelper program that is responsible for "
+"installing logrotate config files into etc/logrotate.d in package build "
+"directories. Files named debian/package.logrotate are installed."
msgstr ""
-# type: textblock
-#: dh_installdebconf:21
+#. type: textblock
+#: dh_installlogrotate:28
msgid ""
-"It also automatically generates the postrm commands needed to interface with "
-"debconf. See L<dh_installdeb(1)> for an explanation of how that works."
+"Look for files named debian/package.name.logrotate and install them as "
+"etc/logrotate.d/name, instead of using the usual files and installing them "
+"as the package name."
msgstr ""
-# type: textblock
-#: dh_installdebconf:25
-msgid ""
-"Files named debian/package.config and debian/package.templates are installed "
-"into the DEBIAN directory in the package build directory. If a file named "
-"debian/package.config.debhelper exists, the contents of that file are merged "
-"into the config script as follows: If the script exists, then anywhere in it "
-"that \"#DEBHELPER#\" appears, the text of the .debhelper file is "
-"inserted. If the script does not exist, then a script is generated from the "
-".debhelper file. The .debhelper files may be created by other debhelper "
-"programs, and are shell script fragments."
+#. type: textblock
+#: dh_installmanpages:5
+msgid "dh_installmanpages - old-style man page installer"
msgstr ""
-# type: textblock
-#: dh_installdebconf:34
-msgid ""
-"Note that if you use debconf, your package probably needs to depend on it "
-"(it will be added to ${misc:Depends} by this program)."
+#. type: textblock
+#: dh_installmanpages:15
+msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file ...>>]"
msgstr ""
-# type: textblock
-#: dh_installdebconf:37
+#. type: textblock
+#: dh_installmanpages:19
msgid ""
-"Note that for your config script to be called by dpkg, your postinst needs "
-"to source debconf's confmodule. dh_installdebconf does not install this "
-"statement into postinst automatically as it it too hard to do it right."
-msgstr ""
-
-# type: =head1
-#: dh_installdebconf:42
-msgid "LOCALIZED TEMPLATE FILES"
+"dh_installmanpages is a debhelper program that is responsible for "
+"automatically installing man pages into usr/share/man/ and usr/X11R6/man/ in "
+"package build directories."
msgstr ""
-# type: textblock
-#: dh_installdebconf:44
+#. type: textblock
+#: dh_installmanpages:23
msgid ""
-"Debconf also supports localized template files, and this program has some "
-"support to aid is working with them. It is best to keep the translations in "
-".po files under debian/po, and merge them only at build time. See "
-"L<po2debconf(1)> and L<debconf-getlang(1)> for details."
+"This is a DWIM-style program, with an interface unlike the rest of "
+"debhelper. It is deprecated, and you are encouraged to use "
+"L<dh_installman(1)> instead."
msgstr ""
-# type: textblock
-#: dh_installdebconf:49
+#. type: textblock
+#: dh_installmanpages:27
msgid ""
-"This program will look to see if you have a debian/po directory and if so "
-"will automatically call L<po2debconf(1)> to generate a merged templates "
-"file. Or if you have debian/templates.ll files, it will use the older "
-"L<debconf-mergetemplate(1)> program to merge those together."
+"dh_installmanpages scans the current directory and all subdirectories for "
+"filenames that look like man pages. (Note that only real files are looked "
+"at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
+"in the correct format. Then, based on the files' extensions, it installs "
+"them into the correct man directory."
msgstr ""
-# type: textblock
-#: dh_installdebconf:54
+#. type: textblock
+#: dh_installmanpages:33
msgid ""
-"Note that if your package has a debian/po directory it should build-depend "
-"on po-debconf."
+"All filenames specified as parameters will be skipped by "
+"dh_installmanpages. This is useful if by default it installs some man pages "
+"that you do not want to be installed."
msgstr ""
-# type: textblock
-#: dh_installdebconf:56
+#. type: textblock
+#: dh_installmanpages:37
msgid ""
-"For example, if you have a German translation, strings from debian/po/de.po "
-"are merged with debian/package.templates."
+"After the man page installation step, dh_installmanpages will check to see "
+"if any of the man pages are \".so\" links. If so, it changes them to "
+"symlinks."
msgstr ""
-# type: textblock
-#: dh_installdebconf:65
-msgid "Do not modify postrm script."
+#. type: textblock
+#: dh_installmanpages:46
+msgid ""
+"Do not install these files as man pages, even if they look like valid man "
+"pages."
msgstr ""
-# type: textblock
-#: dh_installdebconf:69
-msgid ""
-"Pass the params to po2debconf, if it is run or debconf-mergetemplate, if it "
-"is run."
+#. type: =head1
+#: dh_installmanpages:51
+msgid "BUGS"
msgstr ""
-# type: textblock
-#: dh_installmime:5
-msgid "dh_installmime - install mime files into package build directories"
+#. type: textblock
+#: dh_installmanpages:53
+msgid ""
+"dh_installmanpages will install the man pages it finds into B<all> packages "
+"you tell it to act on, since it can't tell what package the man pages belong "
+"in. This is almost never what you really want (use -p to work around this, "
+"or use the much better L<dh_installman(1)> program instead)."
msgstr ""
-# type: textblock
-#: dh_installmime:14
-msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
+#. type: textblock
+#: dh_installmanpages:58
+msgid "Files ending in I<.man> will be ignored."
msgstr ""
-# type: textblock
-#: dh_installmime:18
+#. type: textblock
+#: dh_installmanpages:60
msgid ""
-"dh_installmime is a debhelper program that is responsible for installing "
-"mime files into package build directories."
+"Files specified as parameters that contain spaces in their filenames will "
+"not be processed properly."
msgstr ""
-# type: textblock
-#: dh_installmime:21
+#. type: textblock
+#: dh_installman:5
+msgid "dh_installman - install man pages into package build directories"
+msgstr ""
+
+#. type: textblock
+#: dh_installman:15
+msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage ...>>]"
+msgstr ""
+
+#. type: textblock
+#: dh_installman:19
msgid ""
-"It also automatically generates the postinst and postrm commands needed to "
-"interface with the debian mime-support and shared-mime-info packages. See "
-"L<dh_installdeb(1)> for an explanation of how this works."
+"dh_installman is a debhelper program that handles installing man pages into "
+"the correct locations in package build directories. You tell it what man "
+"pages go in your packages, and it figures out where to install them based on "
+"the section field in their .TH line. If you have a properly formatted .TH "
+"line, your man page will be installed into the right directory, with the "
+"right name (this includes proper handling of pages with a subsection, like "
+"\"3perl\", which are placed in man3, and given an extension of "
+"\".3perl\"). If your .TH line is incorrect or missing, the program may guess "
+"wrong based on the file extension."
msgstr ""
-# type: textblock
-#: dh_installmime:25
+#. type: textblock
+#: dh_installman:29
msgid ""
-"If files named debian/package.mime or debian/package.sharedmimeinfo exist, "
-"then they are installed into usr/lib/mime/packages/package and "
-"/usr/share/mime/packages/package.xml (respectively) in the package build "
-"directory."
+"It also supports translated man pages, by looking for extensions like .ll.8 "
+"and .ll_LL.8, or by use of the --language switch."
msgstr ""
-# type: textblock
-#: dh_installwm:5
-msgid "dh_installwm - register a window manager"
+#. type: textblock
+#: dh_installman:32
+msgid ""
+"If dh_installman seems to install a man page into the wrong section or with "
+"the wrong extension, this is because the man page has the wrong section "
+"listed in its .TH line. Edit the man page and correct the section, and "
+"dh_installman will follow suit. See L<man(7)> for details about the .TH "
+"section. If dh_installman seems to install a man page into a directory like "
+"/usr/share/man/pl/man1/, that is because your program has a name like "
+"\"foo.pl\", and dh_installman assumes that means it is translated into "
+"Polish. Use --language=C to avoid this."
msgstr ""
-# type: textblock
-#: dh_installwm:14
+#. type: textblock
+#: dh_installman:41
msgid ""
-"B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
-"[S<I<wm ...>>]"
+"Any man page filenames specified as parameters will be installed into the "
+"first package dh_installman is told to act on. By default, this is the first "
+"binary package in debian/control, but if you use -p, -i, or -a flags, it "
+"will be the first package specified by those flags."
msgstr ""
-# type: textblock
-#: dh_installwm:18
+#. type: textblock
+#: dh_installman:46
msgid ""
-"dh_installwm is a debhelper program that is responsible for generating the "
-"postinst and postrm commands that register a window manager with "
-"L<update-alternatives(8)>"
+"Files named debian/package.manpages can list other man pages to be "
+"installed."
msgstr ""
-# type: textblock
-#: dh_installwm:22
+#. type: textblock
+#: dh_installman:49
msgid ""
-"Any window manager programs specified as parameters will be registered in "
-"the first package dh_installwm is told to act on. By default, this is the "
-"first binary package in debian/control, but if you use -p, -i, or -a flags, "
-"it will be the first package specified by those flags."
+"After the man page installation step, dh_installman will check to see if any "
+"of the man pages in the temporary directories of any of the packages it is "
+"acting on contain \".so\" links. If so, it changes them to symlinks."
msgstr ""
-# type: textblock
-#: dh_installwm:27
+#. type: textblock
+#: dh_installman:53
msgid ""
-"Files named debian/package.wm can list other window manager programs to "
-"register."
+"Also, dh_installman will use man to guess the character encoding of each "
+"manual page and convert it to UTF-8. If the guesswork fails for some reason, "
+"you can override it using an encoding declaration. See L<manconv(1)> for "
+"details."
+msgstr ""
+
+#. type: =item
+#: dh_installman:67
+msgid "B<--language>=ll"
msgstr ""
-# type: textblock
-#: dh_installwm:36
+#. type: textblock
+#: dh_installman:69
msgid ""
-"Set the priority of the window manager. Default is 20, which is too low for "
-"most window managers; see the Debian Policy document for instructions on "
-"calculating the correct value."
+"Use this to specify that the man pages being acted on are written in the "
+"specified language."
msgstr ""
-# type: textblock
-#: dh_installwm:42
-msgid "Do not modify postinst/postrm scripts. Turns this command into a no-op."
+#. type: =item
+#: dh_installman:72
+msgid "I<manpage ...>"
msgstr ""
-# type: =item
-#: dh_installwm:44
-msgid "I<wm ...>"
+#. type: textblock
+#: dh_installman:74
+msgid ""
+"Install these man pages into the first package acted on. (Or in all packages "
+"if -A is specified)."
msgstr ""
-# type: textblock
-#: dh_installwm:46
+#. type: textblock
+#: dh_installman:81
msgid ""
-"The commands used to run the window manager or window managers you want to "
-"register."
+"An older version of this program, L<dh_installmanpages(1)>, is still used by "
+"some packages, and so is still included in debhelper. It is, however, "
+"deprecated, due to its counterintuitive and inconsistent interface. Use this "
+"program instead."
msgstr ""
-# type: textblock
-#: dh_installdeb:5
-msgid "dh_installdeb - install files into the DEBIAN directory"
+#. type: textblock
+#: dh_installmenu:5
+msgid "dh_installmenu - install debian menu files into package build directories"
msgstr ""
-# type: textblock
-#: dh_installdeb:14
-msgid "B<dh_installdeb> [S<I<debhelper options>>]"
+#. type: textblock
+#: dh_installmenu:14
+msgid "B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]"
msgstr ""
-# type: textblock
-#: dh_installdeb:18
+#. type: textblock
+#: dh_installmenu:18
msgid ""
-"dh_installdeb is a debhelper program that is responsible for installing "
-"files into the DEBIAN directories in package build directories with the "
-"correct permissions."
+"dh_installmenu is a debhelper program that is responsible for installing "
+"files used by the debian menu package into package build directories."
msgstr ""
-# type: verbatim
-#: dh_installdeb:22
-#, no-wrap
+#. type: textblock
+#: dh_installmenu:21
msgid ""
-"dh_installdeb automatically installs the following files from debian/ into\n"
-"the DEBIAN directory:\n"
-" package.postinst\n"
-" package.preinst\n"
-" package.postrm\n"
-" package.prerm\n"
-" package.shlibs\n"
-" package.conffiles\n"
-"\n"
+"It also automatically generates the postinst and postrm commands needed to "
+"interface with the debian menu package. These commands are inserted into the "
+"maintainer scripts by dh_installdeb. See L<dh_installdeb(1)> for an "
+"explanation of how this works."
msgstr ""
-# type: textblock
-#: dh_installdeb:31
+#. type: textblock
+#: dh_installmenu:26
msgid ""
-"The postinst, preinst, postrm, and prerm are handled specially: If a "
-"corresponding file named debian/package.script.debhelper exists, the "
-"contents of that file are merged into the script as follows: If the script "
-"exists, then anywhere in it that \"#DEBHELPER#\" appears, the text of the "
-".debhelper file is inserted. If the script does not exist, then a script is "
-"generated from the .debhelper file. The .debhelper files are created by "
-"other debhelper programs, such as L<dh_installmenu(1)>, and are shell script "
-"fragments."
+"If a file named debian/package.menu exists, then it is installed into "
+"usr/share/menu/package in the package build directory. This is a debian menu "
+"file. See L<menufile(5)> for its format."
msgstr ""
-# type: textblock
-#: dh_installdeb:39
+#. type: textblock
+#: dh_installmenu:30
msgid ""
-"In V3 compatibility mode and higher, all files in the etc/ directory in a "
-"package will automatically be flagged as conffiles by this program, so there "
-"is no need to list them manually in package.conffiles."
+"If a file named debian/package.menu-method exits, then it is installed into "
+"etc/menu-methods/package in the package build directory. This is a debian "
+"menu method file."
msgstr ""
-# type: textblock
-#: dh_builddeb:5
-msgid "dh_builddeb - build debian packages"
+#. type: textblock
+#: dh_installmenu:40 dh_installmime:37 dh_installmodules:49 dh_makeshlibs:64 dh_python:62
+msgid "Do not modify postinst/postrm scripts."
msgstr ""
-# type: textblock
-#: dh_builddeb:14
-msgid ""
-"B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] "
-"[B<--filename=>I<name>] [S<B<--> I<params>>]"
+#. type: textblock
+#: dh_installmenu:82
+msgid "L<debhelper(7)> L<update-menus(1)> L<menufile(5)>"
msgstr ""
-# type: textblock
-#: dh_builddeb:18
+#. type: textblock
+#: dh_installmime:5
+msgid "dh_installmime - install mime files into package build directories"
+msgstr ""
+
+#. type: textblock
+#: dh_installmime:14
+msgid "B<dh_installmime> [S<I<debhelper options>>] [B<-n>]"
+msgstr ""
+
+#. type: textblock
+#: dh_installmime:18
msgid ""
-"dh_builddeb simply calls L<dpkg-deb(8)> to build a debian package or "
-"packages."
+"dh_installmime is a debhelper program that is responsible for installing "
+"mime files into package build directories."
msgstr ""
-# type: =item
-#: dh_builddeb:25
-msgid "B<--destdir=>I<directory>"
+#. type: textblock
+#: dh_installmime:21
+msgid ""
+"It also automatically generates the postinst and postrm commands needed to "
+"interface with the debian mime-support and shared-mime-info packages. These "
+"commands are inserted into the maintainer scripts by dh_installdeb. See "
+"L<dh_installdeb(1)> for an explanation of how this works."
msgstr ""
-# type: textblock
-#: dh_builddeb:27
+#. type: textblock
+#: dh_installmime:26
msgid ""
-"Use this if you want the generated .deb files to be put in a directory other "
-"than the default of \"..\""
+"If files named debian/package.mime or debian/package.sharedmimeinfo exist, "
+"then they are installed into usr/lib/mime/packages/package and "
+"/usr/share/mime/packages/package.xml (respectively) in the package build "
+"directory."
msgstr ""
-# type: =item
-#: dh_builddeb:30
-msgid "B<--filename=>I<name>"
+#. type: textblock
+#: dh_installmodules:5
+msgid "dh_installmodules - register modules with modutils"
msgstr ""
-# type: textblock
-#: dh_builddeb:32
+#. type: textblock
+#: dh_installmodules:16
+msgid "B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]"
+msgstr ""
+
+#. type: textblock
+#: dh_installmodules:20
msgid ""
-"Use this if you want to force the generated .deb file to have a particular "
-"file name. Does not work well if more than one .deb is generated!"
+"dh_installmodules is a debhelper program that is responsible for registering "
+"kernel modules."
msgstr ""
-# type: =item
-#: dh_builddeb:35
-msgid "B<-u>I<params>"
+#. type: textblock
+#: dh_installmodules:23
+msgid ""
+"Files named debian/package.modprobe will be installed in "
+"etc/modprobe.d/package.conf in the package build directory, to be used by "
+"module-init-tools's version of modprobe."
msgstr ""
-# type: textblock
-#: dh_builddeb:39
-msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
+#. type: textblock
+#: dh_installmodules:27
+msgid ""
+"Kernel modules are searched for in the package build directory and if found, "
+"postinst and postrm commands are automatically generated to run depmod and "
+"register the modules when the package is installed. These commands are "
+"inserted into the maintainer scripts by dh_installdeb. See "
+"L<dh_installdeb(1)> for an explanation of how this works."
msgstr ""
-# type: textblock
-#: dh_gencontrol:5
-msgid "dh_gencontrol - generate and install control file"
+#. type: textblock
+#: dh_installmodules:33
+msgid ""
+"Previous versions of dh_installmodules installed files named "
+"etc/modprobe.d/package, code is added to the preinst and postinst to handle "
+"the upgrade from the old location."
msgstr ""
-# type: textblock
-#: dh_gencontrol:14
-msgid "B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]"
+#. type: textblock
+#: dh_installmodules:37
+msgid ""
+"Previous versions of dh_installmodules also supported files named "
+"debian/package.modules, which were installed into etc/modutils/package in "
+"the package build directory. This was for use by modutils, which is no "
+"longer in Debian. dh_installmodules will warn about such files now."
msgstr ""
-# type: textblock
-#: dh_gencontrol:18
+#. type: textblock
+#: dh_installmodules:53
msgid ""
-"dh_gencontrol is a debhelper program that is responsible for generating "
-"control files, and installing them into the DEBIAN directory with the proper "
-"permissions."
+"When this parameter is used, dh_installmodules looks for and installs files "
+"named debian/package.name.modules and debian/package.name.modprobe instead "
+"of the usual debian/package.modules and debian/package.modprobe"
msgstr ""
-# type: textblock
-#: dh_gencontrol:22
+#. type: textblock
+#: dh_installpam:5
+msgid "dh_installpam - install pam support files"
+msgstr ""
+
+#. type: textblock
+#: dh_installpam:14
+msgid "B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]"
+msgstr ""
+
+#. type: textblock
+#: dh_installpam:18
msgid ""
-"This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls "
-"it once for each package being acted on, and passes in some additional "
-"useful flags including \"-isp\"."
+"dh_installpam is a debhelper program that is responsible for installing "
+"files used by PAM into package build directories."
msgstr ""
-# type: =item
-#: dh_gencontrol:30
-msgid "B<-u>I<params>, B<--dpkg-gencontrol-params>I<params>"
+#. type: textblock
+#: dh_installpam:21
+msgid ""
+"If a file named debian/package.pam exists, then it is installed into "
+"etc/pam.d/package in the package build directory."
msgstr ""
-# type: textblock
-#: dh_gencontrol:34
-msgid "Pass \"params\" to L<dpkg-gencontrol(1)>."
+#. type: textblock
+#: dh_installpam:30
+msgid ""
+"Look for files named debian/package.name.pam and install them as "
+"etc/pam.d/name, instead of using the usual files and installing them as the "
+"package name."
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_install:5
msgid "dh_install - install files into package build directories"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_install:15
msgid ""
"B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
"[S<I<debhelper options>>] [S<I<file [...] dest>>]"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_install:19
msgid ""
"dh_install is a debhelper program that handles installing files into package "
"needed. It is a replacement for the old dh_movefiles command."
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_install:27
msgid ""
"Files named debian/package.install list the files to install into each "
"(in v3 mode and above)."
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_install:36
msgid ""
"This program may be used in one of two ways. If you just have a file or two "
"directories and files from there into the proper package build directories."
msgstr ""
-# type: =item
-#: dh_install:52
-msgid "B<--autodest>"
-msgstr ""
-
-# type: textblock
-#: dh_install:54
-msgid ""
-"Guess as the destination directory to install things to. If this is "
-"specified, you should not list destination directories in "
-"debian/package.install files or on the command line. Instead, dh_install "
-"will guess as follows:"
-msgstr ""
-
-# type: textblock
-#: dh_install:59
-msgid ""
-"Strip off debian/tmp (or the sourcedir if one is given) from the front of "
-"the filename, if it is present, and install into the dirname of the "
-"filename. So if the filename is debian/tmp/usr/bin, then that directory will "
-"be copied to debian/package/usr/. If the filename is debian/tmp/etc/passwd, "
-"it will be copied to debian/package/etc/."
-msgstr ""
-
-# type: textblock
-#: dh_install:65
+#. type: textblock
+#: dh_install:43
msgid ""
-"Note that if you list exactly one filename or wildcard-pattern on a line by "
-"itself in a debian/package.install file, with no explicit destination, then "
-"dh_install will automatically guess the destination even if this flag is not "
-"set."
+"From debhelper compatibility level 7 on, dh_install will fall back to "
+"looking in debian/tmp for files, if it doesn't find them in the current "
+"directory (or whereever you've told it to look using --sourcedir)."
msgstr ""
-# type: =item
-#: dh_install:70
+#. type: =item
+#: dh_install:51
msgid "B<--list-missing>"
msgstr ""
-# type: textblock
-#: dh_install:72
+#. type: textblock
+#: dh_install:53
msgid ""
"This option makes dh_install keep track of the files it installs, and then "
"at the end, compare that list with the files in the source directory. If any "
"somewhere, it will warn on stderr about that."
msgstr ""
-# type: textblock
-#: dh_install:77
+#. type: textblock
+#: dh_install:58
msgid ""
"This may be useful if you have a large package and want to make sure that "
"you don't miss installing newly added files in new upstream releases."
msgstr ""
-# type: textblock
-#: dh_install:80
+#. type: textblock
+#: dh_install:61
msgid ""
"Note that files that are excluded from being moved via the -X option are not "
"warned about."
msgstr ""
-# type: =item
-#: dh_install:83
+#. type: =item
+#: dh_install:64
msgid "B<--fail-missing>"
msgstr ""
-# type: textblock
-#: dh_install:85
+#. type: textblock
+#: dh_install:66
msgid ""
"This option is like --list-missing, except if a file was missed, it will not "
"only list the missing files, but also fail with a nonzero exit code."
msgstr ""
-# type: =item
-#: dh_install:88
+#. type: =item
+#: dh_install:74
msgid "B<--sourcedir=dir>"
msgstr ""
-# type: textblock
+#. type: textblock
+#: dh_install:76
+msgid "Look in the specified directory for files to be installed."
+msgstr ""
+
+#. type: textblock
+#: dh_install:78
+msgid ""
+"Note that this is not the same as the --sourcedirectory option used by the "
+"dh_auto_* commands. You rarely need to use this option, since dh_install "
+"automatically looks for files in debian/tmp in debhelper compatibility level "
+"7 and above."
+msgstr ""
+
+#. type: =item
+#: dh_install:83
+msgid "B<--autodest>"
+msgstr ""
+
+#. type: textblock
+#: dh_install:85
+msgid ""
+"Guess as the destination directory to install things to. If this is "
+"specified, you should not list destination directories in "
+"debian/package.install files or on the command line. Instead, dh_install "
+"will guess as follows:"
+msgstr ""
+
+#. type: textblock
#: dh_install:90
msgid ""
-"Makes all source files be found under dir. If this is specified, it is akin "
-"to all the source filenames having \"dir/\" prepended to them."
+"Strip off debian/tmp (or the sourcedir if one is given) from the front of "
+"the filename, if it is present, and install into the dirname of the "
+"filename. So if the filename is debian/tmp/usr/bin, then that directory will "
+"be copied to debian/package/usr/. If the filename is debian/tmp/etc/passwd, "
+"it will be copied to debian/package/etc/."
msgstr ""
-# type: textblock
-#: dh_install:93
+#. type: textblock
+#: dh_install:96
msgid ""
-"To make dh_install behave like the old dh_movefiles, move your package.files "
-"file to package.install and call dh_install with \"--sourcedir=debian/tmp\" "
-"appended to the command. This will approximate dh_movefiles behaviour, "
-"except it will copy files instead of moving them."
+"Note that if you list exactly one filename or wildcard-pattern on a line by "
+"itself in a debian/package.install file, with no explicit destination, then "
+"dh_install will automatically guess the destination even if this flag is not "
+"set."
msgstr ""
-# type: =item
-#: dh_install:99
+#. type: =item
+#: dh_install:101
msgid "I<file [...] dest>"
msgstr ""
-# type: textblock
-#: dh_install:101
+#. type: textblock
+#: dh_install:103
msgid ""
"Lists files (or directories) to install and where to install them to. The "
"files will be installed into the first package dh_install acts on."
msgstr ""
-# type: =head1
-#: dh_install:224
+#. type: =head1
+#: dh_install:240
msgid "EXAMPLE"
msgstr ""
-# type: textblock
-#: dh_install:226
+#. type: textblock
+#: dh_install:242
msgid ""
"Suppose your package's upstream Makefile installs a binary, a man page, and "
"a library into appropriate subdirectories of debian/tmp. You want to put the "
"contain:"
msgstr ""
-# type: verbatim
-#: dh_install:232
+#. type: verbatim
+#: dh_install:248
#, no-wrap
msgid ""
" usr/bin\n"
"\n"
msgstr ""
-# type: textblock
-#: dh_install:235
+#. type: textblock
+#: dh_install:251
msgid "While debian/libfoo.install contains:"
msgstr ""
-# type: verbatim
-#: dh_install:237
+#. type: verbatim
+#: dh_install:253
#, no-wrap
msgid ""
" usr/lib/libfoo*.so.*\n"
"\n"
msgstr ""
-# type: textblock
-#: dh_install:239
+#. type: textblock
+#: dh_install:255
msgid ""
"If you want a libfoo-dev package too, debian/libfoo-dev.install might "
"contain:"
msgstr ""
-# type: verbatim
-#: dh_install:241
+#. type: verbatim
+#: dh_install:257
#, no-wrap
msgid ""
" usr/include\n"
"\n"
msgstr ""
-# type: =head1
-#: dh_install:245
+#. type: =head1
+#: dh_install:261
msgid "LIMITATIONS"
msgstr ""
-# type: verbatim
-#: dh_install:247
+#. type: verbatim
+#: dh_install:263
#, no-wrap
msgid ""
"dh_install cannot rename files or directories, it can only install them\n"
" \n"
msgstr ""
-# type: textblock
-#: dh_makeshlibs:5
-msgid "dh_makeshlibs - automatically create shlibs file"
+#. type: textblock
+#: dh_installppp:5
+msgid "dh_installppp - install ppp ip-up and ip-down files"
msgstr ""
-# type: textblock
-#: dh_makeshlibs:14
+#. type: textblock
+#: dh_installppp:14
+msgid "B<dh_installppp> [S<I<debhelper options>>] [B<--name=>I<name>]"
+msgstr ""
+
+#. type: textblock
+#: dh_installppp:18
msgid ""
-"B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
-"[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>]"
+"dh_installppp is a debhelper program that is responsible for installing ppp "
+"ip-up and ip-down scripts. into package build directories."
msgstr ""
-# type: textblock
-#: dh_makeshlibs:18
+#. type: textblock
+#: dh_installppp:21
msgid ""
-"dh_makeshlibs is a debhelper program that automatically scans for shared "
-"libraries, and generates a shlibs file for the libraries it finds."
+"If a file named debian/package.ppp.ip-up exists, then it is installed into "
+"etc/ppp/ip-up.d/package in the package build directory. Files named "
+"debian/package.ppp.ip-down are installed to etc/ppp/ip-down.d/package"
msgstr ""
-# type: textblock
-#: dh_makeshlibs:21
+#. type: textblock
+#: dh_installppp:32
msgid ""
-"It also adds a call to ldconfig in the postinst and postrm scripts (in V3 "
-"mode and above only) to any packages which it finds shared libraries in."
+"Look for files named debian/package.name.ppp.ip-* and install them as "
+"etc/ppp/ip-*/name, instead of using the usual files and installing them as "
+"the package name."
msgstr ""
-# type: =item
-#: dh_makeshlibs:28
-msgid "B<-m>I<major>, B<--major=>I<major>"
+#. type: textblock
+#: dh_installwm:5
+msgid "dh_installwm - register a window manager"
msgstr ""
-# type: textblock
-#: dh_makeshlibs:30
+#. type: textblock
+#: dh_installwm:14
msgid ""
-"Instead of trying to guess the major number of the library with objdump, use "
-"the major number specified after the -m parameter. This is much less useful "
-"than it used to be, back in the bad old days when this program looked at "
-"library filenames rather than using objdump."
+"B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] "
+"[S<I<wm ...>>]"
msgstr ""
-# type: =item
-#: dh_makeshlibs:35
-msgid "B<-V>, B<-V>I<dependencies>"
+#. type: textblock
+#: dh_installwm:18
+msgid ""
+"dh_installwm is a debhelper program that is responsible for generating the "
+"postinst and postrm commands that register a window manager with "
+"L<update-alternatives(8)>. The window manager's man page is also registered "
+"as a slave symlink (in v6 mode and up), if it is found in "
+"usr/share/man/man1/ in the package build directory."
msgstr ""
-# type: =item
-#: dh_makeshlibs:37
-msgid "B<--version-info>, B<--version-info=>I<dependencies>"
+#. type: textblock
+#: dh_installwm:24
+msgid ""
+"Any window manager programs specified as parameters will be registered in "
+"the first package dh_installwm is told to act on. By default, this is the "
+"first binary package in debian/control, but if you use -p, -i, or -a flags, "
+"it will be the first package specified by those flags."
msgstr ""
-# type: textblock
-#: dh_makeshlibs:39
+#. type: textblock
+#: dh_installwm:29
msgid ""
-"By default, the shlibs file generated by this program does not make packages "
-"depend on any particular version of the package containing the shared "
-"library. It may be necessary for you to add some version dependancy "
-"information to the shlibs file. If -V is specified with no dependency "
-"information, the current upstream version of the package is plugged into a "
-"dependency that looks like \"packagename (>= packageversion)\". Note that in "
-"debhelper compatibility levels before v4, the debian part of the package "
-"version number is also included. If -V is specified with parameters, the "
-"parameters can be used to specify the exact dependency information needed "
-"(be sure to include the package name)."
+"Files named debian/package.wm can list other window manager programs to "
+"register."
msgstr ""
-# type: textblock
-#: dh_makeshlibs:50
+#. type: textblock
+#: dh_installwm:38
msgid ""
-"Beware of using -V without any parameters; this is a conservative setting "
-"that always ensures that other packages' shared library dependencies are at "
-"least as tight as they need to be (unless your library is prone to changing "
-"ABI without updating the upstream version number), so that if the maintainer "
-"screws up then they won't break. The flip side is that packages might end up "
-"with dependencies that are too tight and so find it harder to be upgraded."
+"Set the priority of the window manager. Default is 20, which is too low for "
+"most window managers; see the Debian Policy document for instructions on "
+"calculating the correct value."
msgstr ""
-# type: textblock
-#: dh_makeshlibs:64
-msgid ""
-"Exclude files that contain \"item\" anywhere in their filename or directory "
-"from being treated as shared libraries."
+#. type: textblock
+#: dh_installwm:44
+msgid "Do not modify postinst/postrm scripts. Turns this command into a no-op."
msgstr ""
-# type: =item
-#: dh_makeshlibs:73
-msgid "dh_makeshlibs"
+#. type: =item
+#: dh_installwm:46
+msgid "I<wm ...>"
msgstr ""
-# type: verbatim
-#: dh_makeshlibs:75
-#, no-wrap
+#. type: textblock
+#: dh_installwm:48
msgid ""
-"Assuming this is a package named libfoobar1, generates a shlibs file that\n"
-"looks something like:\n"
-" libfoobar 1 libfoobar1\n"
-"\n"
+"The commands used to run the window manager or window managers you want to "
+"register."
msgstr ""
-# type: =item
-#: dh_makeshlibs:79
-msgid "dh_makeshlibs -V"
+#. type: textblock
+#: dh_installxfonts:5
+msgid "dh_installxfonts - register X fonts"
msgstr ""
-# type: verbatim
-#: dh_makeshlibs:81
-#, no-wrap
-msgid ""
-"Assuming the current version of the package is 1.1-3, generates a shlibs\n"
-"file that looks something like:\n"
-" libfoobar 1 libfoobar1 (>= 1.1)\n"
-"\n"
+#. type: textblock
+#: dh_installxfonts:14
+msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
msgstr ""
-# type: =item
-#: dh_makeshlibs:85
-msgid "dh_makeshlibs -V 'libfoobar1 (>= 1.0)'"
+#. type: textblock
+#: dh_installxfonts:18
+msgid ""
+"dh_installxfonts is a debhelper program that is responsible for registering "
+"X fonts, so their corresponding fonts.dir, fonts.alias, and fonts.scale be "
+"rebuilt properly at install time."
msgstr ""
-# type: verbatim
-#: dh_makeshlibs:87
-#, no-wrap
+#. type: textblock
+#: dh_installxfonts:22
msgid ""
-"Generates a shlibs file that looks something like:\n"
-" libfoobar 1 libfoobar1 (>= 1.0)\n"
-"\n"
+"Before calling this program, you should have installed any X fonts provided "
+"by your package into the appropriate location in the package build "
+"directory, and if you have fonts.alias or fonts.scale files, you should "
+"install them into the correct location under etc/X11/fonts in your package "
+"build directory."
msgstr ""
-# type: textblock
-#: dh_perl:5
-msgid "dh_perl - calculates perl dependencies"
+#. type: textblock
+#: dh_installxfonts:28
+msgid ""
+"Your package should depend on xfonts-utils so that the update-fonts-* "
+"commands are available. (This program adds that dependency to "
+"${misc:Depends}.)"
msgstr ""
-# type: textblock
-#: dh_perl:16
-msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs ...>>]"
+#. type: textblock
+#: dh_installxfonts:32
+msgid ""
+"This program automatically generates the postinst and postrm commands needed "
+"to register X fonts. These commands are inserted into the maintainer scripts "
+"by dh_installdeb. See L<dh_installdeb(1)> for an explanation of how this "
+"works."
msgstr ""
-# type: textblock
-#: dh_perl:20
+#. type: textblock
+#: dh_installxfonts:39
msgid ""
-"dh_perl is a debhelper program that is responsible for generating the "
-"${perl:Depends} substitutions and adding them to substvars files."
+"See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
+"L<update-fonts-dir(8)> for more information about X font installation."
msgstr ""
-# type: textblock
-#: dh_perl:23
+#. type: textblock
+#: dh_installxfonts:42
msgid ""
-"The program will look at perl scripts and modules in your package, and will "
-"use this information to generate a dependency on perl or perlapi. The "
-"dependency will be substituted into your package's control file wherever you "
-"place the token \"${perl:Depends}\"."
+"See Debian policy, section 11.8.5. for details about doing fonts the Debian "
+"way."
msgstr ""
-# type: =item
-#: dh_perl:32
-msgid "B<-d>"
+#. type: textblock
+#: dh_link:5
+msgid "dh_link - create symlinks in package build directories"
msgstr ""
-# type: textblock
-#: dh_perl:34
+#. type: textblock
+#: dh_link:15
msgid ""
-"In some specific cases you may want to depend on perl-base rather than the "
-"full perl package. If so, you can pass the -d option to make dh_perl "
-"generate a dependency on the correct base package. This is only necessary "
-"for some packages that are included in the base system."
+"B<dh_link> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<source "
+"destination ...>>]"
msgstr ""
-# type: textblock
-#: dh_perl:39
+#. type: textblock
+#: dh_link:19
msgid ""
-"Note that this flag may cause no dependency on perl-base to be generated at "
-"all. perl-base is Essential, so its dependency can be left out, unless a "
-"versioned dependency is needed."
+"dh_link is a debhelper program that creates symlinks in package build "
+"directories."
msgstr ""
-# type: =item
-#: dh_perl:43
-msgid "B<-V>"
+#. type: textblock
+#: dh_link:22
+msgid ""
+"dh_link accepts a list of pairs of source and destination files. The source "
+"files are the already existing files that will be symlinked from. The "
+"destination files are the symlinks that will be created. There B<must> be an "
+"equal number of source and destination files specified."
msgstr ""
-# type: textblock
-#: dh_perl:45
+#. type: textblock
+#: dh_link:27
msgid ""
-"By default, scripts and architecture independent modules don't depend on any "
-"specific version of perl. The -V option causes the current version of the "
-"perl (or perl-base with -d) package to be specified."
+"The list can be specified in two ways. A file named debian/package.links can "
+"list pairs of files. If you use this file, you should put each pair of files "
+"on its own line, and separate the files within the pair with "
+"whitespace. Also, pairs of files can be specified as parameters - these "
+"pairs will only be created in the package build directory of the first "
+"package dh_link is told to act on. By default, this is the first binary "
+"package in debian/control, but if you use -p, -i, or -a flags, it will be "
+"the first package specified by those flags."
msgstr ""
-# type: =item
-#: dh_perl:49
-msgid "I<library dirs>"
+#. type: textblock
+#: dh_link:36
+msgid ""
+"Be sure you B<do> specify the full filename to both the source and "
+"destination files (unlike you would do if you were using something like "
+"L<ln(1)>)."
msgstr ""
-# type: textblock
-#: dh_perl:51
+#. type: textblock
+#: dh_link:40
msgid ""
-"If your package installs perl modules in non-standard directories, you can "
-"make dh_perl check those directories by passing their names on the command "
-"line. It will only check the vendorlib and vendorarch directories by "
-"default."
+"dh_link will generate symlinks that comply with debian policy - absolute "
+"when policy says they should be absolute, and relative links with as short a "
+"path as possible. It will also create any subdirectories it needs to to put "
+"the symlinks in."
msgstr ""
-# type: textblock
-#: dh_perl:62
-msgid "Perl policy, version 1.18"
+#. type: textblock
+#: dh_link:45
+msgid ""
+"dh_link also scans the package build tree for existing symlinks which do not "
+"conform to debian policy, and corrects them (v4 or later)."
msgstr ""
-# type: textblock
-#: dh_perl:148
-msgid "Brendan O'Dea <bod@debian.org>"
+#. type: textblock
+#: dh_link:54
+msgid ""
+"Create any links specified by command line parameters in ALL packages acted "
+"on, not just the first."
msgstr ""
-# type: textblock
-#: dh_fixperms:5
-msgid "dh_fixperms - fix permissions of files in package build directories"
+#. type: textblock
+#: dh_link:59
+msgid ""
+"Do not correct symlinks that contain \"item\" anywhere in their filename "
+"from being corrected to comply with debian policy."
msgstr ""
-# type: textblock
-#: dh_fixperms:14
-msgid "B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]"
+#. type: =item
+#: dh_link:62
+msgid "I<source destination ...>"
msgstr ""
-# type: textblock
-#: dh_fixperms:18
+#. type: textblock
+#: dh_link:64
msgid ""
-"dh_fixperms is a debhelper program that is responsible for setting the "
-"permissions of files and directories in package build directories to a sane "
-"state -- a state that complies with Debian policy."
-msgstr ""
-
-# type: textblock
-#: dh_fixperms:22
+"Create a file named \"destination\" as a link to a file named \"source\". Do "
+"this in the package build directory of the first package acted on. (Or in "
+"all packages if -A is specified.)"
+msgstr ""
+
+#. type: verbatim
+#: dh_link:72
+#, no-wrap
msgid ""
-"dh_fixperms makes all files in usr/share/doc in the package build directory "
-"(excluding files in the examples/ directory) be mode 644. It also changes "
-"the permissions of all man pages to mode 644. It makes all files be owned by "
-"root, and it removes group and other write permission from all files. It "
-"removes execute permissions from any libraries that have it set. It makes "
-"all files in bin/ directories, /usr/games/ and etc/init.d executable (v4 "
-"only). Finally, it removes the setuid and setgid bits from all files in the "
-"package."
+" dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
+"\n"
msgstr ""
-# type: =item
-#: dh_fixperms:35
-msgid "B<-X>I<item>, B<--exclude> I<item>"
+#. type: textblock
+#: dh_link:74
+msgid "Make bar.1 be a symlink to foo.1"
msgstr ""
-# type: textblock
-#: dh_fixperms:37
+#. type: verbatim
+#: dh_link:76
+#, no-wrap
msgid ""
-"Exclude files that contain \"item\" anywhere in their filename from having "
-"their permissions changed. You may use this option multiple times to build "
-"up a list of things to exclude."
+" dh_link var/lib/foo usr/lib/foo \\\n"
+" usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: dh_link:79
+msgid ""
+"Make /usr/lib/foo/ be a link to /var/lib/foo/, and bar.1 be a symlink to the "
+"foo.1"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_listpackages:5
msgid "dh_listpackages - list binary packages debhelper will act on"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_listpackages:14
msgid "B<dh_listpackages> [S<I<debhelper options>>]"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_listpackages:18
msgid ""
"dh_listpackages is a debhelper program that outputs a list of all binary "
"act on if passed the same options."
msgstr ""
-# type: textblock
-#: dh_installman:5
-msgid "dh_installman - install man pages into package build directories"
+#. type: textblock
+#: dh_makeshlibs:5
+msgid "dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols"
msgstr ""
-# type: textblock
-#: dh_installman:15
-msgid "B<dh_installman> [S<I<debhelper options>>] [S<I<manpage ...>>]"
+#. type: textblock
+#: dh_makeshlibs:14
+msgid ""
+"B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] "
+"[B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]"
msgstr ""
-# type: textblock
-#: dh_installman:19
+#. type: textblock
+#: dh_makeshlibs:18
msgid ""
-"dh_installman is a debhelper program that handles installing man pages into "
-"the correct locations in package build directories. You tell it what man "
-"pages go in your packages, and it figures out where to install them based on "
-"the section field in their .TH line. If you have a properly formatted .TH "
-"line, your man page will be installed into the right directory, with the "
-"right name (this includes proper handling of pages with a subsection, like "
-"\"3perl\", which are placed in man3, and given an extension of "
-"\".3perl\"). If your .TH line is incorrect or missing, the program may guess "
-"wrong based on the file extension."
+"dh_makeshlibs is a debhelper program that automatically scans for shared "
+"libraries, and generates a shlibs file for the libraries it finds."
msgstr ""
-# type: textblock
-#: dh_installman:29
+#. type: textblock
+#: dh_makeshlibs:21
msgid ""
-"It also supports translated man pages, by looking for extensions like .ll.8 "
-"and .ll_LL.8"
+"It also adds a call to ldconfig in the postinst and postrm scripts (in V3 "
+"mode and above only) to any packages in which it finds shared libraries."
msgstr ""
-# type: textblock
-#: dh_installman:32
+#. type: textblock
+#: dh_makeshlibs:24
msgid ""
-"If dh_installman seems to install a man page into the wrong section or with "
-"the wrong extension, this is because the man page has the wrong section "
-"listed in its .TH line. Edit the man page and correct the section, and "
-"dh_installman will follow suit. See to L<man(7)> for details about the .TH "
-"section. If dh_installman seems to install a man page into a directory like "
-"/usr/share/man/pl/man1/, that is because your program has a name like "
-"\"foo.pl\", and dh_installman assumes that means it is translated into "
-"Polish. There is currently no support for resolving this ambiguity; programs "
-"in debian should probably not have extensions like that anyway."
+"If a L<dpkg-gensymbols(1)> symbol file is found in debian/package.symbols "
+"(or debian/package.symbols.arch), dpkg-gensymbols will be called to process "
+"and install the symbols file."
+msgstr ""
+
+#. type: =item
+#: dh_makeshlibs:32
+msgid "B<-m>I<major>, B<--major=>I<major>"
msgstr ""
-# type: textblock
-#: dh_installman:42
+#. type: textblock
+#: dh_makeshlibs:34
msgid ""
-"Any man page filenames specified as parameters will be installed into the "
-"first package dh_installman is told to act on. By default, this is the first "
-"binary package in debian/control, but if you use -p, -i, or -a flags, it "
-"will be the first package specified by those flags."
+"Instead of trying to guess the major number of the library with objdump, use "
+"the major number specified after the -m parameter. This is much less useful "
+"than it used to be, back in the bad old days when this program looked at "
+"library filenames rather than using objdump."
msgstr ""
-# type: textblock
-#: dh_installman:47
+#. type: =item
+#: dh_makeshlibs:39
+msgid "B<-V>, B<-V>I<dependencies>"
+msgstr ""
+
+#. type: =item
+#: dh_makeshlibs:41
+msgid "B<--version-info>, B<--version-info=>I<dependencies>"
+msgstr ""
+
+#. type: textblock
+#: dh_makeshlibs:43
msgid ""
-"Files named debian/package.manpages can list other man pages to be "
-"installed."
+"By default, the shlibs file generated by this program does not make packages "
+"depend on any particular version of the package containing the shared "
+"library. It may be necessary for you to add some version dependancy "
+"information to the shlibs file. If -V is specified with no dependency "
+"information, the current upstream version of the package is plugged into a "
+"dependency that looks like \"packagename (>= packageversion)\". Note that in "
+"debhelper compatibility levels before v4, the debian part of the package "
+"version number is also included. If -V is specified with parameters, the "
+"parameters can be used to specify the exact dependency information needed "
+"(be sure to include the package name)."
msgstr ""
-# type: textblock
-#: dh_installman:50
+#. type: textblock
+#: dh_makeshlibs:54
msgid ""
-"After the man page installation step, dh_installman will check to see if any "
-"of the man pages in the temporary directories of any of the packages it is "
-"acting on contain \".so\" links. If so, it changes them to symlinks."
+"Beware of using -V without any parameters; this is a conservative setting "
+"that always ensures that other packages' shared library dependencies are at "
+"least as tight as they need to be (unless your library is prone to changing "
+"ABI without updating the upstream version number), so that if the maintainer "
+"screws up then they won't break. The flip side is that packages might end up "
+"with dependencies that are too tight and so find it harder to be upgraded."
msgstr ""
-# type: =item
-#: dh_installman:63
-msgid "I<manpage ...>"
+#. type: textblock
+#: dh_makeshlibs:68
+msgid ""
+"Exclude files that contain \"item\" anywhere in their filename or directory "
+"from being treated as shared libraries."
msgstr ""
-# type: textblock
-#: dh_installman:65
+#. type: =item
+#: dh_makeshlibs:71
+msgid "B<--add-udeb=>I<udeb>"
+msgstr ""
+
+#. type: textblock
+#: dh_makeshlibs:73
msgid ""
-"Install these man pages into the first package acted on. (Or in all packages "
-"if -A is specified)."
+"Create an additional line for udebs in the shlibs file and use \"udeb\" as "
+"the package name for udebs to depend on instead of the regular library "
+"package."
msgstr ""
-# type: textblock
-#: dh_installman:72
+#. type: textblock
+#: dh_makeshlibs:78
+msgid "Pass \"params\" to L<dpkg-gensymbols(1)>."
+msgstr ""
+
+#. type: =item
+#: dh_makeshlibs:86
+msgid "dh_makeshlibs"
+msgstr ""
+
+#. type: verbatim
+#: dh_makeshlibs:88
+#, no-wrap
msgid ""
-"An older version of this program, L<dh_installmanpages(1)>, is still used by "
-"some packages, and so is still included in debhelper. It is, however, "
-"deprecated, due to its counterintuitive and inconsistent interface. Use this "
-"program instead."
+"Assuming this is a package named libfoobar1, generates a shlibs file that\n"
+"looks something like:\n"
+" libfoobar 1 libfoobar1\n"
+"\n"
msgstr ""
-# type: textblock
-#: dh_testroot:5
-msgid "dh_testroot - ensure that a package is built as root"
+#. type: =item
+#: dh_makeshlibs:92
+msgid "dh_makeshlibs -V"
msgstr ""
-# type: textblock
-#: dh_testroot:9
-msgid "B<dh_testroot> [S<I<debhelper options>>]"
+#. type: verbatim
+#: dh_makeshlibs:94
+#, no-wrap
+msgid ""
+"Assuming the current version of the package is 1.1-3, generates a shlibs\n"
+"file that looks something like:\n"
+" libfoobar 1 libfoobar1 (>= 1.1)\n"
+"\n"
msgstr ""
-# type: textblock
-#: dh_testroot:13
+#. type: =item
+#: dh_makeshlibs:98
+msgid "dh_makeshlibs -V 'libfoobar1 (>= 1.0)'"
+msgstr ""
+
+#. type: verbatim
+#: dh_makeshlibs:100
+#, no-wrap
msgid ""
-"dh_testroot simply checks to see if you are root. If not, it exits with an "
-"error. Debian packages must be built as root, though you can use "
-"L<fakeroot(1)>"
+"Generates a shlibs file that looks something like:\n"
+" libfoobar 1 libfoobar1 (>= 1.0)\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: dh_md5sums:5
+msgid "dh_md5sums - generate DEBIAN/md5sums file"
+msgstr ""
+
+#. type: textblock
+#: dh_md5sums:15
+msgid ""
+"B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] "
+"[B<--include-conffiles>]"
+msgstr ""
+
+#. type: textblock
+#: dh_md5sums:19
+msgid ""
+"dh_md5sums is a debhelper program that is responsible for generating a "
+"DEBIAN/md5sums file, which lists the md5sums of each file in the package. "
+"These files are used by the debsums package."
+msgstr ""
+
+#. type: textblock
+#: dh_md5sums:23
+msgid ""
+"All files in DEBIAN/ are omitted from the md5sums file, as are all conffiles "
+"(unless you use the --include-conffiles switch)."
+msgstr ""
+
+#. type: textblock
+#: dh_md5sums:26
+msgid "The md5sums file is installed with proper permissions and ownerships."
+msgstr ""
+
+#. type: =item
+#: dh_md5sums:32
+msgid "B<-x>, B<--include-conffiles>"
+msgstr ""
+
+#. type: textblock
+#: dh_md5sums:34
+msgid ""
+"Include conffiles in the md5sums list. Note that this information is "
+"redundant since it is included elsewhere in debian packages."
msgstr ""
-# type: textblock
+#. type: textblock
+#: dh_md5sums:39
+msgid ""
+"Exclude files that contain \"item\" anywhere in their filename from being "
+"listed in the md5sums file."
+msgstr ""
+
+#. type: textblock
#: dh_movefiles:5
msgid "dh_movefiles - move files out of debian/tmp into subpackages"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_movefiles:14
msgid ""
"B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] "
"[B<-X>I<item>] S<I<file ...>>]"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_movefiles:18
msgid ""
"dh_movefiles is a debhelper program that is responsible for moving files out "
"everything into debian/tmp, and you need to break that up into subpackages."
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_movefiles:23
msgid ""
"Files named debian/package.files list the files to be moved, separated by "
"apply to the first package dh_movefiles is told to act on."
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_movefiles:29
msgid ""
-"Note: dh_install is a much better program that can do everything this one "
-"can, and more."
+"Note: dh_install is a much better program, and you are recommended to use it "
+"instead of dh_movefiles."
msgstr ""
-# type: =item
+#. type: =item
#: dh_movefiles:36
msgid "B<--sourcedir=>I<dir>"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_movefiles:38
msgid ""
"Instead of moving files out of debian/tmp (the default), this option makes "
"it move files out of some other directory. Since the entire contents of the "
-"sourcedir is moved, specifiying something like --sourcedir=/ is very unsafe, "
+"sourcedir is moved, specifying something like --sourcedir=/ is very unsafe, "
"so to prevent mistakes, the sourcedir must be a relative filename; it cannot "
"begin with a `/'."
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_movefiles:51
msgid ""
"Lists files to move. The filenames listed should be relative to "
"tell dh_movefiles which subpackage to put them in."
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_movefiles:60
msgid ""
"Note that files are always moved out of debian/tmp by default (even if you "
"by dh_clean later."
msgstr ""
-# type: textblock
-#: dh_desktop:5
-msgid "dh_desktop - Register .desktop files"
+#. type: textblock
+#: dh_perl:5
+msgid "dh_perl - calculates perl dependencies and cleans up after MakeMaker"
msgstr ""
-# type: textblock
-#: dh_desktop:14
-msgid "B<dh_desktop> [S<I<debhelper options>>] [B<-p<package>>]"
+#. type: textblock
+#: dh_perl:16
+msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs ...>>]"
msgstr ""
-# type: textblock
-#: dh_desktop:18
+#. type: textblock
+#: dh_perl:20
msgid ""
-"dh_desktop is a debhelper program that registers .desktop files. Currently "
-"this program does not handle installation of the files, though it may do so "
-"at a later date. It takes care of adding maintainer script fragments to call "
-"F<update-desktop-database>."
+"dh_perl is a debhelper program that is responsible for generating the "
+"${perl:Depends} substitutions and adding them to substvars files."
msgstr ""
-# type: textblock
-#: dh_suidregister:5
-msgid "dh_suidregister - obsolete suid registration program"
+#. type: textblock
+#: dh_perl:23
+msgid ""
+"The program will look at perl scripts and modules in your package, and will "
+"use this information to generate a dependency on perl or perlapi. The "
+"dependency will be substituted into your package's control file wherever you "
+"place the token \"${perl:Depends}\"."
msgstr ""
-# type: textblock
-#: dh_suidregister:13
+#. type: textblock
+#: dh_perl:28
msgid ""
-"This program used to register suid and sgid files with L<suidregister(1)>, "
-"but with the introduction of L<dpkg-statoverride(8)>, registration of files "
-"in this way is unnecessary, and even harmful, so this program should not be "
-"used."
+"dh_perl also cleans up empty directories that MakeMaker can generate when "
+"installing perl modules."
msgstr ""
-# type: =head1
-#: dh_suidregister:18
-msgid "CONVERTING TO STATOVERRIDE"
+#. type: =item
+#: dh_perl:35
+msgid "B<-d>"
msgstr ""
-# type: textblock
-#: dh_suidregister:20
+#. type: textblock
+#: dh_perl:37
msgid ""
-"Converting a package that uses this program to use the new statoverride "
-"mechanism is easy. Just remove the call to dh_suidregister from "
-"debian/rules, and add a versioned conflicts into your control file, as "
-"follows:"
+"In some specific cases you may want to depend on perl-base rather than the "
+"full perl package. If so, you can pass the -d option to make dh_perl "
+"generate a dependency on the correct base package. This is only necessary "
+"for some packages that are included in the base system."
msgstr ""
-# type: verbatim
-#: dh_suidregister:25
-#, no-wrap
+#. type: textblock
+#: dh_perl:42
msgid ""
-" Conflicts: suidmanager (<< 0.50)\n"
-"\n"
+"Note that this flag may cause no dependency on perl-base to be generated at "
+"all. perl-base is Essential, so its dependency can be left out, unless a "
+"versioned dependency is needed."
msgstr ""
-# type: textblock
-#: dh_suidregister:27
-msgid ""
-"The conflicts is only necessary if your package used to register things with "
-"suidmanager; if it did not, you can just remove the call to this program "
-"from your rules file."
+#. type: =item
+#: dh_perl:46
+msgid "B<-V>"
msgstr ""
-# type: textblock
-#: dh_installchangelogs:5
-msgid "dh_installchangelogs - install changelogs into package build directories"
+#. type: textblock
+#: dh_perl:48
+msgid ""
+"By default, scripts and architecture independent modules don't depend on any "
+"specific version of perl. The -V option causes the current version of the "
+"perl (or perl-base with -d) package to be specified."
msgstr ""
-# type: textblock
-#: dh_installchangelogs:14
-msgid "B<dh_installchangelogs> [<S<I<debhelper options>>] [B<-k>] [I<upstream>]"
+#. type: =item
+#: dh_perl:52
+msgid "I<library dirs>"
msgstr ""
-# type: textblock
-#: dh_installchangelogs:18
+#. type: textblock
+#: dh_perl:54
msgid ""
-"dh_installchangelogs is a debhelper program that is responsible for "
-"installing changelogs into package build directories."
+"If your package installs perl modules in non-standard directories, you can "
+"make dh_perl check those directories by passing their names on the command "
+"line. It will only check the vendorlib and vendorarch directories by "
+"default."
msgstr ""
-# type: textblock
-#: dh_installchangelogs:21
-msgid ""
-"dh_installchangelogs determines if the package is a debian native package, "
-"and if so, it installs debian/changelog into usr/share/doc/package/changelog "
-"in the package build directory. Otherwise, it installs debian/changelog into "
-"usr/share/doc/package/changelog.Debian in the package build directory. (If "
-"files named debian/package.changelog exist, they will be used in preference "
-"to debian/changelog.)"
-msgstr ""
-
-# type: textblock
-#: dh_installchangelogs:28
-msgid ""
-"Parallelling the debian changelog handling, this program also takes care of "
-"NEWS.Debian files. If there is a debian/NEWS file, it is installed as "
-"usr/share/doc/package/NEWS.Debian. debian/package.NEWS files can also be "
-"used."
-msgstr ""
-
-# type: textblock
-#: dh_installchangelogs:33
-msgid ""
-"If an upstream changelog file is specified as an option, then this upstream "
-"changelog will be installed as usr/share/doc/package/changelog in the "
-"package build directory. If the changelog is a html file (determined by file "
-"extension), it will be installed as usr/share/doc/package/changelog.html "
-"instead, and will be converted to plain text with html2text to generate "
-"usr/share/doc/package/changelog."
-msgstr ""
-
-# type: textblock
-#: dh_installchangelogs:46
-msgid ""
-"Keep the original name of the upstream changelog. This will be accomplished "
-"by installing the upstream changelog as \"changelog\", and making a symlink "
-"from that to the original name of the changelog file. This can be useful if "
-"the upstream changelog has an unusual name, or if other documentation in the "
-"package refers to the changelog file."
+#. type: textblock
+#: dh_perl:63 dh_strip:76
+msgid "Debian policy, version 3.0.1"
msgstr ""
-# type: =item
-#: dh_installchangelogs:52
-msgid "I<upstream>"
+#. type: textblock
+#: dh_perl:65
+msgid "Perl policy, version 1.18"
msgstr ""
-# type: textblock
-#: dh_installchangelogs:54
-msgid "Install this file as the upstream changelog."
+#. type: textblock
+#: dh_perl:160
+msgid "Brendan O'Dea <bod@debian.org>"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_python:5
msgid ""
"dh_python - calculates python dependencies and adds postinst and prerm "
"python scripts"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_python:15
msgid ""
"B<dh_python> [S<I<debhelper options>>] [B<-n>] [B<-V> I<version>] "
"[S<I<module dirs ...>>]"
msgstr ""
-# type: textblock
+#. type: textblock
#: dh_python:19
msgid ""
+"Note: This program is deprecated. You should use dh_pysupport or "
+"dh_pycentral instead. This program will do nothing if debian/pycompat or a "
+"Python-Version control file field exists."
+msgstr ""
+
+#. type: textblock
+#: dh_python:23
+msgid ""
"dh_python is a debhelper program that is responsible for generating the "
"${python:Depends} substitutions and adding them to substvars files. It will "
"also add a postinst and a prerm script if required."
msgstr ""
-# type: textblock
-#: dh_python:23
+#. type: textblock
+#: dh_python:27
msgid ""
"The program will look at python scripts and modules in your package, and "
"will use this information to generate a dependency on python, with the "
"package's control file wherever you place the token \"${python:Depends}\"."
msgstr ""
-# type: textblock
-#: dh_python:29
+#. type: textblock
+#: dh_python:33
msgid ""
"If some modules need to be byte-compiled at install time, appropriate "
"postinst and prerm scripts will be generated. If already byte-compiled "
"modules are found, they are removed."
msgstr ""
-# type: textblock
-#: dh_python:33
+#. type: textblock
+#: dh_python:37
msgid "If you use this program, your package should build-depend on python."
msgstr ""
-# type: =item
-#: dh_python:39
+#. type: =item
+#: dh_python:43
msgid "I<module dirs>"
msgstr ""
-# type: textblock
-#: dh_python:41
+#. type: textblock
+#: dh_python:45
msgid ""
"If your package installs python modules in non-standard directories, you can "
"make dh_python check those directories by passing their names on the command "
"/usr/lib/python?.?/site-packages."
msgstr ""
-# type: textblock
-#: dh_python:47
+#. type: textblock
+#: dh_python:51
msgid ""
"Note: only /usr/lib/site-python, /usr/lib/python?.?/site-packages and the "
"extra names on the command line are searched for binary (.so) modules."
msgstr ""
-# type: =item
-#: dh_python:50
+#. type: =item
+#: dh_python:54
msgid "B<-V> I<version>"
msgstr ""
-# type: textblock
-#: dh_python:52
+#. type: textblock
+#: dh_python:56
msgid ""
"If the .py files your package ships are meant to be used by a specific "
"pythonX.Y version, you can use this option to specify the desired version, "
"such as 2.3. Do not use if you ship modules in /usr/lib/site-python."
msgstr ""
-# type: textblock
-#: dh_python:64
+#. type: textblock
+#: dh_python:68
msgid "Debian policy, version 3.5.7"
msgstr ""
-# type: textblock
-#: dh_python:66
+#. type: textblock
+#: dh_python:70
msgid "Python policy, version 0.3.7"
msgstr ""
-# type: textblock
-#: dh_python:274
+#. type: textblock
+#: dh_python:290
msgid "Josselin Mouette <joss@debian.org>"
msgstr ""
-# type: textblock
-#: dh_python:276
+#. type: textblock
+#: dh_python:292
msgid "most ideas stolen from Brendan O'Dea <bod@debian.org>"
msgstr ""
-# type: textblock
-#: dh_installdocs:5
-msgid "dh_installdocs - install documentation into package build directories"
+#. type: textblock
+#: dh_scrollkeeper:5
+msgid "dh_scrollkeeper - deprecated no-op"
msgstr ""
-# type: textblock
-#: dh_installdocs:14
-msgid ""
-"B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-n>] [B<-X>I<item>] "
-"[S<I<file ...>>]"
+#. type: textblock
+#: dh_scrollkeeper:14
+msgid "B<dh_scrollkeeper> [S<I<debhelper options>>] [B<-n>] [S<I<directory>>]"
msgstr ""
-# type: textblock
-#: dh_installdocs:18
+#. type: textblock
+#: dh_scrollkeeper:18
msgid ""
-"dh_installdocs is a debhelper program that is responsible for installing "
-"documentation into usr/share/doc/package in package build directories."
+"dh_scrollkeeper was a debhelper program that handled registering OMF files "
+"for ScrollKeeper. However, it no longer does anything, and is now "
+"deprecated."
msgstr ""
-# type: textblock
-#: dh_installdocs:21
+#. type: textblock
+#: dh_shlibdeps:5
+msgid "dh_shlibdeps - calculate shared library dependencies"
+msgstr ""
+
+#. type: textblock
+#: dh_shlibdeps:15
msgid ""
-"dh_installdocs automatically installs debian/copyright if it exists. If "
-"dh_installdocs is acting on multiple packages, debian/copyright files will "
-"be installed into all packages. However, if you need to have separate "
-"copyright files for different binary packages, you can use files named "
-"debian/package.copyright."
+"B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] "
+"[B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]"
msgstr ""
-# type: textblock
-#: dh_installdocs:27
+#. type: textblock
+#: dh_shlibdeps:19
msgid ""
-"Any filenames specified as parameters will be installed into the first "
-"package dh_installdocs is told to act on. By default, this is the first "
-"binary package in debian/control, but if you use B<-p>, B<-i>, or B<-a> "
-"flags, it will be the first package specified by those flags."
+"dh_shlibdeps is a debhelper program that is responsible for calculating "
+"shared library dependencies for packages."
msgstr ""
-# type: textblock
-#: dh_installdocs:32
+#. type: textblock
+#: dh_shlibdeps:22
msgid ""
-"Also, debian/README.Debian (or debian/README.debian) and debian/TODO, if "
-"they exist, will be installed into the first binary package listed in "
-"debian/control, if dh_installdocs is acting on that package. Note that "
-"debian/TODO will be installed named TODO.Debian, if the package is not a "
-"debian native package. Also note that README.debian is installed as "
-"README.Debian, for consistency. Note that debian/package.README.Debian and "
-"debian/package.TODO can be used to specify files for subpackages."
+"This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it "
+"once for each package listed in the control file, passing it a list of ELF "
+"executables and shared libraries it has found."
msgstr ""
-# type: textblock
-#: dh_installdocs:40
-msgid "Files named debian/package.docs can list other files to be installed."
+#. type: =item
+#: dh_shlibdeps:30
+msgid "B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>"
msgstr ""
-# type: textblock
-#: dh_installdocs:42
+#. type: textblock
+#: dh_shlibdeps:34
+msgid "Pass \"params\" to L<dpkg-shlibdeps(1)>."
+msgstr ""
+
+#. type: textblock
+#: dh_shlibdeps:38
msgid ""
-"Files named debian/package.doc-base, will be installed as doc-base control "
-"files, and will make this program automatically generate the postinst and "
-"prerm commands needed to interface with the doc-base package. Note that the "
-"doc-id will be determined from the \"Document:\" entry in the doc-base "
-"control file in question."
+"Exclude files that contain \"item\" anywhere in their filename from being "
+"passed to dpkg-shlibdeps. This will make their dependencies be ignored. "
+"This may be useful in some situations, but use it with caution. This option "
+"may be used more than once to exclude more than one thing."
+msgstr ""
+
+#. type: =item
+#: dh_shlibdeps:43
+msgid "B<-l>I<directory>[:directory:directory:..]"
msgstr ""
-# type: textblock
-#: dh_installdocs:48
+#. type: textblock
+#: dh_shlibdeps:45
+msgid "With recent versions of dpkg-shlibdeps, this option is generally not needed."
+msgstr ""
+
+#. type: textblock
+#: dh_shlibdeps:48
msgid ""
-"If your package needs to register more than one document, you need multiple "
-"files. To accomplish this, you can use files named debian/package.doc-base.*"
+"Before dpkg-shlibdeps is run, LD_LIBRARY_PATH will have added to it the "
+"specified directory (or directories -- separate with colons). With recent "
+"versions of dpkg-shlibdeps, this is mostly only useful for packages that "
+"build multiple flavors of the same library, or other situations where the "
+"library is installed into a directory not on the regular library search "
+"path."
msgstr ""
-# type: textblock
-#: dh_installdocs:66
+#. type: =item
+#: dh_shlibdeps:55
+msgid "B<-L>I<package>, B<--libpackage=>I<package>"
+msgstr ""
+
+#. type: textblock
+#: dh_shlibdeps:57
msgid ""
-"Exclude files that contain \"item\" anywhere in their filename from being "
-"installed. Note that this includes doc-base files."
+"With recent versions of dpkg-shlibdeps, this option is generally not needed, "
+"unless your package builds multiple flavors of the same library."
msgstr ""
-# type: textblock
-#: dh_installdocs:71
+#. type: textblock
+#: dh_shlibdeps:60
msgid ""
-"Install these files as documentation into the first package acted on. (Or in "
-"all packages if B<-A> is specified)."
+"It tells dpkg-shlibdeps (via its -S parameter) to look first in the package "
+"build directory for the specified package, when searching for libraries, "
+"symbol files, and shlibs files."
msgstr ""
-# type: textblock
-#: dh_installdocs:78
-msgid "This is an example of a debian/package.docs file:"
+#. type: textblock
+#: dh_shlibdeps:68
+msgid ""
+"Suppose that your source package produces libfoo1, libfoo-dev, and "
+"libfoo-bin binary packages. libfoo-bin links against libfoo1, and should "
+"depend on it. In your rules file, first run dh_makeshlibs, then "
+"dh_shlibdeps:"
msgstr ""
-# type: verbatim
-#: dh_installdocs:80
+#. type: verbatim
+#: dh_shlibdeps:72
#, no-wrap
msgid ""
-" README\n"
-" TODO\n"
-" debian/notes-for-maintainers.txt\n"
-" docs/manual.txt\n"
-" docs/manual.pdf\n"
-" docs/manual-html/\n"
+"\tdh_makeshlibs\n"
+"\tdh_shlibdeps\n"
"\n"
msgstr ""
-# type: textblock
-#: dh_installdocs:89
+#. type: textblock
+#: dh_shlibdeps:75
msgid ""
-"Note that dh_installdocs will happily copy entire directory hierarchies if "
-"you ask it to (similar to cp -a). If it is asked to install a directory, it "
-"will install the complete contents of the directory."
+"This will have the effect of generating automatically a shlibs file for "
+"libfoo1, and using that file and the libfoo1 library in the "
+"debian/libfoo1/usr/lib directory to calculate shared library dependency "
+"information."
msgstr ""
-# type: textblock
-#: dh_installdocs:93
+#. type: textblock
+#: dh_shlibdeps:80
msgid ""
-"Note that this command is not idempotent. \"dh_clean B<-k>\" should be "
-"called between invocations of this command. Otherwise, it may cause multiple "
-"instances of the same text to be added to maintainer scripts."
+"If a libbar1 package is also produced, that is an alternate build of libfoo, "
+"and is installed into /usr/lib/bar/, you can make libfoo-bin depend on "
+"libbar1 as follows:"
msgstr ""
-# type: textblock
-#: dh_installcatalogs:5
-msgid "dh_installcatalogs - install and register SGML Catalogs"
+#. type: verbatim
+#: dh_shlibdeps:84
+#, no-wrap
+msgid ""
+"\tdh_shlibdeps -Llibbar1 -l/usr/lib/bar\n"
+"\t\n"
msgstr ""
-# type: textblock
-#: dh_installcatalogs:16
-msgid "B<dh_installcatalogs> [S<I<debhelper options>>] [B<-n>]"
+#. type: textblock
+#: dh_shlibdeps:170
+msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>"
msgstr ""
-# type: textblock
-#: dh_installcatalogs:20
+#. type: textblock
+#: dh_strip:5
+msgid "dh_strip - strip executables, shared libraries, and some static libraries"
+msgstr ""
+
+#. type: textblock
+#: dh_strip:15
msgid ""
-"dh_installcatalogs is a debhelper program that installs and registers SGML "
-"catalogs. (Note: it will be extended for XML catalog registration when "
-"xml-core is available.) It complies with the Debian XML/SGML policy."
+"B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] [--dbg-package=package] "
+"[--keep-debug]"
msgstr ""
-# type: textblock
-#: dh_installcatalogs:25
+#. type: textblock
+#: dh_strip:19
msgid ""
-"The file F<debian/I<package>.sgmlcatalogs> contains the catalogs to be "
-"installed per package. Each line in that file should be of the form "
-"C<source dest>, where C<source> indicates where the catalog resides in the "
-"source tree, and C<dest> indicates the destination location for the catalog "
-"under the package build area. C<dest> should start with "
-"F</usr/share/sgml/>."
+"dh_strip is a debhelper program that is responsible for stripping "
+"executables, shared libraries, and static libraries that are not used for "
+"debugging."
msgstr ""
-# type: textblock
-#: dh_installcatalogs:32
+#. type: textblock
+#: dh_strip:23
msgid ""
-"Catalogs will be registered in a supercatalog, in "
-"F</etc/sgml/I<package>.cat>."
+"This program examines your package build directories and works out what to "
+"strip on its own. It uses L<file(1)> and file permissions and filenames to "
+"figure out what files are shared libraries (*.so), executable binaries, and "
+"static (lib*.a) and debugging libraries (lib*_g.a, debug/*.so), and strips "
+"each as much as is possible. (Which is not at all for debugging libraries.) "
+"In general it seems to make very good guesses, and will do the right thing "
+"in almost all cases."
msgstr ""
-# type: textblock
-#: dh_installcatalogs:35
+#. type: textblock
+#: dh_strip:31
msgid ""
-"This command automatically adds maintainer script snippets for registering "
-"and unregistering the catalogs and \"supercatalogs\" (unless B<-n> is "
-"used). A dependency on B<sgml-base> will be added to C<${misc:Depends}>, so "
-"be sure your package uses that variable in F<debian/control>. See "
-"L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
-"snippets."
+"Since it is very hard to automatically guess if a file is a module, and hard "
+"to determine how to strip a module, dh_strip does not currently deal with "
+"stripping binary modules such as .o files."
msgstr ""
-# type: textblock
-#: dh_installcatalogs:48
-msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
+#. type: textblock
+#: dh_strip:41
+msgid ""
+"Exclude files that contain \"item\" anywhere in their filename from being "
+"stripped. You may use this option multiple times to build up a list of "
+"things to exclude."
msgstr ""
-# type: textblock
-#: dh_installcatalogs:109
-msgid "F</usr/share/doc/sgml-base-doc/>"
+#. type: =item
+#: dh_strip:45
+msgid "B<--dbg-package=>I<package>"
msgstr ""
-# type: textblock
-#: dh_installcatalogs:113
-msgid "Adam Di Carlo <aph@debian.org>"
+#. type: textblock
+#: dh_strip:47
+msgid ""
+"Causes dh_strip to save debug symbols stripped from the packages it acts on "
+"as independent files in the package build directory of the specified "
+"debugging package."
msgstr ""
-# type: textblock
-#: dh_installmanpages:5
-msgid "dh_installmanpages - old-style man page installer"
+#. type: textblock
+#: dh_strip:51
+msgid ""
+"For example, if your packages are libfoo and foo and you want to include a "
+"foo-dbg package with debugging symbols, use dh_strip --dbg-package=foo-dbg."
msgstr ""
-# type: textblock
-#: dh_installmanpages:15
-msgid "B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file ...>>]"
+#. type: textblock
+#: dh_strip:54
+msgid ""
+"Note that this option behaves significantly different in debhelper "
+"compatibility levels 4 and below. Instead of specifying the name of a debug "
+"package to put symbols in, it specifies a package (or packages) which should "
+"have separated debug symbols, and the separated symbols are placed in "
+"packages with \"-dbg\" added to their name."
msgstr ""
-# type: textblock
-#: dh_installmanpages:19
+#. type: =item
+#: dh_strip:60
+msgid "B<-k>, B<--keep-debug>"
+msgstr ""
+
+#. type: textblock
+#: dh_strip:62
msgid ""
-"dh_installmanpages is a debhelper program that is responsible for "
-"automatically installing man pages into usr/share/man/ and usr/X11R6/man/ in "
-"package build directories."
+"Debug symbols will be retained, but split into an independent file in "
+"usr/lib/debug/ in the package build directory. --dbg-package is easier to "
+"use than this option, but this option is more flexible."
msgstr ""
-# type: textblock
-#: dh_installmanpages:23
+#. type: textblock
+#: dh_strip:70
msgid ""
-"This is a DWIM-style program, with an interface unlike the rest of "
-"debhelper. It is deprecated, and you are encouraged to use "
-"L<dh_installman(1)> instead."
+"If the DEB_BUILD_OPTIONS environment variable contains \"nostrip\", nothing "
+"will be stripped, in accordance with Debian policy (section 10.1 "
+"\"Binaries\")."
msgstr ""
-# type: textblock
-#: dh_installmanpages:27
+#. type: textblock
+#: dh_suidregister:5
+msgid "dh_suidregister - obsolete suid registration program"
+msgstr ""
+
+#. type: textblock
+#: dh_suidregister:9 dh_undocumented:14
+msgid "Do not run!"
+msgstr ""
+
+#. type: textblock
+#: dh_suidregister:13
msgid ""
-"dh_installmanpages scans the current directory and all subdirectories for "
-"filenames that look like man pages. (Note that only real files are looked "
-"at; symlinks are ignored.) It uses L<file(1)> to verify that the files are "
-"in the correct format. Then, based on the files' extensions, it installs "
-"them into the correct man directory."
+"This program used to register suid and sgid files with L<suidregister(1)>, "
+"but with the introduction of L<dpkg-statoverride(8)>, registration of files "
+"in this way is unnecessary, and even harmful, so this program should not be "
+"used."
msgstr ""
-# type: textblock
-#: dh_installmanpages:33
+#. type: =head1
+#: dh_suidregister:18
+msgid "CONVERTING TO STATOVERRIDE"
+msgstr ""
+
+#. type: textblock
+#: dh_suidregister:20
msgid ""
-"All filenames specified as parameters will be skipped by "
-"dh_installmanpages. This is useful if by default it installs some man pages "
-"that you do not want to be installed."
+"Converting a package that uses this program to use the new statoverride "
+"mechanism is easy. Just remove the call to dh_suidregister from "
+"debian/rules, and add a versioned conflicts into your control file, as "
+"follows:"
msgstr ""
-# type: textblock
-#: dh_installmanpages:37
+#. type: verbatim
+#: dh_suidregister:25
+#, no-wrap
msgid ""
-"After the man page installation step, dh_installmanpages will check to see "
-"if any of the man pages are \".so\" links. If so, it changes them to "
-"symlinks."
+" Conflicts: suidmanager (<< 0.50)\n"
+"\n"
msgstr ""
-# type: textblock
-#: dh_installmanpages:46
+#. type: textblock
+#: dh_suidregister:27
msgid ""
-"Do not install these files as man pages, even if they look like valid man "
-"pages."
+"The conflicts is only necessary if your package used to register things with "
+"suidmanager; if it did not, you can just remove the call to this program "
+"from your rules file."
msgstr ""
-# type: =head1
-#: dh_installmanpages:51
-msgid "BUGS"
+#. type: textblock
+#: dh_testdir:5
+msgid "dh_testdir - test directory before building debian package"
msgstr ""
-# type: textblock
-#: dh_installmanpages:53
+#. type: textblock
+#: dh_testdir:14
+msgid "B<dh_testdir> [S<I<debhelper options>>] [S<I<file ...>>]"
+msgstr ""
+
+#. type: textblock
+#: dh_testdir:18
msgid ""
-"dh_installmanpages will install the man pages it finds into B<all> packages "
-"you tell it to act on, since it can't tell what package the man pages belong "
-"in. This is almost never what you really want (use -p to work around this, "
-"or use the much better L<dh_installman(1)> program instead)."
+"dh_testdir tries to make sure that you are in the correct directory when "
+"building a debian package. It makes sure that the file debian/control "
+"exists, as well as any other files you specify. If not, it exits with an "
+"error."
msgstr ""
-# type: textblock
-#: dh_installmanpages:58
-msgid "Files ending in I<.man> will be ignored."
+#. type: textblock
+#: dh_testdir:29
+msgid "Test for the existence of these files too."
msgstr ""
-# type: textblock
-#: dh_installmanpages:60
+#. type: textblock
+#: dh_testroot:5
+msgid "dh_testroot - ensure that a package is built as root"
+msgstr ""
+
+#. type: textblock
+#: dh_testroot:9
+msgid "B<dh_testroot> [S<I<debhelper options>>]"
+msgstr ""
+
+#. type: textblock
+#: dh_testroot:13
msgid ""
-"Files specified as parameters that contain spaces in their filenames will "
-"not be processed properly."
+"dh_testroot simply checks to see if you are root. If not, it exits with an "
+"error. Debian packages must be built as root, though you can use "
+"L<fakeroot(1)>"
msgstr ""
-# type: textblock
-#: dh_installxfonts:5
-msgid "dh_installxfonts - register X fonts"
+#. type: textblock
+#: dh_testversion:5
+msgid "dh_testversion - ensure that the correct version of debhelper is installed"
msgstr ""
-# type: textblock
-#: dh_installxfonts:14
-msgid "B<dh_installxfonts> [S<I<debhelper options>>]"
+#. type: textblock
+#: dh_testversion:14
+msgid "B<dh_testversion> [S<I<debhelper options>>] [I<operator>] [I<version>]"
msgstr ""
-# type: textblock
-#: dh_installxfonts:18
+#. type: textblock
+#: dh_testversion:18
+msgid "Note: This program is deprecated. You should use build dependencies instead."
+msgstr ""
+
+#. type: textblock
+#: dh_testversion:21
msgid ""
-"dh_installxfonts is a debhelper program that is responsible for registering "
-"X fonts, so their corresponding fonts.dir, fonts.alias, and fonts.scale be "
-"rebuilt properly at install time."
+"dh_testversion compares the version of debhelper against the version you "
+"specify, and if the condition is not met, exits with an error message."
msgstr ""
-# type: textblock
-#: dh_installxfonts:22
+#. type: textblock
+#: dh_testversion:24
msgid ""
-"Before calling this program, you should have installed any X fonts provided "
-"by your package into the appropriate location in the package build "
-"directory, and if you have fonts.alias or fonts.scale files, you should "
-"install them into the correct location under etc/X11/fonts in your package "
-"build directory."
+"You can use this in your debian/rules files if a new debhelper feature is "
+"introduced, and your package requires that feature to build correctly. Use "
+"debhelper's changelog to figure out the version you need."
msgstr ""
-# type: textblock
-#: dh_installxfonts:28
+#. type: textblock
+#: dh_testversion:28
msgid ""
-"Your package should depend on xutils (>= 4.0.3) so that the update-fonts-* "
-"commands are available. (This program adds that dependency to "
-"${misc:Depends}.)"
+"Be sure not to overuse dh_testversion. If debhelper version 9.5 introduces a "
+"new dh_autofixbugs command, and your package uses it, then if someone tries "
+"to build it with debhelper 1.0, the build will fail anyway when "
+"dh_autofixbugs cannot be found, so there is no need for you to use "
+"dh_testversion."
msgstr ""
-# type: textblock
-#: dh_installxfonts:32
+#. type: =item
+#: dh_testversion:38
+msgid "I<operator>"
+msgstr ""
+
+#. type: textblock
+#: dh_testversion:40
msgid ""
-"This program automatically generates the postinst and postrm commands needed "
-"to register X fonts. See L<dh_installdeb(1)> for an explanation of how this "
-"works."
+"Optional comparison operator used in comparing the versions. If not "
+"specified, \">=\" is used. For descriptions of the comparison operators, see "
+"dpkg --help."
+msgstr ""
+
+#. type: =item
+#: dh_testversion:44
+msgid "I<version>"
msgstr ""
-# type: textblock
-#: dh_installxfonts:38
+#. type: textblock
+#: dh_testversion:46
msgid ""
-"See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and "
-"L<update-fonts-dir(8)> for more information about X font installation."
+"Version number to compare against the current version of debhelper. If not "
+"specified, dh_testversion does nothing."
+msgstr ""
+
+#. type: textblock
+#: dh_undocumented:5
+msgid "dh_undocumented - obsolete undocumented.7 symlink program"
msgstr ""
-# type: textblock
-#: dh_installxfonts:41
+#. type: textblock
+#: dh_undocumented:18
msgid ""
-"See Debian policy, section 11.8.5. for details about doing fonts the Debian "
-"way."
+"This program used to make symlinks to the undocumented.7 man page for man "
+"pages not present in a package. Debian policy now frowns on use of the "
+"undocumented.7 man page, and so this program does nothing, and should not be "
+"used."
msgstr ""
-# type: textblock
-#: dh_installlogcheck:5
-msgid "dh_installlogcheck - install logcheck rulefiles into etc/logcheck/"
+#. type: textblock
+#: dh_usrlocal:5
+msgid "dh_usrlocal - migrate usr/local directories to maintainer scripts"
msgstr ""
-# type: textblock
-#: dh_installlogcheck:14
-msgid "B<dh_installlogcheck> [S<B<debhelper options>>]"
+#. type: textblock
+#: dh_usrlocal:17
+msgid "B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]"
msgstr ""
-# type: textblock
-#: dh_installlogcheck:18
+#. type: textblock
+#: dh_usrlocal:21
msgid ""
-"dh_installlocgheck is a debhelper program that is responsible for installing "
-"logcheck rule files into subdirectories of etc/logcheck/ in package build "
-"directories. The files debian/package.logcheck.cracking, "
-"debian/package.logcheck.violations, "
-"debian/package.logcheck.violations.ignore, "
-"debian/package.logcheck.ignore.workstation, "
-"debian/package.logcheck.ignore.server and "
-"debian/package.logcheck.ignore.paranoid are installed if present."
+"dh_usrlocal is a debhelper program that can be used for building packages "
+"that will provide a subdirectory in /usr/local when installed."
msgstr ""
-# type: verbatim
-#: dh_installlogcheck:55
-#, no-wrap
+#. type: textblock
+#: dh_usrlocal:24
msgid ""
-"This program is a part of debhelper.\n"
-" \n"
+"It finds subdirectories of usr/local in the package build directory, and "
+"removes them, replacing them with maintainer script snippets (unless B<-n> "
+"is used) to create the directories at install time, and remove them when the "
+"package is removed, in a manner compliant with Debian policy. These snippets "
+"are inserted into the maintainer scripts by dh_installdeb. See "
+"L<dh_installdeb(1)> for an explanation of Debhelper maintainer script "
+"snippets."
msgstr ""
-# type: textblock
-#: dh_installlogcheck:59
-msgid "Jon Middleton <jjm@debian.org>"
+#. type: textblock
+#: dh_usrlocal:32
+msgid ""
+"If the directories found in the build tree have unusual owners, groups, or "
+"permissions, then those values will be preserved in the directories made by "
+"the postinst script. However, as a special exception, if a directory is "
+"owned by root.root, it will be treated as if it is owned by root.staff and "
+"is mode 2775. This is useful, since that is the group and mode policy "
+"recommends for directories in /usr/local."
+msgstr ""
+
+#. type: textblock
+#: dh_usrlocal:45
+msgid "Do not modify F<postinst>/F<prerm> scripts."
+msgstr ""
+
+#. type: textblock
+#: dh_usrlocal:57
+msgid "Debian policy, version 2.2"
+msgstr ""
+
+#. type: textblock
+#: dh_usrlocal:122
+msgid "Andrew Stribblehill <ads@debian.org>"
msgstr ""
projects / debhelper.git / blobdiff