+#: 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 "
+"build time, you can use some commands provided in B<autotools-dev> that "
+"automate it, like this."
+msgstr ""
+
+#. type: verbatim
+#: dh:133
+#, no-wrap
+msgid ""
+"\t#!/usr/bin/make -f\n"
+"\t%:\n"
+"\t\tdh $@ --with autotools_dev\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: dh:137
+msgid ""
+"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:141
+#, no-wrap
+msgid ""
+"\t#!/usr/bin/make -f\n"
+"\t%:\n"
+"\t\tdh $@ --with python2\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: dh:145
+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."
+msgstr ""
+
+#. type: verbatim
+#: dh:149
+#, no-wrap
+msgid ""
+"\t#!/usr/bin/make -f\n"
+"\t%:\n"
+"\t\tdh $@ --buildsystem=perl_build\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: 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 "
+"subdirectory."
+msgstr ""
+
+#. type: verbatim
+#: dh:157
+#, no-wrap
+msgid ""
+"\t#!/usr/bin/make -f\n"
+"\t%:\n"
+"\t\tdh $@ --sourcedirectory=src\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: 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:164
+#, no-wrap
+msgid ""
+"\t#!/usr/bin/make -f\n"
+"\t%:\n"
+"\t\tdh $@ --builddirectory=build\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: 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:171
+#, no-wrap
+msgid ""
+"\t#!/usr/bin/make -f\n"
+"\t%:\n"
+"\t\tdh $@ --parallel\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: 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:182
+#, no-wrap
+msgid ""
+"\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:193
+#, no-wrap
+msgid ""
+"\toverride_dh_auto_build-indep:\n"
+"\t\t$(MAKE) -C docs\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: dh:196
+#, no-wrap
+msgid ""
+"\t# No tests needed for docs\n"
+"\toverride_dh_auto_test-indep:\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: dh:199
+#, no-wrap
+msgid ""
+"\toverride_dh_auto_install-indep:\n"
+"\t\t$(MAKE) -C docs install\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: dh:202
+msgid ""
+"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:206
+#, no-wrap
+msgid ""
+"\toverride_dh_fixperms-arch:\n"
+"\t\tdh_fixperms\n"
+"\t\tchmod 4755 debian/foo/usr/bin/foo\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: dh:210
+msgid "INTERNALS"
+msgstr ""
+
+#. type: textblock
+#: dh:212
+msgid ""
+"If you're curious about B<dh>'s internals, here's how it works under the "
+"hood."
+msgstr ""
+
+#. type: textblock
+#: 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 "
+"tell which commands have already been run, for which packages, and skip "
+"running those commands again."
+msgstr ""
+
+#. type: textblock
+#: 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 "
+"command in the sequence. The B<--until>, B<--before>, B<--after>, and "
+"B<--remaining> options can override this behavior."
+msgstr ""
+
+#. type: textblock
+#: 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 "
+"targets. The contents (and indeed, existence) of this environment variable, "
+"as the name might suggest, is subject to change at any time."
+msgstr ""
+
+#. type: textblock
+#: 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."
projects / debhelper.git / blobdiff