dh_prep(1): Clarify when it should be called. Closes: #544969

1 files changed, 6 insertions, 4 deletions

diff --git a/dh_prep b/dh_prep
index d9e4bf8e..bee9658e 100755
--- a/dh_prep
+++ b/dh_prep
@@ -16,10 +16,12 @@ B<dh_prep> [S<I<debhelper options>>] [B<-X>I<item>]
 =head1 DESCRIPTION
 
 dh_prep is a debhelper program that performs some file cleanups in
-preparation for building a package. (This is what dh_clean -k used to do.)
-It removes the package build directories, debian/tmp, and some temp files
-that are generated during the build. Putting this at the start of the build
-process makes the build process idempotent.
+preparation for building a binary package. (This is what dh_clean -k
+used to do.) It removes the package build directories, debian/tmp,
+and some temp files that are generated when building a binary package.
+
+It is typically run at the top of the binary-arch and binary-indep targets,
+or at the top of a target such as install that they depend on.
 
 =head1 OPTIONS