瀏覽代碼

man: Document Source field version in deb-control(5)

Guillem Jover 10 年之前
父節點
當前提交
2c0016a31f
共有 2 個文件被更改,包括 7 次插入3 次删除
  1. 1 0
      debian/changelog
  2. 6 3
      man/deb-control.5

+ 1 - 0
debian/changelog

@@ -14,6 +14,7 @@ dpkg (1.18.5) UNRELEASED; urgency=medium
     - Mark Maintainer field as bold in deb-src-control(5).
     - Mark Maintainer field as bold in deb-src-control(5).
     - Fix reference to --record-avail instead of inexistent --avail.
     - Fix reference to --record-avail instead of inexistent --avail.
     - Add missing quotes in man pages.
     - Add missing quotes in man pages.
+    - Document Source field version in deb-control(5).
 
 
  -- Guillem Jover <guillem@debian.org>  Fri, 25 Dec 2015 14:20:16 +0100
  -- Guillem Jover <guillem@debian.org>  Fri, 25 Dec 2015 14:20:16 +0100
 
 

+ 6 - 3
man/deb-control.5

@@ -144,10 +144,13 @@ qualifying the package name with \fB:any\fP, but has no effect otherwise.
 The value \fBno\fP is the default when the field is omitted, in which case
 The value \fBno\fP is the default when the field is omitted, in which case
 adding the field with an explicit \fBno\fP value is generally not needed.
 adding the field with an explicit \fBno\fP value is generally not needed.
 .TP
 .TP
-.BI Source: " source-name"
-The name of the source package that this binary package came from, if
+.BR Source: " \fIsource-name\fP [\fB(\fP\fIsource-version\fP\fB)\fP]"
+The name of the source package that this binary package came from, if it is
 different than the name of the package itself.
 different than the name of the package itself.
-
+If the source version differs from the binary version, then the
+\fIsource-name\fP will be followed by a \fIsource-version\fP in parenthesis.
+This can happen for example on a binary-only non-maintainer upload, or when
+setting a different binary version via \(Fo\fBdpkg\-gencontrol \-v\fP\(Fc.
 .TP
 .TP
 .BI Subarchitecture: " value"
 .BI Subarchitecture: " value"
 .TQ
 .TQ