[Reproducible-commits] [dpkg] 13/26: man: Document Source field version in deb-control(5)

[Jérémy Bobbio]

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

lunar pushed a commit to branch pu/reproducible_builds
in repository dpkg.

commit 2c0016a31f42fc8b3aefb334fbacc3941d66a950
Author: Guillem Jover <guillem at debian.org>
Date:   Sun Oct 11 03:09:45 2015 +0200

    man: Document Source field version in deb-control(5)
---
 debian/changelog  | 1 +
 man/deb-control.5 | 9 ++++++---
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index f060b3c..8625837 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -14,6 +14,7 @@ dpkg (1.18.5) UNRELEASED; urgency=medium
     - Mark Maintainer field as bold in deb-src-control(5).
     - Fix reference to --record-avail instead of inexistent --avail.
     - Add missing quotes in man pages.
+    - Document Source field version in deb-control(5).
 
  -- Guillem Jover <guillem at debian.org>  Fri, 25 Dec 2015 14:20:16 +0100
 
diff --git a/man/deb-control.5 b/man/deb-control.5
index 765bfc1..fea726c 100644
--- a/man/deb-control.5
+++ b/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
 adding the field with an explicit \fBno\fP value is generally not needed.
 .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.
-
+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
 .BI Subarchitecture: " value"
 .TQ

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