浏览代码

man: Mark each individual required field as such

Do not use segregated sections for required and optional fields, they
are more difficult to organize this way.
Guillem Jover 10 年之前
父节点
当前提交
244f260024
共有 3 个文件被更改,包括 9 次插入10 次删除
  1. 2 0
      debian/changelog
  2. 5 7
      man/deb-control.5
  3. 2 3
      man/deb-origin.5

+ 2 - 0
debian/changelog

@@ -40,6 +40,8 @@ dpkg (1.18.3) UNRELEASED; urgency=low
   * Documentation:
     - Fix typos for --predep-package option name. Closes: #794688
     - Add missing dashes to package-list in deb-src-control(5).
+    - Mark each individual required field as such, instead of using segregated
+      sections.
 
   [ Updated programs translations ]
   * Catalan (Jordi Mallach).

+ 5 - 7
man/deb-control.5

@@ -41,25 +41,25 @@ in the case of the
 .B Description
 field, see below).
 .
-.SH REQUIRED FIELDS
+.SH FIELDS
 .TP
-.BI Package: " package-name"
+.BR Package: " \fIpackage-name\fP (required)"
 The value of this field determines the package name, and is used to
 generate file names by most installation tools.
 .TP
-.BI Version: " version-string"
+.BR Version: " \fIversion-string\fP (required)"
 Typically, this is the original package's version number in whatever form
 the program's author uses. It may also include a Debian revision number
 (for non-native packages). The exact format and sorting algorithm
 are described in
 .BR deb\-version (5).
 .TP
-.BI Maintainer: " fullname-email"
+.BR Maintainer: " \fIfullname-email\fP (required)"
 Should be in the format \(lqJoe Bloggs <jbloggs@foo.com>\(rq, and is typically
 the person who created the package, as opposed to the author of the
 software that was packaged.
 .TP
-.BI Description: " short-description"
+.BR Description: " \fIshort-description\fP (required)"
 .TQ
 .BI " " "long-description"
 .br
@@ -68,8 +68,6 @@ first line (after the \fBDescription\fP field). The following lines should be
 used as a longer, more detailed description. Each line of the long description
 must be preceded by a space, and blank lines in the long description must
 contain a single \(oq\fB.\fP\(cq following the preceding space.
-.
-.SH OPTIONAL FIELDS
 .TP
 .BI Section: " section"
 This is a general field that gives the package a category based on the

+ 2 - 3
man/deb-origin.5

@@ -30,11 +30,10 @@ followed by a colon and the body of the field. Fields are delimited
 only by field tags. In other words, field text may be multiple lines
 in length, but the tools will join lines when processing the body of
 the field.
-.SH REQUIRED FIELDS
+.SH FIELDS
 .TP
-.BI Vendor: " vendor-name"
+.BR Vendor: " \fIvendor-name\fP (required)"
 The value of this field determines the vendor name.
-.SH OPTIONAL FIELDS
 .TP
 .BI Vendor\-URL: " vendor-url"
 The value of this field determines the vendor URL.