[dpkg] 171/200: man: Clarify the requirements for deb-conffile(5) pathnames

[Ximin Luo]

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

infinity0 pushed a commit to branch master
in repository dpkg.

commit 45eb890431c219b35055f98bdaa0f15587dca249
Author: Guillem Jover <guillem at debian.org>
Date:   Sun Feb 19 20:47:33 2017 +0100

    man: Clarify the requirements for deb-conffile(5) pathnames
    
    Closes: #854417
    Proposed-by: Dieter Adriaenssens <dieter.adriaenssens at gmail.com>
---
 debian/changelog      | 4 +++-
 man/deb-conffiles.man | 6 +++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index bc330f5..63d9a00 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,8 @@
 dpkg (1.18.23) UNRELEASED; urgency=medium
 
-  *
+  * Documentation:
+    - Clarify the requirements for deb-conffile(5) pathnames. Closes: #854417
+      Proposed by Dieter Adriaenssens <dieter.adriaenssens at gmail.com>.
 
  -- Guillem Jover <guillem at debian.org>  Wed, 01 Feb 2017 06:28:28 +0100
 
diff --git a/man/deb-conffiles.man b/man/deb-conffiles.man
index f835dd1..5150ddc 100644
--- a/man/deb-conffiles.man
+++ b/man/deb-conffiles.man
@@ -1,6 +1,6 @@
 .\" dpkg manual page - deb-conffiles(5)
 .\"
-.\" Copyright © 2016 Guillem Jover <guillem at debian.org>
+.\" Copyright © 2016-2017 Guillem Jover <guillem at debian.org>
 .\"
 .\" This is free software; you can redistribute it and/or modify
 .\" it under the terms of the GNU General Public License as published by
@@ -28,6 +28,9 @@ A package declares its list of conffiles by including a \fIconffiles\fP file
 in its control archive (i.e. \fIDEBIAN/conffiles\fP during package creation).
 .PP
 This file contains a list of files, one per line.
+They should be listed as absolute pathnames, and should exist in the binary
+package, otherwise \fBdpkg\fP(1) will ignore them (although by default
+\fBdpkg\-deb\fP(1) will refuse to build such binary packages).
 Trailing whitespace will be trimmed, and empty lines will be ignored.
 .
 .SH EXAMPLE
@@ -39,4 +42,5 @@ Trailing whitespace will be trimmed, and empty lines will be ignored.
 .fi
 .
 .SH SEE ALSO
+.BR dpkg\-deb (1),
 .BR dpkg (1).

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