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 Note that if you use debconf, your package probably needs to depend on it.
  20 .SH "LOCALIZED TEMPLATE FILES"
  21 Debconf also supports localized template files, and this program has some
  22 support to aid working with them. You may find it easiest to keep the
  23 translations in separate files, and merge them only at build time. See
  24 .BR debconf-mergetemplate (1)
  25 for details.
  26 .P
  27 This program will automatically call
  28 .BR debconf-mergetemplate (1)
  29 and merge templates on the fly if it finds your template files are accompnied
  30 by translated files that have the same name as the template file, with a
  31 dot and two letters prepended.
  32 .P
  33 For example, if you have a German translation,
  34 debian/package.templates.de is merged with debian/package.templates.
  35 .P
  36 If you use this feature, your package should build-depend on debconf-utils.
  37 .SH OPTIONS
  38 .TP
  39 .B debhelper options
  40 See
  41 .BR debhelper (1)
  42 for a list of options common to all debhelper commands.
  43 .TP
  44 .B \-n, \--noscripts
  45 Do not modify postrm script.
  46 .SH ENVIRONMENT
  47 See
  48 .BR debhelper (1)
  49 for a list of environment variables that affect all debhelper commands.
  50 .SH NOTES
  51 Note that this command is not idempotent. "dh_clean -k" should be called
  52 between invocations of this command. Otherwise, it may cause multiple
  53 instances of the same text to be added to maintainer scripts.
  54 .SH "SEE ALSO"
  55 .TP
  56 .BR debhelper (1)
  57 .SH AUTHOR
  58 Joey Hess <joeyh@debian.org>