dh_installdebconf.1

   1 .TH DH_INSTALLDEBCONF 1 "" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_installdebconf \- install debconf files into package build directories
   4 .SH SYNOPSIS
   5 .B dh_installdebconf
   6 .I "[debhelper options] [-n]"
   7 .SH "DESCRIPTION"
   8 dh_installdebconf is a debhelper program that is responsible for installing
   9 files used by the debconf package into package build directories.
  10 .P
  11 It also automatically generates the postrm commands needed to
  12 interface with debconf. See
  13 .BR dh_installdeb (1)
  14 for an explanation of how this works.
  15 .P
  16 Files named debian/package.config and debian/package.templates are installed
  17 into the DEBIAN directory in the package build directory.
  18 .P
  19 For the first first binary package listed in the control file, you may use
  20 debian/config and debian/templates instead.
  21 .P
  22 Note that if you use debconf, your package probably needs to depend on it.
  23 .SH "LOCALIZED TEMPLATE FILES"
  24 Debconf also supports localized template files, and this program has some
  25 support to aid working with them. You may find it easiest to keep the
  26 translations in separate files, and merge them only at build time. See
  27 .BR debconf-mergetemplate (1)
  28 for details.
  29 .P
  30 This program will automatically call
  31 .BR debconf-mergetemplate (1)
  32 and merge templates on the fly if it finds your template files are accompnied
  33 by translated files that have the same name as the template file, with a
  34 dot and two letters prepended.
  35 .P
  36 For example, if you have a German translation,
  37 debian/templates.de is merged with debian/templates.
  38 .P
  39 If you use this feature, your package should build-depend on debconf-utils.
  40 .SH OPTIONS
  41 .TP
  42 .B debhelper options
  43 See
  44 .BR debhelper (1)
  45 for a list of options common to all debhelper commands.
  46 .TP
  47 .B \-n, \--noscripts
  48 Do not modify postrm script.
  49 .SH ENVIRONMENT
  50 See
  51 .BR debhelper (1)
  52 for a list of environment variables that affect all debhelper commands.
  53 .SH NOTES
  54 Note that this command is not idempotent. "dh_clean -k" should be called
  55 between invocations of this command. Otherwise, it may cause multiple
  56 instances of the same text to be added to maintainer scripts.
  57 .SH "SEE ALSO"
  58 .TP
  59 .BR debhelper (1)
  60 .SH AUTHOR
  61 Joey Hess <joeyh@debian.org>