[dpkg] 27/187: man: Improve dpkg-deb --build arguments documentation

[Reiner Herrmann]

This is an automated email from the git hooks/post-receive script.

deki-guest pushed a commit to branch master
in repository dpkg.

commit 5dd05c068d01d3a74d9786d1719b1258693d78f9
Author: Guillem Jover <guillem at debian.org>
Date:   Mon Aug 15 17:57:17 2016 +0200

    man: Improve dpkg-deb --build arguments documentation
    
    The Architecture field is now mandatory when building. Clarify that
    when passing a directory the generated archive is placed therein.
    Rename the first directory argument to distinguish it from the second.
    
    Prompted-by: Johannes Schauer <josch at debian.org>
---
 debian/changelog |  2 ++
 man/dpkg-deb.1   | 15 +++++----------
 2 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index c634139..43bdc00 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -6,6 +6,8 @@ dpkg (1.18.11) UNRELEASED; urgency=medium
     - Fix typos in docs and man pages. Thanks to Jakub Wilk <jwilk at debian.org>
       Closes: #834584
     - Fix formatting in SOURCE_DATE_EPOCH description in dpkg-deb(5).
+    - Improve dpkg-deb --build arguments documentation in dpkg-deb(1).
+      Prompted by Johannes Schauer <josch at debian.org>.
   * Build system:
     - Add support for profiling perl modules.
     - Clean up compiler and linker automatic flag usage in configure.
diff --git a/man/dpkg-deb.1 b/man/dpkg-deb.1
index bdcb7a8..9d66bd5 100644
--- a/man/dpkg-deb.1
+++ b/man/dpkg-deb.1
@@ -51,9 +51,9 @@ their respective command description.
 .
 .SH COMMANDS
 .TP
-.BR \-b ", " \-\-build " \fIdirectory\fP [\fIarchive\fP|\fIdirectory\fP]"
+.BR \-b ", " \-\-build " \fIbinary-directory\fP [\fIarchive\fP|\fIdirectory\fP]"
 Creates a debian archive from the filesystem tree stored in
-.IR directory ". " directory
+.IR binary-directory ". " binary-directory
 must have a
 .B DEBIAN
 subdirectory, which contains the control information files such
@@ -80,20 +80,15 @@ If no
 is specified then
 .B dpkg\-deb
 will write the package into the file
-.IR directory \fB.deb\fR.
+.IR binary-directory \fB.deb\fR.
 
 If the archive to be created already exists it will be overwritten.
 
 If the second argument is a directory then
 .B dpkg\-deb
 will write to the file
-.IB package _ version _ arch .deb\fR,
-or
-.IB package _ version .deb
-if no
-.B Architecture
-field is present in the package control file. When a target directory
-is specified, rather than a file, the
+.IB directory / package _ version _ arch .deb.
+When a target directory is specified, rather than a file, the
 .B \-\-nocheck
 option may not be used (since
 .B dpkg\-deb

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/dpkg.git