dpkg-source(1): Explain better the first parameter of the -b option.

debian/changelog

@@ -25,6 +25,8 @@ dpkg (1.14.16) UNRELEASED; urgency=low
     Dpkg::Control. Closes: #26554
   * Temporarily add a Breaks: dpkg-dev (= 1.14.13), dpkg-dev (= 1.14.14) on
     dpkg for the convenience of sid users. Closes: #459815
+  * Update dpkg-source(1) to explain better what the directory after -b is.
+    Closes: #323606
 
   [ Updated manpages translations ]
   * Fix typo in French. Closes: #460021

man/ChangeLog

@@ -1,3 +1,7 @@
+2008-01-10  Raphael Hertzog  <hertzog@debian.org>
+
+	* dpkg-source.1: Explain better the first parameter of the -b option.
+
 2008-01-10  Christian Perrier  <bubulle@debian.org>
 
 	* fr.po: Fix typo

man/dpkg-source.1

@@ -45,7 +45,8 @@ will inherit its group ownership.
 .RI "\fB\-b\fP " directory " [" orig-directory | orig-targz |\(aq\(aq]
 Build a source package. One or two non-option arguments should
 be supplied. The first is taken as the name of the directory
-containing the unpacked source tree. If a second argument is supplied
+containing the debianized source tree (i.e. with a debian sub-directory
+and maybe changes to the original files). If a second argument is supplied
 it should be the name of the original source directory or tarfile or
 the empty string if the package is a Debian-specific one and so has no
 Debianisation diffs. If no second argument is supplied then