From 68659e379eddcac1e1e8b8e7112f968386ea0de6 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 14 Dec 2009 19:36:21 -0500 Subject: [PATCH] dh(1): Add an example of using an override target to avoid dh running several commands. Closes: #560600 --- debian/changelog | 2 ++ dh | 35 +++++++++++++++++++++++++---------- 2 files changed, 27 insertions(+), 10 deletions(-) diff --git a/debian/changelog b/debian/changelog index 0203c22..97c7c85 100644 --- a/debian/changelog +++ b/debian/changelog @@ -2,6 +2,8 @@ debhelper (7.4.11) UNRELEASED; urgency=low * dh(1): Minor rewording of documentation of override commands. Closes: #560421 + * dh(1): Add an example of using an override target to avoid + dh running several commands. Closes: #560600 -- Joey Hess Mon, 14 Dec 2009 19:23:25 -0500 diff --git a/dh b/dh index dc588e2..862dc25 100755 --- a/dh +++ b/dh @@ -87,12 +87,10 @@ All other options passed to dh are passed on to each command it runs. This can be used to set an option like "-v" or "-X" or "-N", as well as for more specialised options. -=head1 COMMAND SPECIFICATION - -I 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. +In the above options, I 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. =cut @@ -179,6 +177,14 @@ default. This is how to use dh_pycentral instead. %: dh --with python-central $@ +Here is how to force use of perl's Module::Build build system, +which can be necessary if debhelper wrongly detects that the package +uses MakeMaker. + + #!/usr/bin/make -f + %: + dh --buildsystem=perl_build $@ + To patch your package using quilt, you can tell dh to use quilt's dh sequence addons like this: @@ -188,13 +194,22 @@ sequence addons like this: Here is an example of overriding where the dh_auto_* commands find the package's source, for a package where the source is located in a -subdirectory. It also forces use of perl's Module::Build build system, -which can be necessary if debhelper wrongly detects that the package -uses MakeMaker. +subdirectory. #!/usr/bin/make -f %: - dh --sourcedirectory=src --buildsystem=perl_build $@ + dh --sourcedirectory=src $@ + +Finally, here is a way to prevent dh from running several commands +that you don't want it to run, by defining empty override targets for each +command. + + #!/usr/bin/make -f + %: + dh $@ + + # Commands not to run: + override_dh_auto_test override_dh_compress override_dh_fixperms: =cut -- 2.39.2