dh_installchangelogs.1

   1 .TH DH_INSTALLCHANGELOGS 1 "" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_installchangelogs \- install changelogs into package build directories
   4 .SH SYNOPSIS
   5 .B dh_installchangelogs
   6 .I "[debhelper options] [-k] [upstream]"
   7 .SH "DESCRIPTION"
   8 dh_installchangelogs is a debhelper program that is responsible for installing
   9 changelogs into package build directories.
  10 .P
  11 dh_installchangelogs determines if the package is a debian native package,
  12 and if so, it installs debian/changelog into usr/doc/package/changelog in
  13 the package build directory. Otherwise, it installs debian/changelog into
  14 usr/doc/package/changelog.Debian in the package build directory. (If files
  15 named debian/package.changelog exist, they will be used in preference to
  16 debian/changelog.)
  17 .P
  18 If an upstream changelog file is specified as an option, and the package is
  19 not a native debian package, then this upstream changelog will be installed
  20 as usr/doc/package/changelog in the package build directory. If the
  21 changelog is a html file (determined by file extention), it will be
  22 installed as usr/doc/package/changelog.html instead.
  23 .SH OPTIONS
  24 .TP
  25 .B debhelper options
  26 See
  27 .BR debhelper (1)
  28 for a list of options common to all debhelper commands.
  29 .TP
  30 .B \-k, \--keep
  31 Keep the original name of the upstream changelog. This will be accomplished
  32 by installing the upstream changelog as "changelog", and making a symlink from
  33 that to the original name of the changelog file. This can be useful if the
  34 upstream changelog has an unusual name, or if other documentation in the
  35 package refers to the changelog file.
  36 .TP
  37 .B upstream
  38 Install this file as the upstream changelog.
  39 .SH NOTES
  40 It is an error to specify an upstream changelog file for a debian native
  41 package.
  42 .SH ENVIRONMENT
  43 See
  44 .BR debhelper (1)
  45 for a list of environment variables that affect all debhelper commands.
  46 .SH "SEE ALSO"
  47 .BR debhelper (1)
  48 .SH "CONFORMS TO"
  49 Debian policy, version 2.5.0.0
  50 .SH AUTHOR
  51 Joey Hess <joeyh@master.debian.org>