man/deb-conffiles.man

   1 .\" dpkg manual page - deb-conffiles(5)
   2 .\"
   3 .\" Copyright © 2016-2017 Guillem Jover <guillem@debian.org>
   4 .\"
   5 .\" This is free software; you can redistribute it and/or modify
   6 .\" it under the terms of the GNU General Public License as published by
   7 .\" the Free Software Foundation; either version 2 of the License, or
   8 .\" (at your option) any later version.
   9 .\"
  10 .\" This is distributed in the hope that it will be useful,
  11 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 .\" GNU General Public License for more details.
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License
  16 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  17 .
  18 .TH deb\-conffiles 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
  19 .nh
  20 .SH NAME
  21 deb\-conffiles \- package conffiles
  22 .
  23 .SH SYNOPSIS
  24 conffiles
  25 .
  26 .SH DESCRIPTION
  27 A package declares its list of conffiles by including a \fIconffiles\fP file
  28 in its control archive (i.e. \fIDEBIAN/conffiles\fP during package creation).
  29 .PP
  30 This file contains a list of files, one per line.
  31 They should be listed as absolute pathnames, and should exist in the binary
  32 package, otherwise \fBdpkg\fP(1) will ignore them (although by default
  33 \fBdpkg\-deb\fP(1) will refuse to build such binary packages).
  34 Trailing whitespace will be trimmed, and empty lines will be ignored.
  35 .
  36 .SH EXAMPLE
  37 .nf
  38 %CONFDIR%/alternatives/README
  39 %CONFDIR%/cron.daily/dpkg
  40 %PKGCONFDIR%/dpkg.cfg
  41 %CONFDIR%/logrotate.d/dpkg
  42 .fi
  43 .
  44 .SH SEE ALSO
  45 .BR dpkg\-deb (1),
  46 .BR dpkg (1).