msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2011-02-14 14:22-0400\n"
+"POT-Creation-Date: 2012-05-18 11:05-0400\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"
msgstr ""
#. type: =head1
-#: debhelper.pod:5 dh:12 dh_auto_build:12 dh_auto_clean:12 dh_auto_configure:12 dh_auto_install:15 dh_auto_test:12 dh_bugfiles:12 dh_builddeb:12 dh_clean:12 dh_compress:13 dh_desktop:12 dh_fixperms:12 dh_gconf:12 dh_gencontrol:12 dh_icons:13 dh_install:13 dh_installcatalogs:14 dh_installchangelogs:12 dh_installcron:12 dh_installdeb:12 dh_installdebconf:12 dh_installdirs:12 dh_installdocs:12 dh_installemacsen:12 dh_installexamples:12 dh_installifupdown:12 dh_installinfo:12 dh_installinit:12 dh_installlogcheck:12 dh_installlogrotate:12 dh_installman:13 dh_installmanpages:13 dh_installmenu:12 dh_installmime:12 dh_installmodules:14 dh_installpam:12 dh_installppp:12 dh_installudev:13 dh_installwm:12 dh_installxfonts:12 dh_link:13 dh_lintian:12 dh_listpackages:12 dh_makeshlibs:12 dh_md5sums:13 dh_movefiles:12 dh_perl:14 dh_prep:12 dh_python:13 dh_scrollkeeper:12 dh_shlibdeps:13 dh_strip:13 dh_suidregister:7 dh_testdir:12 dh_testroot:7 dh_undocumented:12 dh_usrlocal:15
+#: debhelper.pod:5 dh:12 dh_auto_build:12 dh_auto_clean:13 dh_auto_configure:12 dh_auto_install:15 dh_auto_test:13 dh_bugfiles:12 dh_builddeb:12 dh_clean:12 dh_compress:13 dh_desktop:12 dh_fixperms:12 dh_gconf:12 dh_gencontrol:12 dh_icons:13 dh_install:13 dh_installcatalogs:14 dh_installchangelogs:12 dh_installcron:12 dh_installdeb:12 dh_installdebconf:12 dh_installdirs:12 dh_installdocs:12 dh_installemacsen:12 dh_installexamples:12 dh_installifupdown:12 dh_installinfo:12 dh_installinit:12 dh_installlogcheck:12 dh_installlogrotate:12 dh_installman:13 dh_installmanpages:13 dh_installmenu:12 dh_installmime:12 dh_installmodules:14 dh_installpam:12 dh_installppp:12 dh_installudev:13 dh_installwm:12 dh_installxfonts:12 dh_link:13 dh_lintian:12 dh_listpackages:12 dh_makeshlibs:12 dh_md5sums:13 dh_movefiles:12 dh_perl:14 dh_prep:12 dh_python:13 dh_scrollkeeper:12 dh_shlibdeps:13 dh_strip:13 dh_suidregister:7 dh_testdir:12 dh_testroot:7 dh_undocumented:12 dh_usrlocal:15
msgid "SYNOPSIS"
msgstr ""
msgstr ""
#. type: =head1
-#: debhelper.pod:9 dh:16 dh_auto_build:16 dh_auto_clean:16 dh_auto_configure:16 dh_auto_install:19 dh_auto_test:16 dh_bugfiles:16 dh_builddeb:16 dh_clean:16 dh_compress:17 dh_desktop:16 dh_fixperms:16 dh_gconf:16 dh_gencontrol:16 dh_icons:17 dh_install:17 dh_installcatalogs:18 dh_installchangelogs:16 dh_installcron:16 dh_installdeb:16 dh_installdebconf:16 dh_installdirs:16 dh_installdocs:16 dh_installemacsen:16 dh_installexamples:16 dh_installifupdown:16 dh_installinfo:16 dh_installinit:16 dh_installlogcheck:16 dh_installlogrotate:16 dh_installman:17 dh_installmanpages:17 dh_installmenu:16 dh_installmime:16 dh_installmodules:18 dh_installpam:16 dh_installppp:16 dh_installudev:17 dh_installwm:16 dh_installxfonts:16 dh_link:17 dh_lintian:16 dh_listpackages:16 dh_makeshlibs:16 dh_md5sums:17 dh_movefiles:16 dh_perl:18 dh_prep:16 dh_python:17 dh_scrollkeeper:16 dh_shlibdeps:17 dh_strip:17 dh_suidregister:11 dh_testdir:16 dh_testroot:11 dh_undocumented:16 dh_usrlocal:19
+#: debhelper.pod:9 dh:16 dh_auto_build:16 dh_auto_clean:17 dh_auto_configure:16 dh_auto_install:19 dh_auto_test:17 dh_bugfiles:16 dh_builddeb:16 dh_clean:16 dh_compress:17 dh_desktop:16 dh_fixperms:16 dh_gconf:16 dh_gencontrol:16 dh_icons:17 dh_install:17 dh_installcatalogs:18 dh_installchangelogs:16 dh_installcron:16 dh_installdeb:16 dh_installdebconf:16 dh_installdirs:16 dh_installdocs:16 dh_installemacsen:16 dh_installexamples:16 dh_installifupdown:16 dh_installinfo:16 dh_installinit:16 dh_installlogcheck:16 dh_installlogrotate:16 dh_installman:17 dh_installmanpages:17 dh_installmenu:16 dh_installmime:16 dh_installmodules:18 dh_installpam:16 dh_installppp:16 dh_installudev:17 dh_installwm:16 dh_installxfonts:16 dh_link:17 dh_lintian:16 dh_listpackages:16 dh_makeshlibs:16 dh_md5sums:17 dh_movefiles:16 dh_perl:18 dh_prep:16 dh_python:17 dh_scrollkeeper:16 dh_shlibdeps:17 dh_strip:17 dh_suidregister:11 dh_testdir:16 dh_testroot:11 dh_undocumented:16 dh_usrlocal:19
msgid "DESCRIPTION"
msgstr ""
#. type: textblock
#: debhelper.pod:72
msgid ""
-"Note that if a package is the first (or only) binary package listed in "
-"F<debian/control>, debhelper will use F<debian/foo> if no "
-"F<debian/package.foo> file can be found."
+"Note for the first (or only) binary package listed in F<debian/control>, "
+"debhelper will use F<debian/foo> when there's no F<debian/package.foo> file."
msgstr ""
#. type: textblock
#. type: textblock
#: debhelper.pod:83
msgid ""
-"In many cases, these config files are used to specify various types of "
+"Mostly, these config files are used to specify lists of 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 (B<?> and B<*> and B<[>I<..>B<]> character classes) in the files."
+"characters (B<?> and B<*> and B<[>I<..>B<]> character classes) in the "
+"files. You can also put comments in these files; lines beginning with B<#> "
+"are ignored."
msgstr ""
#. type: textblock
-#: debhelper.pod:88
+#: debhelper.pod:90
msgid ""
-"You can also put comments in these files; lines beginning with B<#> are "
-"ignored."
+"The syntax of these files is intentionally kept very simple to make them "
+"easy to read, understand, and modify. If you prefer power and complexity, "
+"you can make the file executable, and write a program that outputs whatever "
+"content is appropriate for a given situation. When you do so, the output is "
+"not further processed to expand wildcards or strip comments."
msgstr ""
#. type: =head1
-#: debhelper.pod:91
+#: debhelper.pod:96
msgid "SHARED DEBHELPER OPTIONS"
msgstr ""
#. type: textblock
-#: debhelper.pod:93
+#: debhelper.pod:98
msgid "The following command line options are supported by all debhelper programs."
msgstr ""
#. type: =item
-#: debhelper.pod:97
+#: debhelper.pod:102
msgid "B<-v>, B<--verbose>"
msgstr ""
#. type: textblock
-#: debhelper.pod:99
+#: debhelper.pod:104
msgid "Verbose mode: show all commands that modify the package build directory."
msgstr ""
#. type: =item
-#: debhelper.pod:101 dh:72
+#: debhelper.pod:106 dh:66
msgid "B<--no-act>"
msgstr ""
#. type: textblock
-#: debhelper.pod:103
+#: debhelper.pod:108
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:106
+#: debhelper.pod:111
msgid "B<-a>, B<--arch>"
msgstr ""
#. type: textblock
-#: debhelper.pod:108
+#: debhelper.pod:113
msgid ""
"Act on architecture dependent packages that should be built for the build "
"architecture."
msgstr ""
#. type: =item
-#: debhelper.pod:111
+#: debhelper.pod:116
msgid "B<-i>, B<--indep>"
msgstr ""
#. type: textblock
-#: debhelper.pod:113
+#: debhelper.pod:118
msgid "Act on all architecture independent packages."
msgstr ""
#. type: =item
-#: debhelper.pod:115
+#: debhelper.pod:120
msgid "B<-p>I<package>, B<--package=>I<package>"
msgstr ""
#. type: textblock
-#: debhelper.pod:117
+#: debhelper.pod:122
msgid ""
"Act on the package named I<package>. This option may be specified multiple "
"times to make debhelper operate on a given set of packages."
msgstr ""
#. type: =item
-#: debhelper.pod:120
+#: debhelper.pod:125
msgid "B<-s>, B<--same-arch>"
msgstr ""
#. type: textblock
-#: debhelper.pod:122
+#: debhelper.pod:127
msgid ""
"This used to be a smarter version of the B<-a> flag, but the B<-a> flag is "
"now equally smart."
msgstr ""
#. type: =item
-#: debhelper.pod:125
+#: debhelper.pod:130
msgid "B<-N>I<package>, B<--no-package=>I<package>"
msgstr ""
#. type: textblock
-#: debhelper.pod:127
+#: debhelper.pod:132
msgid ""
"Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option "
"lists the package as one that should be acted on."
msgstr ""
#. type: =item
-#: debhelper.pod:130
+#: debhelper.pod:135
msgid "B<--remaining-packages>"
msgstr ""
#. type: textblock
-#: debhelper.pod:132
+#: debhelper.pod:137
msgid ""
"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 "
msgstr ""
#. type: =item
-#: debhelper.pod:138
+#: debhelper.pod:143
msgid "B<--ignore=>I<file>"
msgstr ""
#. type: textblock
-#: debhelper.pod:140
+#: debhelper.pod:145
msgid ""
"Ignore the specified file. This can be used if F<debian/> contains a "
"debhelper config file that a debhelper command should not act on. Note that "
msgstr ""
#. type: textblock
-#: debhelper.pod:145
+#: debhelper.pod:150
msgid ""
"For example, if upstream ships a F<debian/init> that you don't want "
"B<dh_installinit> to install, use B<--ignore=debian/init>"
msgstr ""
#. type: =item
-#: debhelper.pod:148
+#: debhelper.pod:153
msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>"
msgstr ""
#. type: textblock
-#: debhelper.pod:150
+#: debhelper.pod:155
msgid "Use I<tmpdir> for package build directory. The default is debian/I<package>"
msgstr ""
#. type: =item
-#: debhelper.pod:152
+#: debhelper.pod:157
msgid "B<--mainpackage=>I<package>"
msgstr ""
#. type: textblock
-#: debhelper.pod:154
+#: debhelper.pod:159
msgid ""
"This little-used option changes the package which debhelper considers the "
"\"main package\", that is, the first one listed in F<debian/control>, and "
msgstr ""
#. type: =item
-#: debhelper.pod:159
+#: debhelper.pod:164
msgid "B<-O=>I<option>|I<bundle>"
msgstr ""
#. type: textblock
-#: debhelper.pod:161
+#: debhelper.pod:166
msgid ""
"This is used by L<dh(1)> when passing user-specified options to all the "
"commands it runs. If the command supports the specified option or option "
msgstr ""
#. type: =head1
-#: debhelper.pod:168
+#: debhelper.pod:173
msgid "COMMON DEBHELPER OPTIONS"
msgstr ""
#. type: textblock
-#: debhelper.pod:170
+#: debhelper.pod:175
msgid ""
"The following command line options are supported by some debhelper "
"programs. See the man page of each program for a complete explanation of "
msgstr ""
#. type: =item
-#: debhelper.pod:176
+#: debhelper.pod:181
msgid "B<-n>"
msgstr ""
#. type: textblock
-#: debhelper.pod:178
+#: debhelper.pod:183
msgid "Do not modify F<postinst>, F<postrm>, etc. scripts."
msgstr ""
#. type: =item
-#: debhelper.pod:180 dh_compress:52 dh_install:76 dh_installchangelogs:68 dh_installdocs:75 dh_installexamples:41 dh_link:60 dh_makeshlibs:76 dh_md5sums:37 dh_shlibdeps:30 dh_strip:39
+#: debhelper.pod:185 dh_compress:52 dh_install:81 dh_installchangelogs:68 dh_installdocs:75 dh_installexamples:41 dh_link:62 dh_makeshlibs:81 dh_md5sums:37 dh_shlibdeps:30 dh_strip:39
msgid "B<-X>I<item>, B<--exclude=>I<item>"
msgstr ""
#. type: textblock
-#: debhelper.pod:182
+#: debhelper.pod:187
msgid ""
"Exclude an item from processing. This option may be used multiple times, to "
"exclude more than one thing."
msgstr ""
#. type: =item
-#: debhelper.pod:185 dh_bugfiles:54 dh_compress:59 dh_installdirs:35 dh_installdocs:70 dh_installexamples:36 dh_installinfo:35 dh_installman:64 dh_link:55
+#: debhelper.pod:190 dh_bugfiles:54 dh_compress:59 dh_installdirs:35 dh_installdocs:70 dh_installexamples:36 dh_installinfo:35 dh_installman:65 dh_link:57
msgid "B<-A>, B<--all>"
msgstr ""
#. type: textblock
-#: debhelper.pod:187
+#: debhelper.pod:192
msgid ""
"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: =head1
-#: debhelper.pod:192
+#: debhelper.pod:197
msgid "BUILD SYSTEM OPTIONS"
msgstr ""
#. type: textblock
-#: debhelper.pod:194
+#: debhelper.pod:199
msgid ""
"The following command line options are supported by all of the "
"B<dh_auto_>I<*> 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."
+"behavior. Typically these are passed to L<dh(1)>, which then passes them to "
+"all the B<dh_auto_>I<*> programs."
msgstr ""
#. type: =item
-#: debhelper.pod:201
+#: debhelper.pod:208
msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>"
msgstr ""
#. type: textblock
-#: debhelper.pod:203
+#: debhelper.pod:210
msgid ""
"Force use of the specified I<buildsystem>, instead of trying to auto-select "
"one which might be applicable for the package."
msgstr ""
#. type: =item
-#: debhelper.pod:206
+#: debhelper.pod:213
msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>"
msgstr ""
#. type: textblock
-#: debhelper.pod:208
+#: debhelper.pod:215
msgid ""
"Assume that the original package source tree is at the specified "
"I<directory> rather than the top level directory of the Debian source "
msgstr ""
#. type: =item
-#: debhelper.pod:212
+#: debhelper.pod:219
msgid "B<-B>[I<directory>], B<--builddirectory=>[I<directory>]"
msgstr ""
#. type: textblock
-#: debhelper.pod:214
+#: debhelper.pod:221
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 "
msgstr ""
#. type: textblock
-#: debhelper.pod:218
+#: debhelper.pod:225
msgid ""
"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 "
msgstr ""
#. type: textblock
-#: debhelper.pod:223
+#: debhelper.pod:230
msgid ""
"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 "
msgstr ""
#. type: =item
-#: debhelper.pod:227
+#: debhelper.pod:234
msgid "B<--parallel>"
msgstr ""
#. type: textblock
-#: debhelper.pod:229
+#: debhelper.pod:236
msgid ""
"Enable parallel builds if underlying build system supports them. The number "
"of parallel jobs is controlled by the B<DEB_BUILD_OPTIONS> environment "
msgstr ""
#. type: textblock
-#: debhelper.pod:234
+#: debhelper.pod:241
msgid ""
"If this option is not specified, debhelper currently defaults to not "
"allowing parallel package builds."
msgstr ""
#. type: =item
-#: debhelper.pod:237
+#: debhelper.pod:244
msgid "B<--max-parallel=>I<maximum>"
msgstr ""
#. type: textblock
-#: debhelper.pod:239
+#: debhelper.pod:246
msgid ""
"This option implies B<--parallel> and allows further limiting the number of "
"jobs that can be used in a parallel build. If the package build is known to "
msgstr ""
#. type: =item
-#: debhelper.pod:244 dh:52
+#: debhelper.pod:251 dh:62
msgid "B<--list>, B<-l>"
msgstr ""
#. type: textblock
-#: debhelper.pod:246
+#: debhelper.pod:253
msgid ""
"List all build systems supported by debhelper on this system. The list "
"includes both default and third party build systems (marked as such). Also "
msgstr ""
#. type: =head1
-#: debhelper.pod:253 dh_auto_test:44 dh_installcatalogs:59 dh_installdocs:116 dh_installemacsen:67 dh_installexamples:53 dh_installinit:133 dh_installman:81 dh_installmime:51 dh_installmodules:60 dh_installudev:55 dh_installwm:54 dh_installxfonts:37 dh_movefiles:64 dh_strip:68 dh_usrlocal:49
-msgid "NOTES"
-msgstr ""
-
-#. type: =head2
-#: debhelper.pod:255
-msgid "Multiple binary package support"
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:257
-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 F<debian/rules> target, and the architecture independent "
-"packages in the binary-indep F<debian/rules> target."
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:265
-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."
-msgstr ""
-
-#. type: =head2
-#: debhelper.pod:271
-msgid "Automatic generation of Debian install scripts"
+#: debhelper.pod:260
+msgid "COMPATIBILITY LEVELS"
msgstr ""
#. type: textblock
-#: debhelper.pod:273
+#: debhelper.pod:262
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 "
-"B<#DEBHELPER#> to your scripts, in the place the code should be added. "
-"B<#DEBHELPER#> will be replaced by any auto-generated code when you run "
-"B<dh_installdeb>."
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:280
-msgid ""
-"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
-#: debhelper.pod:283
-msgid ""
-"All debhelper commands that automatically generate code in this way let it "
-"be disabled by the -n parameter (see above)."
+"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
-#: debhelper.pod:286
+#: debhelper.pod:269
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):"
+"Tell debhelper what compatibility level to use by writing a number to "
+"F<debian/compat>. For example, to turn on v9 mode:"
msgstr ""
#. type: verbatim
-#: debhelper.pod:291
+#: debhelper.pod:272
#, 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"
+" % echo 9 > debian/compat\n"
"\n"
msgstr ""
-#. type: =head2
-#: debhelper.pod:297
-msgid "Automatic generation of miscellaneous dependencies."
-msgstr ""
-
#. type: textblock
-#: debhelper.pod:299
+#: debhelper.pod:274
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."
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:307
-msgid ""
-"All commands of this type, besides documenting what dependencies may be "
-"needed on their man pages, will automatically generate a substvar called "
-"B<${misc:Depends}>. If you put that token into your F<debian/control> file, "
-"it will be expanded to the dependencies debhelper figures you need."
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:312
-msgid ""
-"This is entirely independent of the standard B<${shlibs:Depends}> generated "
-"by L<dh_makeshlibs(1)>, and the B<${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: =head2
-#: debhelper.pod:317
-msgid "Package build directories"
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:319
-msgid ""
-"By default, all debhelper programs assume that the temporary directory used "
-"for assembling the tree of files in a package is debian/I<package>."
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:322
-msgid ""
-"Sometimes, you might want to use some other temporary directory. This is "
-"supported by the B<-P> flag. For example, \"B<dh_installdocs "
-"-Pdebian/tmp>\", will use B<debian/tmp> as the temporary directory. Note "
-"that if you use B<-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 B<-p> flag to specify which binary "
-"package the debhelper program will act on."
-msgstr ""
-
-#. type: =head2
-#: debhelper.pod:330
-msgid "Debhelper compatibility levels"
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:332
-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
-#: debhelper.pod:339
-msgid ""
-"Tell debhelper what compatibility level to use by writing a number to "
-"F<debian/compat>. For example, to turn on v8 mode:"
+"Your package will also need a versioned build dependency on a version of "
+"debhelper equal to (or greater than) the compatibility level your package "
+"uses. So for compatibility level 9, ensure debian/control has:"
msgstr ""
#. type: verbatim
-#: debhelper.pod:342
+#: debhelper.pod:278
#, no-wrap
msgid ""
-" % echo 8 > debian/compat\n"
+" Build-Depends: debhelper (>= 9)\n"
"\n"
msgstr ""
#. type: textblock
-#: debhelper.pod:344
+#: debhelper.pod:280
msgid ""
"Unless otherwise indicated, all debhelper documentation assumes that you are "
"using the most recent compatibility level, and in most cases does not "
msgstr ""
#. type: textblock
-#: debhelper.pod:351
+#: debhelper.pod:287
msgid "These are the available compatibility levels:"
msgstr ""
#. type: =item
-#: debhelper.pod:355
+#: debhelper.pod:291
msgid "v1"
msgstr ""
#. type: textblock
-#: debhelper.pod:357
+#: debhelper.pod:293
msgid ""
"This is the original debhelper compatibility level, and so it is the default "
"one. In this mode, debhelper will use F<debian/tmp> as the package tree "
msgstr ""
#. type: textblock
-#: debhelper.pod:362 debhelper.pod:369 debhelper.pod:392 debhelper.pod:421
+#: debhelper.pod:298 debhelper.pod:305 debhelper.pod:328 debhelper.pod:357
msgid "This mode is deprecated."
msgstr ""
#. type: =item
-#: debhelper.pod:364
+#: debhelper.pod:300
msgid "v2"
msgstr ""
#. type: textblock
-#: debhelper.pod:366
+#: debhelper.pod:302
msgid ""
"In this mode, debhelper will consistently use debian/I<package> as the "
"package tree directory for every package that is built."
msgstr ""
#. type: =item
-#: debhelper.pod:371
+#: debhelper.pod:307
msgid "v3"
msgstr ""
#. type: textblock
-#: debhelper.pod:373
+#: debhelper.pod:309
msgid "This mode works like v2, with the following additions:"
msgstr ""
#. type: =item
-#: debhelper.pod:377 debhelper.pod:382 debhelper.pod:386 debhelper.pod:400 debhelper.pod:405 debhelper.pod:410 debhelper.pod:415 debhelper.pod:429 debhelper.pod:433 debhelper.pod:438 debhelper.pod:442 debhelper.pod:454 debhelper.pod:459 debhelper.pod:465 debhelper.pod:471 debhelper.pod:484 debhelper.pod:491 debhelper.pod:495 debhelper.pod:499 debhelper.pod:514 debhelper.pod:518 debhelper.pod:526
+#: debhelper.pod:313 debhelper.pod:318 debhelper.pod:322 debhelper.pod:336 debhelper.pod:341 debhelper.pod:346 debhelper.pod:351 debhelper.pod:365 debhelper.pod:369 debhelper.pod:374 debhelper.pod:378 debhelper.pod:390 debhelper.pod:395 debhelper.pod:401 debhelper.pod:407 debhelper.pod:420 debhelper.pod:427 debhelper.pod:431 debhelper.pod:435 debhelper.pod:448 debhelper.pod:452 debhelper.pod:460 debhelper.pod:465 debhelper.pod:479 debhelper.pod:484 debhelper.pod:491 debhelper.pod:496 debhelper.pod:501 debhelper.pod:505 debhelper.pod:511 debhelper.pod:516 debhelper.pod:521 debhelper.pod:536
msgid "-"
msgstr ""
#. type: textblock
-#: debhelper.pod:379
+#: debhelper.pod:315
msgid ""
"Debhelper config files support globbing via B<*> and B<?>, when "
"appropriate. To turn this off and use those characters raw, just prefix with "
msgstr ""
#. type: textblock
-#: debhelper.pod:384
+#: debhelper.pod:320
msgid ""
"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call "
"B<ldconfig>."
msgstr ""
#. type: textblock
-#: debhelper.pod:388
+#: debhelper.pod:324
msgid ""
"Every file in F<etc/> is automatically flagged as a conffile by "
"B<dh_installdeb>."
msgstr ""
#. type: =item
-#: debhelper.pod:394
+#: debhelper.pod:330
msgid "v4"
msgstr ""
#. type: textblock
-#: debhelper.pod:396
+#: debhelper.pod:332
msgid "Changes from v3 are:"
msgstr ""
#. type: textblock
-#: debhelper.pod:402
+#: debhelper.pod:338
msgid ""
"B<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
-#: debhelper.pod:407
+#: debhelper.pod:343
msgid ""
"You are encouraged to put the new B<${misc:Depends}> into F<debian/control> "
"to supplement the B<${shlibs:Depends}> field."
msgstr ""
#. type: textblock
-#: debhelper.pod:412
+#: debhelper.pod:348
msgid ""
"B<dh_fixperms> will make all files in F<bin/> directories and in "
"F<etc/init.d> executable."
msgstr ""
#. type: textblock
-#: debhelper.pod:417
+#: debhelper.pod:353
msgid "B<dh_link> will correct existing links to conform with policy."
msgstr ""
#. type: =item
-#: debhelper.pod:423
+#: debhelper.pod:359
msgid "v5"
msgstr ""
#. type: textblock
-#: debhelper.pod:425
+#: debhelper.pod:361
msgid "Changes from v4 are:"
msgstr ""
#. type: textblock
-#: debhelper.pod:431
+#: debhelper.pod:367
msgid "Comments are ignored in debhelper config files."
msgstr ""
#. type: textblock
-#: debhelper.pod:435
+#: debhelper.pod:371
msgid ""
"B<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: textblock
-#: debhelper.pod:440
+#: debhelper.pod:376
msgid "B<dh_installdocs> skips installing empty files."
msgstr ""
#. type: textblock
-#: debhelper.pod:444
+#: debhelper.pod:380
msgid "B<dh_install> errors out if wildcards expand to nothing."
msgstr ""
#. type: =item
-#: debhelper.pod:448
+#: debhelper.pod:384
msgid "v6"
msgstr ""
#. type: textblock
-#: debhelper.pod:450
+#: debhelper.pod:386
msgid "Changes from v5 are:"
msgstr ""
#. type: textblock
-#: debhelper.pod:456
+#: debhelper.pod:392
msgid ""
"Commands that generate maintainer script fragments will order the fragments "
"in reverse order for the F<prerm> and F<postrm> scripts."
msgstr ""
#. type: textblock
-#: debhelper.pod:461
+#: debhelper.pod:397
msgid ""
"B<dh_installwm> will install a slave manpage link for "
"F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> "
msgstr ""
#. type: textblock
-#: debhelper.pod:467
+#: debhelper.pod:403
msgid ""
"B<dh_builddeb> did not previously delete everything matching "
"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as "
msgstr ""
#. type: textblock
-#: debhelper.pod:473
+#: debhelper.pod:409
msgid ""
"B<dh_installman> allows overwriting existing man pages in the package build "
"directory. In previous compatibility levels it silently refuses to do this."
msgstr ""
#. type: =item
-#: debhelper.pod:478
+#: debhelper.pod:414
msgid "v7"
msgstr ""
#. type: textblock
-#: debhelper.pod:480
+#: debhelper.pod:416
msgid "Changes from v6 are:"
msgstr ""
#. type: textblock
-#: debhelper.pod:486
+#: debhelper.pod:422
msgid ""
"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it "
"doesn't find them in the current directory (or wherever you tell it look "
msgstr ""
#. type: textblock
-#: debhelper.pod:493
+#: debhelper.pod:429
msgid "B<dh_clean> will read F<debian/clean> and delete files listed there."
msgstr ""
#. type: textblock
-#: debhelper.pod:497
+#: debhelper.pod:433
msgid "B<dh_clean> will delete toplevel F<*-stamp> files."
msgstr ""
#. type: textblock
-#: debhelper.pod:501
+#: debhelper.pod:437
msgid ""
"B<dh_installchangelogs> will guess at what file is the upstream changelog if "
"none is specified."
msgstr ""
#. type: =item
-#: debhelper.pod:506
+#: debhelper.pod:442
msgid "v8"
msgstr ""
#. type: textblock
-#: debhelper.pod:508
-msgid "This is the recommended mode of operation."
-msgstr ""
-
-#. type: textblock
-#: debhelper.pod:510
+#: debhelper.pod:444
msgid "Changes from v7 are:"
msgstr ""
#. type: textblock
-#: debhelper.pod:516
+#: debhelper.pod:450
msgid "Commands will fail rather than warning when they are passed unknown options."
msgstr ""
#. type: textblock
-#: debhelper.pod:520
+#: debhelper.pod:454
msgid ""
"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it "
"generates shlibs files for. So B<-X> can be used to exclude libraries. "
msgstr ""
#. type: textblock
-#: debhelper.pod:528
+#: debhelper.pod:462
msgid ""
"B<dh> requires the sequence to run be specified as the first parameter, and "
"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo "
msgstr ""
#. type: textblock
-#: debhelper.pod:533
+#: debhelper.pod:467
msgid ""
"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to "
"F<Makefile.PL>."
msgstr ""
-#. type: =head2
-#: debhelper.pod:539
-msgid "udebs"
+#. type: =item
+#: debhelper.pod:471
+msgid "v9"
msgstr ""
#. type: textblock
-#: debhelper.pod:541
+#: debhelper.pod:473
+msgid "This is the recommended mode of operation."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:475
+msgid "Changes from v8 are:"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:481
msgid ""
-"Debhelper includes support for udebs. To create a udeb with debhelper, add "
-"\"B<Package-Type: udeb>\" to the package's stanza in F<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 F<.udeb>, not installing any documentation into a udeb, skipping over "
-"F<preinst>, F<postrm>, F<prerm>, and F<config> scripts, etc."
+"Multiarch support. In particular, B<dh_auto_configure> passes multiarch "
+"directories to autoconf in --libdir and --libexecdir."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:486
+msgid ""
+"dh is aware of the usual dependencies between targets in debian/rules. So, "
+"\"dh binary\" will run any build, build-arch, build-indep, install, etc "
+"targets that exist in the rules file. There's no need to define an explicit "
+"binary target with explicit dependencies on the other targets."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:493
+msgid ""
+"B<dh_strip> compresses debugging symbol files to reduce the installed size "
+"of -dbg packages."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:498
+msgid ""
+"B<dh_auto_configure> does not include the source package name in "
+"--libexecdir when using autoconf."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:503
+msgid "B<dh> does not default to enabling --with=python-support"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:507
+msgid ""
+"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment "
+"variables listed by B<dpkg-buildflags>, unless they are already set."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:513
+msgid ""
+"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS "
+"to perl F<Makefile.PL> and F<Build.PL>"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:518
+msgid ""
+"B<dh_strip> puts separated debug symbols in a location based on their "
+"build-id."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:523
+msgid ""
+"Executable debhelper config files are run and their output used as the "
+"configuration."
+msgstr ""
+
+#. type: =item
+#: debhelper.pod:528
+msgid "v10"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:530
+msgid "This compatibility level is still open for development; use with caution."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:532
+msgid "Changes from v9 are:"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:538
+msgid "None yet.."
+msgstr ""
+
+#. type: =head1
+#: debhelper.pod:544 dh_auto_test:45 dh_installcatalogs:59 dh_installdocs:116 dh_installemacsen:67 dh_installexamples:53 dh_installinit:128 dh_installman:82 dh_installmime:51 dh_installmodules:60 dh_installudev:55 dh_installwm:54 dh_installxfonts:37 dh_movefiles:64 dh_strip:68 dh_usrlocal:49
+msgid "NOTES"
msgstr ""
#. type: =head2
-#: debhelper.pod:548
-msgid "Other notes"
+#: debhelper.pod:546
+msgid "Multiple binary package support"
msgstr ""
#. type: textblock
-#: debhelper.pod:550
+#: debhelper.pod:548
msgid ""
-"In general, if any debhelper program needs a directory to exist under "
-"B<debian/>, it will create it. I haven't bothered to document this in all "
-"the man pages, but for example, B<dh_installdeb> knows to make "
-"debian/I<package>/DEBIAN/ before trying to put files there, "
-"B<dh_installmenu> knows you need a debian/I<package>/usr/share/menu/ before "
-"installing the menu files, etc."
+"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 F<debian/rules> target, and the architecture independent "
+"packages in the binary-indep F<debian/rules> target."
msgstr ""
#. type: textblock
#: debhelper.pod:556
msgid ""
-"Once your package uses debhelper to build, be sure to add debhelper to your "
-"Build-Depends line in F<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:"
+"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: verbatim
+#. type: =head2
#: debhelper.pod:562
+msgid "Automatic generation of Debian install scripts"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:564
+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 "
+"B<#DEBHELPER#> to your scripts, in the place the code should be added. "
+"B<#DEBHELPER#> will be replaced by any auto-generated code when you run "
+"B<dh_installdeb>."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:571
+msgid ""
+"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
+#: debhelper.pod:574
+msgid ""
+"All debhelper commands that automatically generate code in this way let it "
+"be disabled by the -n parameter (see above)."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:577
+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: verbatim
+#: debhelper.pod:582
#, no-wrap
msgid ""
-" Build-Depends: debhelper (>= 7)\n"
+" 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: =head2
+#: debhelper.pod:588
+msgid "Automatic generation of miscellaneous dependencies."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:590
+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 dependent on how debhelper does "
+"things, so debhelper offers a way to automate it."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:598
+msgid ""
+"All commands of this type, besides documenting what dependencies may be "
+"needed on their man pages, will automatically generate a substvar called "
+"B<${misc:Depends}>. If you put that token into your F<debian/control> file, "
+"it will be expanded to the dependencies debhelper figures you need."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:603
+msgid ""
+"This is entirely independent of the standard B<${shlibs:Depends}> generated "
+"by L<dh_makeshlibs(1)>, and the B<${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: =head2
+#: debhelper.pod:608
+msgid "Package build directories"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:610
+msgid ""
+"By default, all debhelper programs assume that the temporary directory used "
+"for assembling the tree of files in a package is debian/I<package>."
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:613
+msgid ""
+"Sometimes, you might want to use some other temporary directory. This is "
+"supported by the B<-P> flag. For example, \"B<dh_installdocs "
+"-Pdebian/tmp>\", will use B<debian/tmp> as the temporary directory. Note "
+"that if you use B<-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 B<-p> flag to specify which binary "
+"package the debhelper program will act on."
+msgstr ""
+
+#. type: =head2
+#: debhelper.pod:621
+msgid "udebs"
+msgstr ""
+
+#. type: textblock
+#: debhelper.pod:623
+msgid ""
+"Debhelper includes support for udebs. To create a udeb with debhelper, add "
+"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. "
+"Debhelper will try to create udebs that comply with debian-installer policy, "
+"by making the generated package files end in F<.udeb>, not installing any "
+"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, "
+"and F<config> scripts, etc."
+msgstr ""
+
#. type: =head1
-#: debhelper.pod:564
+#: debhelper.pod:630
msgid "ENVIRONMENT"
msgstr ""
#. type: =item
-#: debhelper.pod:568
+#: debhelper.pod:634
msgid "B<DH_VERBOSE>"
msgstr ""
#. type: textblock
-#: debhelper.pod:570
+#: debhelper.pod:636
msgid ""
"Set to B<1> to enable verbose mode. Debhelper will output every command it "
"runs that modifies files on the build system."
msgstr ""
#. type: =item
-#: debhelper.pod:573
+#: debhelper.pod:639
msgid "B<DH_COMPAT>"
msgstr ""
#. type: textblock
-#: debhelper.pod:575
+#: debhelper.pod:641
msgid ""
"Temporarily specifies what compatibility level debhelper should run at, "
"overriding any value in F<debian/compat>."
msgstr ""
#. type: =item
-#: debhelper.pod:578
+#: debhelper.pod:644
msgid "B<DH_NO_ACT>"
msgstr ""
#. type: textblock
-#: debhelper.pod:580
+#: debhelper.pod:646
msgid "Set to B<1> to enable no-act mode."
msgstr ""
#. type: =item
-#: debhelper.pod:582
+#: debhelper.pod:648
msgid "B<DH_OPTIONS>"
msgstr ""
#. type: textblock
-#: debhelper.pod:584
+#: debhelper.pod:650
msgid ""
"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."
+"all debhelper commands."
msgstr ""
#. type: textblock
-#: debhelper.pod:588
+#: debhelper.pod:653
msgid ""
-"This is useful in some situations, for example, if you need to pass B<-p> to "
-"all debhelper commands that will be run. One good way to set B<DH_OPTIONS> "
-"is by using \"Target-specific Variable Values\" in your F<debian/rules> "
-"file. See the make documentation for details on doing this."
+"When using L<dh(1)>, it can be passed options that will be passed on to each "
+"debhelper command, which is generally better than using DH_OPTIONS."
msgstr ""
#. type: =item
-#: debhelper.pod:593
+#: debhelper.pod:656
msgid "B<DH_ALWAYS_EXCLUDE>"
msgstr ""
#. type: textblock
-#: debhelper.pod:595
+#: debhelper.pod:658
msgid ""
"If set, this adds the value the variable is set to to the B<-X> options of "
"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will "
msgstr ""
#. type: textblock
-#: debhelper.pod:599
+#: debhelper.pod:662
msgid ""
"This can be useful if you are doing a build from a CVS source tree, in which "
"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from "
msgstr ""
#. type: textblock
-#: debhelper.pod:606
+#: debhelper.pod:669
msgid ""
"Multiple things to exclude can be separated with colons, as in "
"B<DH_ALWAYS_EXCLUDE=CVS:.svn>"
msgstr ""
#. type: =head1
-#: debhelper.pod:611 dh:764 dh_auto_build:47 dh_auto_clean:48 dh_auto_configure:53 dh_auto_install:85 dh_auto_test:58 dh_bugfiles:122 dh_builddeb:91 dh_clean:138 dh_compress:204 dh_desktop:31 dh_fixperms:129 dh_gconf:99 dh_gencontrol:82 dh_icons:65 dh_install:280 dh_installcatalogs:116 dh_installchangelogs:171 dh_installcron:77 dh_installdeb:144 dh_installdebconf:126 dh_installdirs:86 dh_installdocs:307 dh_installemacsen:124 dh_installexamples:106 dh_installifupdown:69 dh_installinfo:77 dh_installinit:275 dh_installlogcheck:66 dh_installlogrotate:50 dh_installman:258 dh_installmanpages:197 dh_installmenu:87 dh_installmime:95 dh_installmodules:124 dh_installpam:59 dh_installppp:65 dh_installudev:115 dh_installwm:108 dh_installxfonts:87 dh_link:226 dh_lintian:57 dh_listpackages:30 dh_makeshlibs:245 dh_md5sums:90 dh_movefiles:170 dh_perl:146 dh_prep:60 dh_python:280 dh_scrollkeeper:28 dh_shlibdeps:171 dh_strip:230 dh_suidregister:117 dh_testdir:44 dh_testroot:27 dh_undocumented:28 dh_usrlocal:114
+#: debhelper.pod:674 dh:893 dh_auto_build:47 dh_auto_clean:50 dh_auto_configure:52 dh_auto_install:85 dh_auto_test:59 dh_bugfiles:122 dh_builddeb:124 dh_clean:142 dh_compress:206 dh_desktop:31 dh_fixperms:127 dh_gconf:99 dh_gencontrol:82 dh_icons:65 dh_install:258 dh_installcatalogs:116 dh_installchangelogs:171 dh_installcron:77 dh_installdeb:144 dh_installdebconf:126 dh_installdirs:86 dh_installdocs:307 dh_installemacsen:124 dh_installexamples:106 dh_installifupdown:69 dh_installinfo:77 dh_installinit:256 dh_installlogcheck:78 dh_installlogrotate:50 dh_installman:261 dh_installmanpages:197 dh_installmenu:87 dh_installmime:95 dh_installmodules:124 dh_installpam:59 dh_installppp:65 dh_installudev:115 dh_installwm:108 dh_installxfonts:87 dh_link:228 dh_lintian:57 dh_listpackages:30 dh_makeshlibs:258 dh_md5sums:90 dh_movefiles:170 dh_perl:146 dh_prep:60 dh_python:280 dh_scrollkeeper:28 dh_shlibdeps:171 dh_strip:242 dh_suidregister:117 dh_testdir:44 dh_testroot:27 dh_undocumented:28 dh_usrlocal:114
msgid "SEE ALSO"
msgstr ""
#. type: =item
-#: debhelper.pod:615
+#: debhelper.pod:678
msgid "F</usr/share/doc/debhelper/examples/>"
msgstr ""
#. type: textblock
-#: debhelper.pod:617
+#: debhelper.pod:680
msgid "A set of example F<debian/rules> files that use debhelper."
msgstr ""
#. type: =item
-#: debhelper.pod:619
+#: debhelper.pod:682
msgid "L<http://kitenet.net/~joey/code/debhelper/>"
msgstr ""
#. type: textblock
-#: debhelper.pod:621
+#: debhelper.pod:684
msgid "Debhelper web site."
msgstr ""
#. type: =head1
-#: debhelper.pod:625 dh:770 dh_auto_build:53 dh_auto_clean:54 dh_auto_configure:59 dh_auto_install:91 dh_auto_test:64 dh_bugfiles:130 dh_builddeb:97 dh_clean:144 dh_compress:210 dh_desktop:37 dh_fixperms:135 dh_gconf:105 dh_gencontrol:88 dh_icons:71 dh_install:286 dh_installcatalogs:122 dh_installchangelogs:177 dh_installcron:83 dh_installdeb:150 dh_installdebconf:132 dh_installdirs:92 dh_installdocs:313 dh_installemacsen:130 dh_installexamples:112 dh_installifupdown:75 dh_installinfo:83 dh_installlogcheck:72 dh_installlogrotate:56 dh_installman:264 dh_installmanpages:203 dh_installmenu:95 dh_installmime:101 dh_installmodules:130 dh_installpam:65 dh_installppp:71 dh_installudev:121 dh_installwm:114 dh_installxfonts:93 dh_link:232 dh_lintian:65 dh_listpackages:36 dh_makeshlibs:251 dh_md5sums:96 dh_movefiles:176 dh_perl:152 dh_prep:66 dh_python:286 dh_scrollkeeper:34 dh_shlibdeps:177 dh_strip:236 dh_suidregister:123 dh_testdir:50 dh_testroot:33 dh_undocumented:34 dh_usrlocal:120
+#: debhelper.pod:688 dh:899 dh_auto_build:53 dh_auto_clean:56 dh_auto_configure:58 dh_auto_install:91 dh_auto_test:65 dh_bugfiles:130 dh_builddeb:130 dh_clean:148 dh_compress:212 dh_desktop:37 dh_fixperms:133 dh_gconf:105 dh_gencontrol:88 dh_icons:71 dh_install:264 dh_installcatalogs:122 dh_installchangelogs:177 dh_installcron:83 dh_installdeb:150 dh_installdebconf:132 dh_installdirs:92 dh_installdocs:313 dh_installemacsen:130 dh_installexamples:112 dh_installifupdown:75 dh_installinfo:83 dh_installlogcheck:84 dh_installlogrotate:56 dh_installman:267 dh_installmanpages:203 dh_installmenu:95 dh_installmime:101 dh_installmodules:130 dh_installpam:65 dh_installppp:71 dh_installudev:121 dh_installwm:114 dh_installxfonts:93 dh_link:234 dh_lintian:65 dh_listpackages:36 dh_makeshlibs:264 dh_md5sums:96 dh_movefiles:176 dh_perl:152 dh_prep:66 dh_python:286 dh_scrollkeeper:34 dh_shlibdeps:177 dh_strip:248 dh_suidregister:123 dh_testdir:50 dh_testroot:33 dh_undocumented:34 dh_usrlocal:120
msgid "AUTHOR"
msgstr ""
#. type: textblock
-#: debhelper.pod:627 dh:772 dh_auto_build:55 dh_auto_clean:56 dh_auto_configure:61 dh_auto_install:93 dh_auto_test:66 dh_builddeb:99 dh_clean:146 dh_compress:212 dh_fixperms:137 dh_gencontrol:90 dh_install:288 dh_installchangelogs:179 dh_installcron:85 dh_installdeb:152 dh_installdebconf:134 dh_installdirs:94 dh_installdocs:315 dh_installemacsen:132 dh_installexamples:114 dh_installifupdown:77 dh_installinfo:85 dh_installinit:283 dh_installlogrotate:58 dh_installman:266 dh_installmanpages:205 dh_installmenu:97 dh_installmime:103 dh_installmodules:132 dh_installpam:67 dh_installppp:73 dh_installudev:123 dh_installwm:116 dh_installxfonts:95 dh_link:234 dh_listpackages:38 dh_makeshlibs:253 dh_md5sums:98 dh_movefiles:178 dh_prep:68 dh_shlibdeps:179 dh_strip:238 dh_suidregister:125 dh_testdir:52 dh_testroot:35 dh_undocumented:36
+#: debhelper.pod:690 dh:901 dh_auto_build:55 dh_auto_clean:58 dh_auto_configure:60 dh_auto_install:93 dh_auto_test:67 dh_builddeb:132 dh_clean:150 dh_compress:214 dh_fixperms:135 dh_gencontrol:90 dh_install:266 dh_installchangelogs:179 dh_installcron:85 dh_installdeb:152 dh_installdebconf:134 dh_installdirs:94 dh_installdocs:315 dh_installemacsen:132 dh_installexamples:114 dh_installifupdown:77 dh_installinfo:85 dh_installinit:264 dh_installlogrotate:58 dh_installman:269 dh_installmanpages:205 dh_installmenu:97 dh_installmime:103 dh_installmodules:132 dh_installpam:67 dh_installppp:73 dh_installudev:123 dh_installwm:116 dh_installxfonts:95 dh_link:236 dh_listpackages:38 dh_makeshlibs:266 dh_md5sums:98 dh_movefiles:178 dh_prep:68 dh_shlibdeps:179 dh_strip:250 dh_suidregister:125 dh_testdir:52 dh_testroot:35 dh_undocumented:36
msgid "Joey Hess <joeyh@debian.org>"
msgstr ""
#: dh:14
msgid ""
"B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] "
-"[B<--until> I<cmd>] [B<--before> I<cmd>] [B<--after> I<cmd>] "
-"[B<--remaining>] [S<I<debhelper options>>]"
+"[S<I<debhelper options>>]"
msgstr ""
#. type: textblock
"B<install>, B<binary-arch>, B<binary-indep>, and B<binary>."
msgstr ""
-#. type: textblock
+#. type: =head1
#: dh:23
+msgid "OVERRIDE TARGETS"
+msgstr ""
+
+#. type: textblock
+#: dh:25
msgid ""
-"Commands in the B<build-indep>, B<install-indep> and B<binary-indep> "
-"sequences are passed the B<-i> option to ensure they only work on "
-"architecture independent packages, and commands in the B<build-arch>, "
-"B<install-arch> and B<binary-arch> sequences are passed the B<-a> option to "
-"ensure they only work on architecture dependent packages."
+"A F<debian/rules> file using B<dh> can override the command that is run at "
+"any step in a sequence, by defining an override target."
msgstr ""
#. type: textblock
-#: dh:29
+#: dh:28
msgid ""
-"If F<debian/rules> contains a target with a name like "
-"B<override_>I<dh_command>, then when it would normally run I<dh_command>, "
-"B<dh> will instead call that target. The override target can then run the "
-"command with additional options, or run entirely different commands "
-"instead. See examples below. (Note that to use this feature, you should "
-"Build-Depend on debhelper 7.0.50 or above.)"
+"To override I<dh_command>, add a target named B<override_>I<dh_command> to "
+"the rules file. When it would normally run I<dh_command>, B<dh> will instead "
+"call that target. The override target can then run the command with "
+"additional options, or run entirely different commands instead. See examples "
+"below. (Note that to use this feature, you should Build-Depend on debhelper "
+"7.0.50 or above.)"
+msgstr ""
+
+#. type: textblock
+#: dh:36
+msgid ""
+"Override targets can also be defined to run only when building architecture "
+"dependent or architecture independent packages. Use targets with names like "
+"B<override_>I<dh_command>B<-arch> and B<override_>I<dh_command>B<-indep>. "
+"(Note that to use this feature, you should Build-Depend on debhelper 8.9.7 "
+"or above.)"
msgstr ""
#. type: =head1
-#: dh:35 dh_auto_build:28 dh_auto_clean:29 dh_auto_configure:31 dh_auto_install:43 dh_auto_test:30 dh_bugfiles:50 dh_builddeb:21 dh_clean:41 dh_compress:48 dh_fixperms:31 dh_gconf:39 dh_gencontrol:26 dh_icons:25 dh_install:54 dh_installcatalogs:49 dh_installchangelogs:56 dh_installcron:40 dh_installdebconf:61 dh_installdirs:31 dh_installdocs:66 dh_installemacsen:48 dh_installexamples:32 dh_installifupdown:39 dh_installinfo:31 dh_installinit:48 dh_installlogrotate:22 dh_installman:60 dh_installmanpages:40 dh_installmenu:41 dh_installmime:41 dh_installmodules:44 dh_installpam:31 dh_installppp:35 dh_installudev:35 dh_installwm:34 dh_link:51 dh_makeshlibs:38 dh_md5sums:28 dh_movefiles:38 dh_perl:31 dh_prep:26 dh_python:39 dh_shlibdeps:26 dh_strip:35 dh_testdir:23 dh_usrlocal:39
+#: dh:43 dh_auto_build:28 dh_auto_clean:30 dh_auto_configure:31 dh_auto_install:43 dh_auto_test:31 dh_bugfiles:50 dh_builddeb:24 dh_clean:41 dh_compress:48 dh_fixperms:31 dh_gconf:39 dh_gencontrol:26 dh_icons:25 dh_install:59 dh_installcatalogs:49 dh_installchangelogs:56 dh_installcron:40 dh_installdebconf:61 dh_installdirs:31 dh_installdocs:66 dh_installemacsen:48 dh_installexamples:32 dh_installifupdown:39 dh_installinfo:31 dh_installinit:47 dh_installlogcheck:42 dh_installlogrotate:22 dh_installman:61 dh_installmanpages:40 dh_installmenu:41 dh_installmime:41 dh_installmodules:44 dh_installpam:31 dh_installppp:35 dh_installudev:35 dh_installwm:34 dh_link:53 dh_makeshlibs:43 dh_md5sums:28 dh_movefiles:38 dh_perl:31 dh_prep:26 dh_python:39 dh_shlibdeps:26 dh_strip:35 dh_testdir:23 dh_usrlocal:39
msgid "OPTIONS"
msgstr ""
#. type: =item
-#: dh:39
+#: dh:47
msgid "B<--with> I<addon>[B<,>I<addon> ...]"
msgstr ""
#. type: textblock
-#: dh:41
+#: dh:49
msgid ""
"Add the debhelper commands specified by the given addon to appropriate "
"places in the sequence of commands that is run. This option can be repeated "
"addon interface."
msgstr ""
-#. type: =item
-#: dh:48
-msgid "B<--without> I<addon>"
-msgstr ""
-
-#. type: textblock
-#: dh:50
-msgid "The inverse of B<--with>, disables using the given addon."
-msgstr ""
-
-#. type: textblock
-#: dh:54
-msgid "List all available addons."
-msgstr ""
-
#. type: =item
#: dh:56
-msgid "B<--until> I<cmd>"
+msgid "B<--without> I<addon>"
msgstr ""
#. type: textblock
#: dh:58
-msgid "Run commands in the sequence until and including I<cmd>, then stop."
-msgstr ""
-
-#. type: =item
-#: dh:60
-msgid "B<--before> I<cmd>"
-msgstr ""
-
-#. type: textblock
-#: dh:62
-msgid "Run commands in the sequence before I<cmd>, then stop."
-msgstr ""
-
-#. type: =item
-#: dh:64
-msgid "B<--after> I<cmd>"
-msgstr ""
-
-#. type: textblock
-#: dh:66
-msgid "Run commands in the sequence that come after I<cmd>."
-msgstr ""
-
-#. type: =item
-#: dh:68
-msgid "B<--remaining>"
-msgstr ""
-
-#. type: textblock
-#: dh:70
-msgid "Run all commands in the sequence that have yet to be run."
+msgid ""
+"The inverse of B<--with>, disables using the given addon. This option can be "
+"repeated more than once, or multiple addons to disable can be listed, "
+"separated by commas."
msgstr ""
#. type: textblock
-#: dh:74
-msgid "Prints commands that would run for a given sequence, but does not run them."
+#: dh:64
+msgid "List all available addons."
msgstr ""
#. type: textblock
-#: dh:78
-msgid ""
-"All other options passed to B<dh> are passed on to each command it "
-"runs. This can be used to set an option like B<-v> or B<-X> or B<-N>, as "
-"well as for more specialised options."
+#: dh:68
+msgid "Prints commands that would run for a given sequence, but does not run them."
msgstr ""
#. type: textblock
-#: dh:82
+#: dh:72
msgid ""
-"In the above options, I<cmd> can be a full name of a debhelper command, or a "
-"substring. It'll first search for a command in the sequence exactly matching "
-"the name, to avoid any ambiguity. If there are multiple substring matches, "
-"the last one in the sequence will be used."
+"Other options passed to B<dh> are passed on to each command it runs. This "
+"can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for "
+"more specialised options."
msgstr ""
#. type: =head1
-#: dh:113 dh_installdocs:105 dh_link:73 dh_makeshlibs:92 dh_shlibdeps:69
+#: dh:76 dh_installdocs:105 dh_link:75 dh_makeshlibs:97 dh_shlibdeps:69
msgid "EXAMPLES"
msgstr ""
#. type: textblock
-#: dh:115
+#: dh:78
msgid ""
"To see what commands are included in a sequence, without actually doing "
"anything:"
msgstr ""
#. type: verbatim
-#: dh:118
+#: dh:81
#, no-wrap
msgid ""
"\tdh binary-arch --no-act\n"
msgstr ""
#. type: textblock
-#: dh:120
+#: dh:83
msgid ""
"This is a very simple rules file, for packages where the default sequences "
"of commands work with no additional options."
msgstr ""
#. type: verbatim
-#: dh:123 dh:130 dh:144 dh:157
+#: dh:86 dh:107 dh:120
#, no-wrap
msgid ""
"\t#!/usr/bin/make -f\n"
"\n"
msgstr ""
+#. type: textblock
+#: dh:90
+msgid ""
+"Often you'll want to pass an option to a specific debhelper command. The "
+"easy way to do with is by adding an override target for that command."
+msgstr ""
+
#. type: verbatim
-#: dh:127
+#: dh:93 dh:178 dh:189
#, no-wrap
msgid ""
-"Often you'll want to pass an option to a specific debhelper command. The\n"
-"easy way to do with is by adding an override target for that command.\n"
+"\t#!/usr/bin/make -f\n"
+"\t%:\n"
+"\t\tdh $@\n"
"\t\n"
msgstr ""
#. type: verbatim
-#: dh:134
+#: dh:97
#, no-wrap
msgid ""
"\toverride_dh_strip:\n"
"\t\tdh_strip -Xfoo\n"
-"\t\t\n"
+"\t\n"
msgstr ""
#. type: verbatim
-#: dh:137
+#: dh:100
#, no-wrap
msgid ""
-"\toverride_dh_installdocs:\n"
-"\t\tdh_installdocs README TODO\n"
+"\toverride_dh_auto_configure:\n"
+"\t\tdh_auto_configure -- --with-foo --disable-bar\n"
"\n"
msgstr ""
#. type: textblock
-#: dh:140
+#: dh:103
msgid ""
"Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> "
"can't guess what to do for a strange package. Here's how to avoid running "
msgstr ""
#. type: verbatim
-#: dh:148
+#: dh:111
#, no-wrap
msgid ""
"\toverride_dh_auto_configure:\n"
msgstr ""
#. type: verbatim
-#: dh:151
+#: dh:114
#, no-wrap
msgid ""
"\toverride_dh_auto_build:\n"
msgstr ""
#. type: textblock
-#: dh:154
+#: dh:117
msgid ""
"Another common case is wanting to do something manually before or after a "
"particular debhelper command is run."
msgstr ""
#. type: verbatim
-#: dh:161
+#: dh:124
#, no-wrap
msgid ""
"\toverride_dh_fixperms:\n"
msgstr ""
#. type: textblock
-#: dh:165
-msgid ""
-"If your package is a Python package, B<dh> will use B<dh_pysupport> by "
-"default. This is how to use B<dh_pycentral> instead."
-msgstr ""
-
-#. type: verbatim
-#: dh:168
-#, no-wrap
-msgid ""
-"\t#!/usr/bin/make -f\n"
-"\t%:\n"
-"\t\tdh $@ --with python-central\n"
-"\n"
-msgstr ""
-
-#. type: textblock
-#: dh:172
+#: dh:128
msgid ""
"If your package uses autotools and you want to freshen F<config.sub> and "
"F<config.guess> with newer versions from the B<autotools-dev> package at "
msgstr ""
#. type: verbatim
-#: dh:177
+#: dh:133
#, no-wrap
msgid ""
"\t#!/usr/bin/make -f\n"
msgstr ""
#. type: textblock
-#: dh:181
+#: dh:137
msgid ""
-"Here is how to force use of Perl's B<Module::Build> build system, which can "
-"be necessary if debhelper wrongly detects that the package uses MakeMaker."
+"Python tools are not run by dh by default, due to the continual change in "
+"that area. (Before compatibility level v9, dh does run B<dh_pysupport>.) "
+"Here is how to use B<dh_python2>."
msgstr ""
#. type: verbatim
-#: dh:185
+#: dh:141
#, no-wrap
msgid ""
"\t#!/usr/bin/make -f\n"
"\t%:\n"
-"\t\tdh $@ --buildsystem=perl_build\n"
+"\t\tdh $@ --with python2\n"
"\n"
msgstr ""
-#. type: verbatim
-#: dh:189
-#, no-wrap
+#. type: textblock
+#: dh:145
msgid ""
-"To patch your package using quilt, you can tell B<dh> to use quilt's B<dh>\n"
-"sequence addons like this:\n"
-"\t\n"
+"Here is how to force use of Perl's B<Module::Build> build system, which can "
+"be necessary if debhelper wrongly detects that the package uses MakeMaker."
msgstr ""
#. type: verbatim
-#: dh:192
+#: dh:149
#, no-wrap
msgid ""
"\t#!/usr/bin/make -f\n"
"\t%:\n"
-"\t\tdh $@ --with quilt\n"
+"\t\tdh $@ --buildsystem=perl_build\n"
"\n"
msgstr ""
#. type: textblock
-#: dh:196
+#: dh:153
msgid ""
"Here is an example of overriding where the B<dh_auto_>I<*> commands find the "
"package's source, for a package where the source is located in a "
msgstr ""
#. type: verbatim
-#: dh:200
+#: dh:157
#, no-wrap
msgid ""
"\t#!/usr/bin/make -f\n"
msgstr ""
#. type: textblock
-#: dh:204
+#: dh:161
msgid ""
"And here is an example of how to tell the B<dh_auto_>I<*> commands to build "
"in a subdirectory, which will be removed on B<clean>."
msgstr ""
#. type: verbatim
-#: dh:207
+#: dh:164
#, no-wrap
msgid ""
"\t#!/usr/bin/make -f\n"
msgstr ""
#. type: textblock
-#: dh:211
+#: dh:168
msgid ""
"If your package can be built in parallel, you can support parallel building "
"as follows. Then B<dpkg-buildpackage -j> will work."
msgstr ""
#. type: verbatim
-#: dh:214
+#: dh:171
#, no-wrap
msgid ""
"\t#!/usr/bin/make -f\n"
msgstr ""
#. type: textblock
-#: dh:218
+#: dh:175
msgid ""
"Here is a way to prevent B<dh> from running several commands that you don't "
"want it to run, by defining empty override targets for each command."
msgstr ""
#. type: verbatim
-#: dh:221 dh:232 dh:249
+#: dh:182
#, no-wrap
msgid ""
-"\t#!/usr/bin/make -f\n"
-"\t%:\n"
-"\t\tdh $@\n"
-"\t\n"
+"\t# Commands not to run:\n"
+"\toverride_dh_auto_test override_dh_compress override_dh_fixperms:\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: dh:185
+msgid ""
+"A long build process for a separate documentation package can be separated "
+"out using architecture independent overrides. These will be skipped when "
+"running build-arch and binary-arch sequences."
msgstr ""
#. type: verbatim
-#: dh:225
+#: dh:193
#, no-wrap
msgid ""
-"\t# Commands not to run:\n"
-"\toverride_dh_auto_test override_dh_compress override_dh_fixperms:\n"
+"\toverride_dh_auto_build-indep:\n"
+"\t\t$(MAKE) -C docs\n"
"\n"
msgstr ""
-#. type: textblock
-#: dh:228
+#. type: verbatim
+#: dh:196
+#, no-wrap
msgid ""
-"Sometimes, you may need to make an override target only run commands when a "
-"particular package is being built. This can be accomplished using "
-"L<dh_listpackages(1)> to test what is being built. For example:"
+"\t# No tests needed for docs\n"
+"\toverride_dh_auto_test-indep:\n"
+"\n"
msgstr ""
#. type: verbatim
-#: dh:236
+#: dh:199
#, no-wrap
msgid ""
-"\toverride_dh_fixperms:\n"
-"\t\tdh_fixperms\n"
-"\tifneq (,$(filter foo, $(shell dh_listpackages)))\n"
-"\t\tchmod 4755 debian/foo/usr/bin/foo\n"
-"\tendif\n"
+"\toverride_dh_auto_install-indep:\n"
+"\t\t$(MAKE) -C docs install\n"
"\n"
msgstr ""
#. type: textblock
-#: dh:242
+#: dh:202
msgid ""
-"Finally, remember that you are not limited to using override targets in the "
-"rules file when using B<dh>. You can also explicitly define any of the "
-"regular rules file targets when it makes sense to do so. A common reason to "
-"do this is if your package needs different B<build-arch> and B<build-indep> "
-"targets. For example, a package with a long document build process can put "
-"it in B<build-indep> to avoid build daemons redundantly building the "
-"documentation."
+"Adding to the example above, suppose you need to chmod a file, but only when "
+"building the architecture dependent package, as it's not present when "
+"building only documentation."
msgstr ""
#. type: verbatim
-#: dh:253
+#: dh:206
#, no-wrap
msgid ""
-"\tbuild: build-arch build-indep ;\n"
-"\tbuild-indep:\n"
-"\t\t$(MAKE) docs\n"
-"\tbuild-arch:\n"
-"\t\t$(MAKE) bins\n"
+"\toverride_dh_fixperms-arch:\n"
+"\t\tdh_fixperms\n"
+"\t\tchmod 4755 debian/foo/usr/bin/foo\n"
"\n"
msgstr ""
#. type: =head1
-#: dh:259
+#: dh:210
msgid "INTERNALS"
msgstr ""
#. type: textblock
-#: dh:261
+#: dh:212
msgid ""
"If you're curious about B<dh>'s internals, here's how it works under the "
"hood."
msgstr ""
#. type: textblock
-#: dh:263
+#: dh:214
msgid ""
"Each debhelper command will record when it's successfully run in "
"F<debian/package.debhelper.log>. (Which B<dh_clean> deletes.) So B<dh> can "
msgstr ""
#. type: textblock
-#: dh:268
+#: dh:219
msgid ""
"Each time B<dh> is run, it examines the log, and finds the last logged "
"command that is in the specified sequence. It then continues with the next "
msgstr ""
#. type: textblock
-#: dh:273
+#: dh:224
+msgid ""
+"A sequence can also run dependent targets in debian/rules. For example, the "
+"\"binary\" sequence runs the \"install\" target."
+msgstr ""
+
+#. type: textblock
+#: dh:227
msgid ""
"B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass "
"information through to debhelper commands that are run inside override "
msgstr ""
#. type: textblock
-#: dh:766 dh_auto_build:49 dh_auto_clean:50 dh_auto_configure:55 dh_auto_install:87 dh_auto_test:60 dh_builddeb:93 dh_clean:140 dh_compress:206 dh_fixperms:131 dh_gconf:101 dh_gencontrol:84 dh_install:282 dh_installcatalogs:118 dh_installchangelogs:173 dh_installcron:79 dh_installdeb:146 dh_installdebconf:128 dh_installdirs:88 dh_installdocs:309 dh_installemacsen:126 dh_installexamples:108 dh_installifupdown:71 dh_installinfo:79 dh_installinit:277 dh_installlogcheck:68 dh_installlogrotate:52 dh_installman:260 dh_installmanpages:199 dh_installmime:97 dh_installmodules:126 dh_installpam:61 dh_installppp:67 dh_installudev:117 dh_installwm:110 dh_installxfonts:89 dh_link:228 dh_listpackages:32 dh_makeshlibs:247 dh_md5sums:92 dh_movefiles:172 dh_perl:148 dh_prep:62 dh_python:282 dh_strip:232 dh_suidregister:119 dh_testdir:46 dh_testroot:29 dh_undocumented:30 dh_usrlocal:116
+#: dh:232
+msgid ""
+"Commands in the B<build-indep>, B<install-indep> and B<binary-indep> "
+"sequences are passed the B<-i> option to ensure they only work on "
+"architecture independent packages, and commands in the B<build-arch>, "
+"B<install-arch> and B<binary-arch> sequences are passed the B<-a> option to "
+"ensure they only work on architecture dependent packages."
+msgstr ""
+
+#. type: =head1
+#: dh:238
+msgid "DEPRECATED OPTIONS"
+msgstr ""
+
+#. type: textblock
+#: dh:240
+msgid ""
+"The following options are deprecated. It's much better to use override "
+"targets instead."
+msgstr ""
+
+#. type: =item
+#: dh:245
+msgid "B<--until> I<cmd>"
+msgstr ""
+
+#. type: textblock
+#: dh:247
+msgid "Run commands in the sequence until and including I<cmd>, then stop."
+msgstr ""
+
+#. type: =item
+#: dh:249
+msgid "B<--before> I<cmd>"
+msgstr ""
+
+#. type: textblock
+#: dh:251
+msgid "Run commands in the sequence before I<cmd>, then stop."
+msgstr ""
+
+#. type: =item
+#: dh:253
+msgid "B<--after> I<cmd>"
+msgstr ""
+
+#. type: textblock
+#: dh:255
+msgid "Run commands in the sequence that come after I<cmd>."
+msgstr ""
+
+#. type: =item
+#: dh:257
+msgid "B<--remaining>"
+msgstr ""
+
+#. type: textblock
+#: dh:259
+msgid "Run all commands in the sequence that have yet to be run."
+msgstr ""
+
+#. type: textblock
+#: dh:263
+msgid ""
+"In the above options, I<cmd> can be a full name of a debhelper command, or a "
+"substring. It'll first search for a command in the sequence exactly matching "
+"the name, to avoid any ambiguity. If there are multiple substring matches, "
+"the last one in the sequence will be used."
+msgstr ""
+
+#. type: textblock
+#: dh:895 dh_auto_build:49 dh_auto_clean:52 dh_auto_configure:54 dh_auto_install:87 dh_auto_test:61 dh_builddeb:126 dh_clean:144 dh_compress:208 dh_fixperms:129 dh_gconf:101 dh_gencontrol:84 dh_install:260 dh_installcatalogs:118 dh_installchangelogs:173 dh_installcron:79 dh_installdeb:146 dh_installdebconf:128 dh_installdirs:88 dh_installdocs:309 dh_installemacsen:126 dh_installexamples:108 dh_installifupdown:71 dh_installinfo:79 dh_installinit:258 dh_installlogcheck:80 dh_installlogrotate:52 dh_installman:263 dh_installmanpages:199 dh_installmime:97 dh_installmodules:126 dh_installpam:61 dh_installppp:67 dh_installudev:117 dh_installwm:110 dh_installxfonts:89 dh_link:230 dh_listpackages:32 dh_makeshlibs:260 dh_md5sums:92 dh_movefiles:172 dh_perl:148 dh_prep:62 dh_python:282 dh_strip:244 dh_suidregister:119 dh_testdir:46 dh_testroot:29 dh_undocumented:30 dh_usrlocal:116
msgid "L<debhelper(7)>"
msgstr ""
#. type: textblock
-#: dh:768 dh_auto_build:51 dh_auto_clean:52 dh_auto_configure:57 dh_auto_install:89 dh_auto_test:62 dh_bugfiles:128 dh_builddeb:95 dh_clean:142 dh_compress:208 dh_desktop:35 dh_fixperms:133 dh_gconf:103 dh_gencontrol:86 dh_icons:69 dh_install:284 dh_installchangelogs:175 dh_installcron:81 dh_installdeb:148 dh_installdebconf:130 dh_installdirs:90 dh_installdocs:311 dh_installemacsen:128 dh_installexamples:110 dh_installifupdown:73 dh_installinfo:81 dh_installinit:279 dh_installlogrotate:54 dh_installman:262 dh_installmanpages:201 dh_installmenu:93 dh_installmime:99 dh_installmodules:128 dh_installpam:63 dh_installppp:69 dh_installudev:119 dh_installwm:112 dh_installxfonts:91 dh_link:230 dh_lintian:61 dh_listpackages:34 dh_makeshlibs:249 dh_md5sums:94 dh_movefiles:174 dh_perl:150 dh_prep:64 dh_python:284 dh_scrollkeeper:32 dh_shlibdeps:175 dh_strip:234 dh_suidregister:121 dh_testdir:48 dh_testroot:31 dh_undocumented:32 dh_usrlocal:118
+#: dh:897 dh_auto_build:51 dh_auto_clean:54 dh_auto_configure:56 dh_auto_install:89 dh_auto_test:63 dh_bugfiles:128 dh_builddeb:128 dh_clean:146 dh_compress:210 dh_desktop:35 dh_fixperms:131 dh_gconf:103 dh_gencontrol:86 dh_icons:69 dh_install:262 dh_installchangelogs:175 dh_installcron:81 dh_installdeb:148 dh_installdebconf:130 dh_installdirs:90 dh_installdocs:311 dh_installemacsen:128 dh_installexamples:110 dh_installifupdown:73 dh_installinfo:81 dh_installinit:260 dh_installlogrotate:54 dh_installman:265 dh_installmanpages:201 dh_installmenu:93 dh_installmime:99 dh_installmodules:128 dh_installpam:63 dh_installppp:69 dh_installudev:119 dh_installwm:112 dh_installxfonts:91 dh_link:232 dh_lintian:61 dh_listpackages:34 dh_makeshlibs:262 dh_md5sums:94 dh_movefiles:174 dh_perl:150 dh_prep:64 dh_python:284 dh_scrollkeeper:32 dh_shlibdeps:175 dh_strip:246 dh_suidregister:121 dh_testdir:48 dh_testroot:31 dh_undocumented:32 dh_usrlocal:118
msgid "This program is a part of debhelper."
msgstr ""
msgstr ""
#. type: textblock
-#: dh_auto_build:30 dh_auto_clean:31 dh_auto_configure:33 dh_auto_install:45 dh_auto_test:32
+#: dh_auto_build:30 dh_auto_clean:32 dh_auto_configure:33 dh_auto_install:45 dh_auto_test:33
msgid ""
"See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build "
"system selection and control options."
msgstr ""
#. type: =item
-#: dh_auto_build:35 dh_auto_clean:36 dh_auto_configure:38 dh_auto_install:56 dh_auto_test:37 dh_builddeb:35 dh_gencontrol:30 dh_installdebconf:69 dh_installinit:99 dh_makeshlibs:86 dh_shlibdeps:37
+#: dh_auto_build:35 dh_auto_clean:37 dh_auto_configure:38 dh_auto_install:56 dh_auto_test:38 dh_builddeb:38 dh_gencontrol:30 dh_installdebconf:69 dh_installinit:93 dh_makeshlibs:91 dh_shlibdeps:37
msgid "B<--> I<params>"
msgstr ""
#. type: textblock
#: dh_auto_build:37
msgid ""
-"Pass I<params> to the program that is run. These can be used to supplement "
-"or override any standard parameters that B<dh_auto_build> passes."
+"Pass I<params> to the program that is run, after the parameters that "
+"B<dh_auto_build> usually passes."
msgstr ""
#. type: textblock
msgstr ""
#. type: textblock
-#: dh_auto_clean:14
+#: dh_auto_clean:15
msgid ""
"B<dh_auto_clean> [S<I<build system options>>] [S<I<debhelper options>>] "
"[S<B<--> I<params>>]"
msgstr ""
#. type: textblock
-#: dh_auto_clean:18
+#: dh_auto_clean:19
msgid ""
"B<dh_auto_clean> is a debhelper program that tries to automatically clean up "
"after a package build. It does so by running the appropriate command for the "
msgstr ""
#. type: textblock
-#: dh_auto_clean:25
+#: dh_auto_clean:26
msgid ""
"This is intended to work for about 90% of packages. If it doesn't work, or "
"tries to use the wrong clean target, you're encouraged to skip using "
msgstr ""
#. type: textblock
-#: dh_auto_clean:38
+#: dh_auto_clean:39
msgid ""
-"Pass I<params> to the program that is run. These can be used to supplement "
-"or override the any standard parameters that B<dh_auto_clean> passes."
+"Pass I<params> to the program that is run, after the parameters that "
+"B<dh_auto_clean> usually passes."
msgstr ""
#. type: textblock
#. type: textblock
#: dh_auto_configure:40
msgid ""
-"Pass I<params> to the program that is run, after the standard parameters "
-"that B<dh_auto_configure> passes. This can be used to supplement or override "
-"those parameters. For example:"
+"Pass I<params> to the program that is run, after the parameters that "
+"B<dh_auto_configure> usually passes. For example:"
msgstr ""
#. type: verbatim
-#: dh_auto_configure:44
+#: dh_auto_configure:43
#, no-wrap
msgid ""
" dh_auto_configure -- --with-foo --enable-bar\n"
msgstr ""
#. type: =item
-#: dh_auto_install:50 dh_builddeb:25
+#: dh_auto_install:50 dh_builddeb:28
msgid "B<--destdir=>I<directory>"
msgstr ""
#. type: textblock
#: dh_auto_install:58
msgid ""
-"Pass I<params> to the program that is run. These can be used to supplement "
-"or override the any standard parameters that B<dh_auto_install> passes."
+"Pass I<params> to the program that is run, after the parameters that "
+"B<dh_auto_install> usually passes."
msgstr ""
#. type: textblock
msgstr ""
#. type: textblock
-#: dh_auto_test:14
+#: dh_auto_test:15
msgid ""
"B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] "
"[S<B<--> I<params>>]"
msgstr ""
#. type: textblock
-#: dh_auto_test:18
+#: dh_auto_test:19
msgid ""
"B<dh_auto_test> is a debhelper program that tries to automatically run a "
"package's test suite. It does so by running the appropriate command for the "
msgstr ""
#. type: textblock
-#: dh_auto_test:26
+#: dh_auto_test:27
msgid ""
"This is intended to work for about 90% of packages with a test suite. If it "
"doesn't work, you're encouraged to skip using B<dh_auto_test> at all, and "
msgstr ""
#. type: textblock
-#: dh_auto_test:39
+#: dh_auto_test:40
msgid ""
-"Pass I<params> to the program that is run. These can be used to supplement "
-"or override the any standard parameters that B<dh_auto_test> passes."
+"Pass I<params> to the program that is run, after the parameters that "
+"B<dh_auto_test> usually passes."
msgstr ""
#. type: textblock
-#: dh_auto_test:46
+#: dh_auto_test:47
msgid ""
"If the B<DEB_BUILD_OPTIONS> environment variable contains B<nocheck>, no "
"tests will be performed."
msgstr ""
#. type: =head1
-#: dh_bugfiles:22 dh_clean:31 dh_compress:31 dh_gconf:23 dh_install:38 dh_installcatalogs:35 dh_installchangelogs:32 dh_installcron:21 dh_installdeb:22 dh_installdebconf:34 dh_installdirs:21 dh_installdocs:21 dh_installemacsen:27 dh_installexamples:22 dh_installifupdown:22 dh_installinfo:21 dh_installinit:27 dh_installlogcheck:21 dh_installman:50 dh_installmenu:25 dh_installmime:25 dh_installmodules:29 dh_installpam:21 dh_installppp:21 dh_installudev:25 dh_installwm:24 dh_link:39 dh_lintian:21 dh_makeshlibs:24 dh_movefiles:26
+#: dh_bugfiles:22 dh_clean:31 dh_compress:31 dh_gconf:23 dh_install:38 dh_installcatalogs:35 dh_installchangelogs:32 dh_installcron:21 dh_installdeb:22 dh_installdebconf:34 dh_installdirs:21 dh_installdocs:21 dh_installemacsen:27 dh_installexamples:22 dh_installifupdown:22 dh_installinfo:21 dh_installinit:26 dh_installlogcheck:21 dh_installman:51 dh_installmenu:25 dh_installmime:25 dh_installmodules:29 dh_installpam:21 dh_installppp:21 dh_installudev:25 dh_installwm:24 dh_link:41 dh_lintian:21 dh_makeshlibs:29 dh_movefiles:26
msgid "FILES"
msgstr ""
msgstr ""
#. type: textblock
-#: dh_builddeb:27
+#: dh_builddeb:21
+msgid ""
+"It supports building multiple binary packages in parallel, when enabled by "
+"DEB_BUILD_OPTIONS."
+msgstr ""
+
+#. type: textblock
+#: dh_builddeb:30
msgid ""
"Use this if you want the generated F<.deb> files to be put in a directory "
"other than the default of \"F<..>\"."
msgstr ""
#. type: =item
-#: dh_builddeb:30
+#: dh_builddeb:33
msgid "B<--filename=>I<name>"
msgstr ""
#. type: textblock
-#: dh_builddeb:32
+#: dh_builddeb:35
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!"
msgstr ""
#. type: textblock
-#: dh_builddeb:37
+#: dh_builddeb:40
msgid "Pass I<params> to L<dpkg-deb(1)> when it is used to build the package."
msgstr ""
#. type: =item
-#: dh_builddeb:40
+#: dh_builddeb:43
msgid "B<-u>I<params>"
msgstr ""
#. type: textblock
-#: dh_builddeb:42
+#: dh_builddeb:45
msgid ""
"This is another way to pass I<params> to L<dpkg-deb(1)>. It is deprecated; "
"use B<--> instead."
msgstr ""
#. type: =item
-#: dh_icons:29 dh_installcatalogs:53 dh_installdebconf:65 dh_installemacsen:52 dh_installinit:52 dh_installmenu:45 dh_installmime:45 dh_installmodules:48 dh_installudev:49 dh_installwm:44 dh_makeshlibs:72 dh_python:60 dh_usrlocal:43
+#: dh_icons:29 dh_installcatalogs:53 dh_installdebconf:65 dh_installemacsen:52 dh_installinit:51 dh_installmenu:45 dh_installmime:45 dh_installmodules:48 dh_installudev:49 dh_installwm:44 dh_makeshlibs:77 dh_python:60 dh_usrlocal:43
msgid "B<-n>, B<--noscripts>"
msgstr ""
#: dh_install:15
msgid ""
"B<dh_install> [B<-X>I<item>] [B<--autodest>] [B<--sourcedir=>I<dir>] "
-"[S<I<debhelper options>>] [S<I<file> ... I<dest>>]"
+"[S<I<debhelper options>>] [S<I<file|dir> ... I<destdir>>]"
msgstr ""
#. type: textblock
"names of the files to install (in v3 mode and above)."
msgstr ""
+#. type: textblock
+#: dh_install:52
+msgid ""
+"Note that if you list exactly one filename or wildcard-pattern on a line by "
+"itself, with no explicit destination, then B<dh_install> will automatically "
+"guess the destination to use, the same as if the --autodest option were "
+"used."
+msgstr ""
+
#. type: =item
-#: dh_install:58
+#: dh_install:63
msgid "B<--list-missing>"
msgstr ""
#. type: textblock
-#: dh_install:60
+#: dh_install:65
msgid ""
"This option makes B<dh_install> keep track of the files it installs, and "
"then at the end, compare that list with the files in the source "
msgstr ""
#. type: textblock
-#: dh_install:65
+#: dh_install:70
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:68
+#: dh_install:73
msgid ""
"Note that files that are excluded from being moved via the B<-X> option are "
"not warned about."
msgstr ""
#. type: =item
-#: dh_install:71
+#: dh_install:76
msgid "B<--fail-missing>"
msgstr ""
#. type: textblock
-#: dh_install:73
+#: dh_install:78
msgid ""
"This option is like B<--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: textblock
-#: dh_install:78 dh_installexamples:43
+#: dh_install:83 dh_installexamples:43
msgid ""
"Exclude files that contain I<item> anywhere in their filename from being "
"installed."
msgstr ""
#. type: =item
-#: dh_install:81 dh_movefiles:42
+#: dh_install:86 dh_movefiles:42
msgid "B<--sourcedir=>I<dir>"
msgstr ""
#. type: textblock
-#: dh_install:83
+#: dh_install:88
msgid "Look in the specified directory for files to be installed."
msgstr ""
#. type: textblock
-#: dh_install:85
+#: dh_install:90
msgid ""
"Note that this is not the same as the B<--sourcedirectory> option used by "
"the B<dh_auto_>I<*> commands. You rarely need to use this option, since "
-"B<dh_install> automatically looks for files in F<debian/tmp> in debhelper"
-msgstr ""
-
-#. type: textblock
-#: dh_install:89
-msgid "compatibility level 7 and above."
+"B<dh_install> automatically looks for files in F<debian/tmp> in debhelper "
+"compatibility level 7 and above."
msgstr ""
#. type: =item
-#: dh_install:91
+#: dh_install:95
msgid "B<--autodest>"
msgstr ""
#. type: textblock
-#: dh_install:93
+#: dh_install:97
msgid ""
"Guess as the destination directory to install things to. If this is "
"specified, you should not list destination directories in "
msgstr ""
#. type: textblock
-#: dh_install:98
+#: dh_install:102
msgid ""
"Strip off F<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 "
"F<debian/tmp/etc/passwd>, it will be copied to F<debian/package/etc/>."
msgstr ""
-#. type: textblock
-#: dh_install:104
-msgid ""
-"Note that if you list exactly one filename or wildcard-pattern on a line by "
-"itself in a F<debian/package.install> file, with no explicit destination, "
-"then B<dh_install> will automatically guess the destination even if this "
-"flag is not set."
-msgstr ""
-
#. type: =item
-#: dh_install:109
-msgid "I<file> ... I<dest>"
+#: dh_install:108
+msgid "I<file|dir> ... I<destdir>"
msgstr ""
#. type: textblock
-#: dh_install:111
+#: dh_install:110
msgid ""
"Lists files (or directories) to install and where to install them to. The "
"files will be installed into the first package F<dh_install> acts on."
msgstr ""
#. type: =head1
-#: dh_install:253
-msgid "EXAMPLE"
-msgstr ""
-
-#. type: textblock
-#: dh_install:255
-msgid ""
-"Suppose your package's upstream F<Makefile> installs a binary, a man page, "
-"and a library into appropriate subdirectories of F<debian/tmp>. You want to "
-"put the library into package libfoo, and the rest into package foo. Your "
-"rules file will run \"B<dh_install --sourcedir=debian/tmp>\". Make "
-"F<debian/foo.install> contain:"
-msgstr ""
-
-#. type: verbatim
-#: dh_install:261
-#, no-wrap
-msgid ""
-" usr/bin\n"
-" usr/share/man/man1\n"
-"\n"
-msgstr ""
-
-#. type: textblock
-#: dh_install:264
-msgid "While F<debian/libfoo.install> contains:"
-msgstr ""
-
-#. type: verbatim
-#: dh_install:266
-#, no-wrap
-msgid ""
-" usr/lib/libfoo*.so.*\n"
-"\n"
-msgstr ""
-
-#. type: textblock
-#: dh_install:268
-msgid ""
-"If you want a libfoo-dev package too, F<debian/libfoo-dev.install> might "
-"contain:"
-msgstr ""
-
-#. type: verbatim
-#: dh_install:270
-#, no-wrap
-msgid ""
-" usr/include\n"
-" usr/lib/libfoo*.so\n"
-" usr/share/man/man3\n"
-"\n"
-msgstr ""
-
-#. type: =head1
-#: dh_install:274
+#: dh_install:252
msgid "LIMITATIONS"
msgstr ""
#. type: verbatim
-#: dh_install:276
+#: dh_install:254
#, no-wrap
msgid ""
"B<dh_install> cannot rename files or directories, it can only install them\n"
msgstr ""
#. type: textblock
-#: dh_installcatalogs:55 dh_installinit:54
+#: dh_installcatalogs:55 dh_installinit:53
msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts."
msgstr ""
#. type: textblock
-#: dh_installcatalogs:61 dh_installdocs:122 dh_installemacsen:69 dh_installinit:135 dh_installmime:53 dh_installmodules:62 dh_installudev:57 dh_installwm:56 dh_usrlocal:51
+#: dh_installcatalogs:61 dh_installdocs:122 dh_installemacsen:69 dh_installinit:130 dh_installmime:53 dh_installmodules:62 dh_installudev:57 dh_installwm:56 dh_usrlocal:51
msgid ""
"Note that this command is not idempotent. L<dh_prep(1)> should be called "
"between invocations of this command. Otherwise, it may cause multiple "
msgstr ""
#. type: =item
-#: dh_installcron:44 dh_installifupdown:43 dh_installinit:104 dh_installlogrotate:26 dh_installmodules:52 dh_installpam:35 dh_installppp:39 dh_installudev:39
+#: dh_installcron:44 dh_installifupdown:43 dh_installinit:98 dh_installlogcheck:46 dh_installlogrotate:26 dh_installmodules:52 dh_installpam:35 dh_installppp:39 dh_installudev:39
msgid "B<--name=>I<name>"
msgstr ""
msgid ""
"Note that for your config script to be called by B<dpkg>, your F<postinst> "
"needs to source debconf's confmodule. B<dh_installdebconf> does not install "
-"this statement into the F<postinst> automatically as it it too hard to do it "
+"this statement into the F<postinst> automatically as it is too hard to do it "
"right."
msgstr ""
msgstr ""
#. type: textblock
-#: dh_installdocs:72 dh_installinfo:37 dh_installman:66
+#: dh_installdocs:72 dh_installinfo:37 dh_installman:67
msgid ""
"Install all files specified by command line parameters in ALL packages acted "
"on."
msgstr ""
#. type: textblock
-#: dh_installemacsen:54 dh_usrlocal:45
+#: dh_installemacsen:54 dh_python:62 dh_usrlocal:45
msgid "Do not modify F<postinst>/F<prerm> scripts."
msgstr ""
#. type: textblock
#: dh_installinit:5
msgid ""
-"dh_installinit - install upstart jobs or init scripts into package build "
+"dh_installinit - install init scripts and/or upstart jobs into package build "
"directories"
msgstr ""
#: dh_installinit:14
msgid ""
"B<dh_installinit> [S<I<debhelper options>>] [B<--name=>I<name>] [B<-n>] "
-"[B<-R>] [B<-r>] [B<-d>] [B<-O>] [S<B<--> I<params>>]"
+"[B<-R>] [B<-r>] [B<-d>] [S<B<--> I<params>>]"
msgstr ""
#. type: textblock
#: dh_installinit:18
msgid ""
"B<dh_installinit> is a debhelper program that is responsible for installing "
-"upstart job files or init scripts with associated defaults files into "
-"package build directories, and in the former case providing compatibility "
-"handling for non-upstart systems."
+"init scripts with associated defaults files, as well as upstart job files "
+"into package build directories."
msgstr ""
#. type: textblock
-#: dh_installinit:23
+#: dh_installinit:22
msgid ""
"It also automatically generates the F<postinst> and F<postrm> and F<prerm> "
-"commands needed to set up the symlinks in F</etc/rc*.d/> and to start and "
-"stop the init scripts."
+"commands needed to set up the symlinks in F</etc/rc*.d/> to start and stop "
+"the init scripts."
msgstr ""
#. type: =item
-#: dh_installinit:31
-msgid "debian/I<package>.upstart"
+#: dh_installinit:30
+msgid "debian/I<package>.init"
msgstr ""
#. type: textblock
-#: dh_installinit:33
+#: dh_installinit:32
msgid ""
-"If this exists, it is installed into etc/init/I<package>.conf in the package "
+"If this exists, it is installed into etc/init.d/I<package> in the package "
"build directory."
msgstr ""
#. type: =item
-#: dh_installinit:36
-msgid "debian/I<package>.init"
+#: dh_installinit:35
+msgid "debian/I<package>.default"
msgstr ""
#. type: textblock
-#: dh_installinit:38
+#: dh_installinit:37
msgid ""
-"Otherwise, if this exists, it is installed into etc/init.d/I<package> in the "
-"package build directory."
+"If this exists, it is installed into etc/default/I<package> in the package "
+"build directory."
msgstr ""
#. type: =item
-#: dh_installinit:41
-msgid "debian/I<package>.default"
+#: dh_installinit:40
+msgid "debian/I<package>.upstart"
msgstr ""
#. type: textblock
-#: dh_installinit:43
+#: dh_installinit:42
msgid ""
-"If this exists, it is installed into etc/default/I<package> in the package "
+"If this exists, it is installed into etc/init/I<package>.conf in the package "
"build directory."
msgstr ""
#. type: =item
-#: dh_installinit:56
+#: dh_installinit:55
msgid "B<-o>, B<--onlyscripts>"
msgstr ""
#. type: textblock
-#: dh_installinit:58
+#: dh_installinit:57
msgid ""
"Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install "
"any init script, default files, or upstart job. May be useful if the init "
"doesn't make it easy to let B<dh_installinit> find it."
msgstr ""
-#. type: textblock
-#: dh_installinit:63
-msgid ""
-"If no upstart job file is installed in the target directory when "
-"B<dh_installinit --onlyscripts> is called, this program will assume that an "
-"init script is being installed and not provide the compatibility symlinks or "
-"upstart dependencies."
-msgstr ""
-
#. type: =item
-#: dh_installinit:68
+#: dh_installinit:62
msgid "B<-R>, B<--restart-after-upgrade>"
msgstr ""
#. type: textblock
-#: dh_installinit:70
+#: dh_installinit:64
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 "
msgstr ""
#. type: textblock
-#: dh_installinit:74
+#: dh_installinit:68
msgid ""
"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 "
msgstr ""
#. type: =item
-#: dh_installinit:79
+#: dh_installinit:73
msgid "B<-r>, B<--no-restart-on-upgrade>"
msgstr ""
#. type: textblock
-#: dh_installinit:81
+#: dh_installinit:75
msgid "Do not stop init script on upgrade."
msgstr ""
#. type: =item
-#: dh_installinit:83
+#: dh_installinit:77
msgid "B<--no-start>"
msgstr ""
#. type: textblock
-#: dh_installinit:85
+#: dh_installinit:79
msgid ""
"Do not start the init script on install or upgrade, or stop it on removal. "
"Only call B<update-rc.d>. Useful for rcS scripts."
msgstr ""
#. type: =item
-#: dh_installinit:88
+#: dh_installinit:82
msgid "B<-d>, B<--remove-d>"
msgstr ""
#. type: textblock
-#: dh_installinit:90
+#: dh_installinit:84
msgid ""
"Remove trailing B<d> from the name of the package, and use the result for "
-"the filename the upstart job file is installed as in F<etc/init/> , or for "
+"the filename the upstart job file is installed as in F<etc/init/> , and for "
"the filename the init script is installed as in etc/init.d and the default "
"file is installed as in F<etc/default/> . This may be useful for daemons "
"with names ending in B<d>. (Note: this takes precedence over the "
msgstr ""
#. type: =item
-#: dh_installinit:97
+#: dh_installinit:91
msgid "B<-u>I<params> B<--update-rcd-params=>I<params>"
msgstr ""
#. type: textblock
-#: dh_installinit:101
+#: dh_installinit:95
msgid ""
"Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> will be "
"passed to L<update-rc.d(8)>."
msgstr ""
#. type: textblock
-#: dh_installinit:106
+#: dh_installinit:100
msgid ""
-"Install the upstart job file or 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, B<dh_installinit> looks for and installs "
-"files named F<debian/package.name.upstart>, F<debian/package.name.init> and "
-"F<debian/package.name.default>, instead of the usual "
-"F<debian/package.upstart>, F<debian/package.init> and "
-"F<debian/package.default>."
+"Install the init script (and default file) as well as upstart job file using "
+"the filename I<name> instead of the default filename, which is the package "
+"name. When this parameter is used, B<dh_installinit> looks for and installs "
+"files named F<debian/package.name.init>, F<debian/package.name.default> and "
+"F<debian/package.name.upstart> instead of the usual F<debian/package.init>, "
+"F<debian/package.default> and F<debian/package.upstart>."
msgstr ""
#. type: =item
-#: dh_installinit:113
+#: dh_installinit:108
msgid "B<--init-script=>I<scriptname>"
msgstr ""
#. type: textblock
-#: dh_installinit:115
+#: dh_installinit:110
msgid ""
"Use I<scriptname> as the filename the init script is installed as in "
"F<etc/init.d/> (and also use it as the filename for the defaults file, if it "
msgstr ""
#. type: textblock
-#: dh_installinit:122
+#: dh_installinit:117
msgid ""
"This parameter is deprecated, use the B<--name> parameter instead. This "
-"parameter will be ignored completely for upstart jobs."
+"parameter is incompatible with the use of upstart jobs."
msgstr ""
#. type: =item
-#: dh_installinit:125
+#: dh_installinit:120
msgid "B<--error-handler=>I<function>"
msgstr ""
#. type: textblock
-#: dh_installinit:127
+#: dh_installinit:122
msgid ""
"Call the named shell I<function> if running the init script fails. The "
"function should be provided in the F<prerm> and F<postinst> scripts, before "
msgstr ""
#. type: =head1
-#: dh_installinit:281
+#: dh_installinit:262
msgid "AUTHORS"
msgstr ""
#. type: textblock
-#: dh_installinit:285
+#: dh_installinit:266
msgid "Steve Langasek <steve.langasek@canonical.com>"
msgstr ""
"subdirectories of F<etc/logcheck/> in package build directories."
msgstr ""
+#. type: textblock
+#: dh_installlogcheck:48
+msgid ""
+"Look for files named F<debian/package.name.logcheck.*> and install them into "
+"the corresponding subdirectories of F<etc/logcheck/>, but use the specified "
+"name instead of that of the package."
+msgstr ""
+
#. type: verbatim
-#: dh_installlogcheck:70
+#: dh_installlogcheck:82
#, no-wrap
msgid ""
"This program is a part of debhelper.\n"
msgstr ""
#. type: textblock
-#: dh_installlogcheck:74
+#: dh_installlogcheck:86
msgid "Jon Middleton <jjm@debian.org>"
msgstr ""
"B<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 B<.TH> line. If you have a properly "
-"formatted B<.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 B<3perl>, which are placed in F<man3>, and given an "
-"extension of F<.3perl>). If your B<.TH> line is incorrect or missing, the "
-"program may guess wrong based on the file extension."
+"based on the section field in their B<.TH> or B<.Dt> line. If you have a "
+"properly formatted B<.TH> or B<.Dt> 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 B<3perl>, which are placed in F<man3>, and "
+"given an extension of F<.3perl>). If your B<.TH> or B<.Dt> line is incorrect "
+"or missing, the program may guess wrong based on the file extension."
msgstr ""
#. type: textblock
msgid ""
"If B<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 B<.TH> line. Edit the man page and correct the section, and "
-"B<dh_installman> will follow suit. See L<man(7)> for details about the "
-"B<.TH> section. If B<dh_installman> seems to install a man page into a "
-"directory like F</usr/share/man/pl/man1/>, that is because your program has "
-"a name like F<foo.pl>, and B<dh_installman> assumes that means it is "
-"translated into Polish. Use B<--language=C> to avoid this."
+"listed in its B<.TH> or B<.Dt> line. Edit the man page and correct the "
+"section, and B<dh_installman> will follow suit. See L<man(7)> for details "
+"about the B<.TH> section, and L<mdoc(7)> for the B<.Dt> section. If "
+"B<dh_installman> seems to install a man page into a directory like "
+"F</usr/share/man/pl/man1/>, that is because your program has a name like "
+"F<foo.pl>, and B<dh_installman> assumes that means it is translated into "
+"Polish. Use B<--language=C> to avoid this."
msgstr ""
#. type: textblock
-#: dh_installman:41
+#: dh_installman:42
msgid ""
"After the man page installation step, B<dh_installman> will check to see if "
"any of the man pages in the temporary directories of any of the packages it "
msgstr ""
#. type: textblock
-#: dh_installman:45
+#: dh_installman:46
msgid ""
"Also, B<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, "
msgstr ""
#. type: =item
-#: dh_installman:54
+#: dh_installman:55
msgid "debian/I<package>.manpages"
msgstr ""
#. type: textblock
-#: dh_installman:56
+#: dh_installman:57
msgid "Lists man pages to be installed."
msgstr ""
#. type: =item
-#: dh_installman:69
+#: dh_installman:70
msgid "B<--language=>I<ll>"
msgstr ""
#. type: textblock
-#: dh_installman:71
+#: dh_installman:72
msgid ""
"Use this to specify that the man pages being acted on are written in the "
"specified language."
msgstr ""
#. type: =item
-#: dh_installman:74
+#: dh_installman:75
msgid "I<manpage> ..."
msgstr ""
#. type: textblock
-#: dh_installman:76
+#: dh_installman:77
msgid ""
"Install these man pages into the first package acted on. (Or in all packages "
"if B<-A> is specified)."
msgstr ""
#. type: textblock
-#: dh_installman:83
+#: dh_installman:84
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, "
msgstr ""
#. type: textblock
-#: dh_installmenu:47 dh_installmime:47 dh_installmodules:50 dh_installudev:51 dh_makeshlibs:74 dh_python:62
+#: dh_installmenu:47 dh_installmime:47 dh_makeshlibs:79
msgid "Do not modify F<postinst>/F<postrm> scripts."
msgstr ""
#: dh_installmodules:23
msgid ""
"Kernel modules are searched for in the package build directory and if found, "
-"F<postinst> and F<postrm> commands are automatically generated to run "
-"B<depmod> and register the modules when the package is installed. These "
-"commands are inserted into the maintainer scripts by L<dh_installdeb(1)>."
+"F<preinst>, F<postinst> and F<postrm> commands are automatically generated "
+"to run B<depmod> and register the modules when the package is installed. "
+"These commands are inserted into the maintainer scripts by "
+"L<dh_installdeb(1)>."
msgstr ""
#. type: =item
"B<dh_installmodules> will warn if these files are present."
msgstr ""
+#. type: textblock
+#: dh_installmodules:50
+msgid "Do not modify F<preinst>/F<postinst>/F<postrm> scripts."
+msgstr ""
+
#. type: textblock
#: dh_installmodules:54
msgid ""
msgid "Sets the priority string of the F<rules.d> symlink. Default is 60."
msgstr ""
+#. type: textblock
+#: dh_installudev:51
+msgid "Do not modify F<preinst>/F<postinst> scripts."
+msgstr ""
+
#. type: textblock
#: dh_installwm:5
msgid "dh_installwm - register a window manager"
#: dh_installwm:18
msgid ""
"B<dh_installwm> is a debhelper program that is responsible for generating "
-"the F<postinst> and F<postrm> commands that register a window manager with "
+"the F<postinst> and F<prerm> 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 "
"F<usr/share/man/man1/> in the package build directory."
#. type: textblock
#: dh_installwm:46
-msgid ""
-"Do not modify F<postinst>/F<postrm> scripts. Turns this command into a "
-"no-op."
+msgid "Do not modify F<postinst>/F<prerm> scripts. Turns this command into a no-op."
msgstr ""
#. type: =item
#. type: textblock
#: dh_link:36
+msgid "Any pre-existing destination files will be replaced with symlinks."
+msgstr ""
+
+#. type: textblock
+#: dh_link:38
msgid ""
"B<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: =item
-#: dh_link:43
+#: dh_link:45
msgid "debian/I<package>.links"
msgstr ""
#. type: textblock
-#: dh_link:45
+#: dh_link:47
msgid ""
"Lists pairs of source and destination files to be symlinked. Each pair "
"should be put on its own line, with the source and destination separated by "
msgstr ""
#. type: textblock
-#: dh_link:57
+#: dh_link:59
msgid ""
"Create any links specified by command line parameters in ALL packages acted "
"on, not just the first."
msgstr ""
#. type: textblock
-#: dh_link:62
+#: dh_link:64
msgid ""
-"Do not correct symlinks that contain I<item> anywhere in their filename from "
-"being corrected to comply with Debian policy."
+"Exclude symlinks that contain I<item> anywhere in their filename from being "
+"corrected to comply with Debian policy."
msgstr ""
#. type: =item
-#: dh_link:65
+#: dh_link:67
msgid "I<source destination> ..."
msgstr ""
#. type: textblock
-#: dh_link:67
+#: dh_link:69
msgid ""
"Create a file named I<destination> as a link to a file named I<source>. Do "
"this in the package build directory of the first package acted on. (Or in "
msgstr ""
#. type: verbatim
-#: dh_link:75
+#: dh_link:77
#, no-wrap
msgid ""
" dh_link usr/share/man/man1/foo.1 usr/share/man/man1/bar.1\n"
msgstr ""
#. type: textblock
-#: dh_link:77
+#: dh_link:79
msgid "Make F<bar.1> be a symlink to F<foo.1>"
msgstr ""
#. type: verbatim
-#: dh_link:79
+#: dh_link:81
#, no-wrap
msgid ""
" dh_link var/lib/foo usr/lib/foo \\\n"
msgstr ""
#. type: textblock
-#: dh_link:82
+#: dh_link:84
msgid ""
"Make F</usr/lib/foo/> be a link to F</var/lib/foo/>, and F<bar.1> be a "
"symlink to the F<foo.1>"
"v3 mode and above only) to any packages in which it finds shared libraries."
msgstr ""
+#. type: textblock
+#: dh_makeshlibs:24
+msgid ""
+"Packages that support multiarch are detected, and a Pre-Dependency on "
+"multiarch-support is set in ${misc:Pre-Depends} ; you should make sure to "
+"put that token into an appropriate place in your debian/control file for "
+"packages supporting multiarch."
+msgstr ""
+
#. type: =item
-#: dh_makeshlibs:28
+#: dh_makeshlibs:33
msgid "debian/I<package>.symbols"
msgstr ""
#. type: =item
-#: dh_makeshlibs:30
+#: dh_makeshlibs:35
msgid "debian/I<package>.symbols.I<arch>"
msgstr ""
#. type: textblock
-#: dh_makeshlibs:32
+#: dh_makeshlibs:37
msgid ""
"These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to be "
"processed and installed. Use the I<arch> specific names if you need to "
msgstr ""
#. type: =item
-#: dh_makeshlibs:42
+#: dh_makeshlibs:47
msgid "B<-m>I<major>, B<--major=>I<major>"
msgstr ""
#. type: textblock
-#: dh_makeshlibs:44
+#: dh_makeshlibs:49
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 "
msgstr ""
#. type: =item
-#: dh_makeshlibs:49
+#: dh_makeshlibs:54
msgid "B<-V>, B<-V>I<dependencies>"
msgstr ""
#. type: =item
-#: dh_makeshlibs:51
+#: dh_makeshlibs:56
msgid "B<--version-info>, B<--version-info=>I<dependencies>"
msgstr ""
#. type: textblock
-#: dh_makeshlibs:53
+#: dh_makeshlibs:58
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 "
+"library. It may be necessary for you to add some version dependency "
"information to the shlibs file. If B<-V> is specified with no dependency "
"information, the current upstream version of the package is plugged into a "
-"dependency that looks like \"I<packagename> B<(=E<gt>> "
+"dependency that looks like \"I<packagename> B<(E<gt>>= "
"I<packageversion>B<)>\". Note that in debhelper compatibility levels before "
"v4, the Debian part of the package version number is also included. If B<-V> "
"is specified with parameters, the parameters can be used to specify the "
msgstr ""
#. type: textblock
-#: dh_makeshlibs:64
+#: dh_makeshlibs:69
msgid ""
"Beware of using B<-V> without any parameters; this is a conservative setting "
"that always ensures that other packages' shared library dependencies are at "
msgstr ""
#. type: textblock
-#: dh_makeshlibs:78
+#: dh_makeshlibs:83
msgid ""
"Exclude files that contain I<item> anywhere in their filename or directory "
"from being treated as shared libraries."
msgstr ""
#. type: =item
-#: dh_makeshlibs:81
+#: dh_makeshlibs:86
msgid "B<--add-udeb=>I<udeb>"
msgstr ""
#. type: textblock
-#: dh_makeshlibs:83
+#: dh_makeshlibs:88
msgid ""
"Create an additional line for udebs in the shlibs file and use I<udeb> as "
"the package name for udebs to depend on instead of the regular library "
msgstr ""
#. type: textblock
-#: dh_makeshlibs:88
+#: dh_makeshlibs:93
msgid "Pass I<params> to L<dpkg-gensymbols(1)>."
msgstr ""
#. type: =item
-#: dh_makeshlibs:96
+#: dh_makeshlibs:101
msgid "B<dh_makeshlibs>"
msgstr ""
#. type: verbatim
-#: dh_makeshlibs:98
+#: dh_makeshlibs:103
#, no-wrap
msgid ""
"Assuming this is a package named F<libfoobar1>, generates a shlibs file "
msgstr ""
#. type: =item
-#: dh_makeshlibs:102
+#: dh_makeshlibs:107
msgid "B<dh_makeshlibs -V>"
msgstr ""
#. type: verbatim
-#: dh_makeshlibs:104
+#: dh_makeshlibs:109
#, no-wrap
msgid ""
"Assuming the current version of the package is 1.1-3, generates a shlibs\n"
msgstr ""
#. type: =item
-#: dh_makeshlibs:108
+#: dh_makeshlibs:113
msgid "B<dh_makeshlibs -V 'libfoobar1 (E<gt>= 1.0)'>"
msgstr ""
#. type: verbatim
-#: dh_makeshlibs:110
+#: dh_makeshlibs:115
#, no-wrap
msgid ""
"Generates a shlibs file that looks something like:\n"
#. type: textblock
#: dh_python:19
msgid ""
-"Note: This program is deprecated. You should use B<dh_pysupport> or "
-"B<dh_pycentral> instead. This program will do nothing if F<debian/pycompat> "
-"or a B<Python-Version> F<control> file field exists."
+"Note: This program is deprecated. You should use B<dh_python2> instead. "
+"This program will do nothing if F<debian/pycompat> or a B<Python-Version> "
+"F<control> file field exists."
msgstr ""
#. type: textblock
msgid ""
"If your package installs Python modules in non-standard directories, you can "
"make F<dh_python> check those directories by passing their names on the "
-"command line. By default, it will check F</usr/lib/site-python, "
-"/usr/lib/$PACKAGE>, F</usr/share/$PACKAGE>, F</usr/lib/games/$PACKAGE>, "
+"command line. By default, it will check F</usr/lib/site-python>, "
+"F</usr/lib/$PACKAGE>, F</usr/share/$PACKAGE>, F</usr/lib/games/$PACKAGE>, "
"F</usr/share/games/$PACKAGE> and F</usr/lib/python?.?/site-packages>."
msgstr ""