[dpkg] 28/187: man: Document the .changes filename that dpkg-buildpackage generates

[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 b7972c6df31f9990efb70ed662ca4ba2f6d365bd
Author: Guillem Jover <guillem at debian.org>
Date:   Mon Aug 15 18:16:51 2016 +0200

    man: Document the .changes filename that dpkg-buildpackage generates
    
    Prompted-by: Johannes Schauer <josch at debian.org>
---
 debian/changelog        | 2 ++
 man/dpkg-buildpackage.1 | 8 ++++++++
 2 files changed, 10 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 43bdc00..f7a132c 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -8,6 +8,8 @@ dpkg (1.18.11) UNRELEASED; urgency=medium
     - 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>.
+    - Document the .changes filename that dpkg-buildpackage generates in
+      dpkg-buildpackage(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-buildpackage.1 b/man/dpkg-buildpackage.1
index f56c124..5d8d102 100644
--- a/man/dpkg-buildpackage.1
+++ b/man/dpkg-buildpackage.1
@@ -64,6 +64,14 @@ build has been requested with \fB\-\-build\fP or equivalent options).
 .IP \fB6.\fP 3
 It runs the \fBchanges\fP hook and calls \fBdpkg\-genchanges\fP to
 generate a \fB.changes\fP file.
+The name of the \fB.changes\fP file will depend on the type of build and
+will be as specific as necessary but not more;
+for a build that includes \fBany\fP the name will be
+\fIsource-name\fP\fB_\fP\fIsource-version\fP\fB_\fP\fIarch\fP\fB.changes\fP,
+or otherwise for a build that includes \fBall\fP the name will be
+\fIsource-name\fP\fB_\fP\fIsource-version\fP\fB_\fP\fBall.changes\fP,
+or otherwise for a build that includes \fBsource\fP the name will be
+\fIsource-name\fP\fB_\fP\fIsource-version\fP\fB_\fP\fBsource.changes\fP.
 Many \fBdpkg\-buildpackage\fP options are forwarded to
 \fBdpkg\-genchanges\fP.
 .IP \fB7.\fP 3

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