dpkg-parsechangelog(1)

名前
dpkg-parsechangelog - Debian changelog ファイルの解析

書式
dpkg-parsechangelog [option...]

説明
dpkg-parsechangelo は、展開された Debian ソースツリーにある changelog ファイルを読み取って解析し、その情報をコンピュータに適した形式で標準出力に出力する。

オプション

-lchangelogfile
    情報の読み取り元となる changelog ファイルを指定する。デフォルトは debian/changelog。

-Fchangelogformat
    changelog ファイルの形式を指定する。デフォルトでは、changelog の末尾の近辺にある特別な行から読み取られるか、もしくは Debian 標準形式が用いられる。

-Llibdir
    パーサスクリプトを検索するディレクトリを追加で指定する。このディレクトリはデフォルトのディレクトリの検索前に検索される。デフォルトのディレクトリは、現在 /usr/local/lib/dpkg/parsechangelog および /usr/lib/dpkg/parsechangelog である。

-h, --help
    利用方法を表示して終了する。

--version
    バージョン情報を表示して終了する。

  パーサ用オプション
以下のオプションは、解析対象の範囲や出力形式といった、changelog パーサの出力を制御するために使われる。これらは、解析スクリプトによってサポートされる必要がある。警告 も参照のこと。

--format outputformat
    出力形式を指定する。現在サポートされている値は dpkg および rfc822 である。dpkg は従来からの (このオプションが存在する前からの) 出力形式であり、デフォルトである。これには Debian 制御情報形式 (deb-control(5) を参照) に則った段落 1 つからなる。複数のエントリが指定された場合、他に指示がない限り、ほとんどのフィールドは最後に指定したエントリに従って取得される。

    Source: pkg-name

    Version: version

    Distribution: target-distribution

    Urgency: urgency
        含まれるすべてのエントリの中でもっとも高い urgency が用いられる。

    Maintainer: author

    Date: date

    Closes: bug-number
        Closes フィールドに含まれるすべてのエントリはマージされる。

    Changes: changelog-entries
        changelog のエントリにあるすべてのテキストは結合される。このフィールドを Debian 制御情報形式に従った形式とするために、複数行のフィールドにおける空行は、ピリオドに置き換えられ、すべての行の先頭に空白文字が 1 つ挿入される。内容は changelog の形式に依存する。

    この他、ユーザ定義のフィールドが存在してもよい。

    rfc822 形式でも同じフィールドが用いられるが、出力については、changelog のエントリ毎に別の段落に分割され、各エントリのメタデータが保持される。

--since version, -sversion, -vversion
    version より後のすべての変更を含む。

--until version, -uversion
    version より前のすべての変更を含む。

--from version, -fversion
    version 以降のすべての変更を含む。

--to version, -tversion
    version 以前のすべての変更を含む。

--count number, -cnumber, -nnumber
    先頭から number 分のエントリを含める (number が 0 未満の場合は、最後から number エントリの意味となる。

--offset number, -onumber
    --count の開始地点を先頭から number エントリに変更する (number が0 未満の場合は、最後から number エントリの意味となる)。

--all
    すべての変更を含める。このオプションが設定された場合、他のオプションは無効となる。

警告
-v 以外の パーサ用オプション は dpkg 1.14.16 以降のバージョンでのみサポートされる。debian 以外の changelog 形式を解析するサードパーティのパーサは、すべてのオプションをサポートしないかもしれない。

ファイル

debian/changelog
    chengelog ファイル、urgency やアップロードの distribution、あるリリース以降に行われた変更点、ソースのバージョン番号自体といった、ソースパッケージに関するバージョン固有の情報を取得するために用いられる。

翻訳者
高橋 基信 <monyo@monyo.com>. 喜瀬 浩 <kise@fuyuneko.jp>. 関戸 幸一 <sekido@mbox.kyoto-inet.or.jp>. 鍋谷 栄展 <nabe@debian.or.jp>. 倉澤 望 <nabetaro@debian.or.jp>. 石川 睦 <ishikawa@linux.or.jp>. 鵜飼 文敏 <ukai@debian.or.jp>. 中野 武雄 <nakano@apm.seikei.ac.jp>.

翻訳校正
Debian JP Documentation ML <debian-doc@debian.or.jp>.