名前

dh_installchangelogs - ビルドディレクトリに changelog をインストールする

書式

dh_installchangelogs [debhelper options] [-k] [-Xitem] [upstream]

説明

dh_installchangelogs はパッケージビルドディレクトリに changelog をインストールを担当する debhelper コマンドです。

An upstream changelog file may be specified as an option. If none is specified, dh_installchangelogs may look for files with names that seem likely to be changelogs as described in the next paragraphs.

In non-native packages, dh_installchangelogs will first look for changelog files installed by the upstream build system into usr/share/doc/package (of the package build directory) and rename the most likely candidate (if any) to usr/share/doc/package/changelog. Note that dh_installchangelogs does not look into any source directory (such as debian/tmp). Otherwise, dh_installchangelogs (at compatibility level 7 or any later) will look for changelog files in the source directory (e.g. the root or the docs subdirectory). It will look for changelog, changes and history optionally with common extensions (such as .txt, .md and .rst).

If a changelog file is specified and is an html file (determined by file extension), it will be installed as usr/share/doc/package/changelog.html instead. If the html changelog is converted to plain text, that variant can be specified as a second parameter. When no plain text variant is specified, a short usr/share/doc/package/changelog is generated, pointing readers at the html changelog file.

ファイル

debian/changelog

debian/NEWS

debian/package.changelog

debian/package.NEWS

これらのファイルは、パッケージビルドディレクトリ以下の usr/share/doc/package/ 配下に自動的にインストールされます。

package が異なる NEWS や changelog ファイル名を使う必要がある場合は、パッケージ固有の名前を指定してください。

 F<changelog> ファイルは native パッケージ向けには changelog の名前でインストールされ、非 native
パッケージ向けには F<changelog.Debian> としてインストールされます。F<NEWS> は必ず F<NEWS.Debian>
の名前でインストールされます。
    

オプション

-k, --keep

Keep the original name of the upstream changelog. This will be accomplished by installing the upstream changelog as changelog, and making a symlink from that to the original name of the changelog file. This can be useful if the upstream changelog has an unusual name, or if other documentation in the package refers to the changelog file.

-Xitem, --exclude=item

item をファイル名に含む開発元 (upstream) の changelog ファイルをインストール候補から除外します。

Note that directory name of the changelog is also part of the match.

upstream

このファイルを開発元 (upstream) の changelog としてインストールします。

参照

debhelper(7)

このプログラムは debhelper の一部です。

作者

Joey Hess <joeyh@debian.org>