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