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

diff --git a/debian/changelog b/debian/changelog
index 38923d55794cfb624535bae0c3944487e8aa546b..25bbb61aba4f1448b56081fbf4f5293c6293a3c0 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -6,6 +6,7 @@ debhelper (7.4.1) UNRELEASED; urgency=low
 
   [ Joey Hess ]
   * Add FILES sections to man pages. Closes: #545041 
+  * dh_prep(1): Clarify when it should be called. Closes: #544969
 
  -- Steve Langasek <vorlon@debian.org>  Thu, 06 Aug 2009 03:01:43 -0700
 

diff --git a/dh_prep b/dh_prep
index d9e4bf8ee5bdc3208daf69677d30ef7d82888201..bee9658e6ddc5eb7372a7e5ce3fe0ebf6a99de98 100755 (executable)
--- 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