dgit(1): Improve and correct --build-products-dir description.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/debian/changelog b/debian/changelog
index 42a667205d54f36668d2f3bff8cd20aeb55c7821..82941916b4ffe048927de1f5e0e33b6946d6aa5b 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,5 +1,6 @@
 dgit (6.2~) unstable; urgency=medium
 
 dgit (6.2~) unstable; urgency=medium
 

+  * dgit(1): Improve and correct --build-products-dir description.

   * dgit: Minor code cleanup.
   * test suite: Test dgit import-dsc --build-products-dir.
 
   * dgit: Minor code cleanup.
   * test suite: Test dgit import-dsc --build-products-dir.
 

diff --git a/dgit.1 b/dgit.1
index 6158736ea2917984948c3217da5b383a40edbee6..a4b169430040c02e93138ac3ddec9bbd223ba61e 100644 (file)
--- a/dgit.1
+++ b/dgit.1
@@ -877,14 +877,20 @@ Note that \fBdgit push-source\fR will always find the right .changes,
 regardless of this option.
 .TP
 .BI --build-products-dir= directory
 regardless of this option.
 .TP
 .BI --build-products-dir= directory

-Specifies where to find the built files to be uploaded.
-By default, dgit looks in the parent directory
+Specifies where to find and create tarballs, binry packages,
+source packages, .changes files, and so on.
+
+By default, dgit uses the parent directory

 .RB ( .. ).
 
 .RB ( .. ).
 

-Also see the
+Changing this setting may necessitate
+moving .orig tarballs to the new directory,
+so it is probably best to
+use the

 .BI dgit.default.build-products-dir
 .BI dgit.default.build-products-dir

-configuration option
-(which this command line option overrides).
+configuration setting
+(see CONFIGURATION, below)
+which this command line option overrides).

 .TP
 .BI --no-rm-on-error
 Do not delete the destination directory if clone fails.
 .TP
 .BI --no-rm-on-error
 Do not delete the destination directory if clone fails.