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/share/doc/package/changelog
  13 in the package build directory. Otherwise, it installs debian/changelog into
  14 usr/share/doc/package/changelog.Debian in the package build directory. (If
  15 files 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/share/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/share/doc/package/changelog.html instead (with a link to
  23 usr/share/doc/package/changelog).
  24 .SH OPTIONS
  25 .TP
  26 .B debhelper options
  27 See
  28 .BR debhelper (1)
  29 for a list of options common to all debhelper commands.
  30 .TP
  31 .B \-k, \--keep
  32 Keep the original name of the upstream changelog. This will be accomplished
  33 by installing the upstream changelog as "changelog", and making a symlink from
  34 that to the original name of the changelog file. This can be useful if the
  35 upstream changelog has an unusual name, or if other documentation in the
  36 package refers to the changelog file.
  37 .TP
  38 .B upstream
  39 Install this file as the upstream changelog.
  40 .SH NOTES
  41 It is an error to specify an upstream changelog file for a debian native
  42 package.
  43 .SH ENVIRONMENT
  44 See
  45 .BR debhelper (1)
  46 for a list of environment variables that affect all debhelper commands.
  47 .SH "SEE ALSO"
  48 .BR debhelper (1)
  49 .SH "CONFORMS TO"
  50 Debian policy, version 3.0.1
  51 .SH AUTHOR
  52 Joey Hess <joeyh@master.debian.org>