Kaynağa Gözat

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@debian.org>
Guillem Jover 10 yıl önce
ebeveyn
işleme
5dd05c068d
2 değiştirilmiş dosya ile 7 ekleme ve 10 silme
  1. 2 0
      debian/changelog
  2. 5 10
      man/dpkg-deb.1

+ 2 - 0
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@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@debian.org>.
   * Build system:
     - Add support for profiling perl modules.
     - Clean up compiler and linker automatic flag usage in configure.

+ 5 - 10
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