gbp-dch - クラウドでオンライン

プログラム：

NAME

gbp-dch - git commit メッセージから Debian 変更ログを生成する

SYNOPSIS

GBP DCH [ - バージョン ] [ - 助けて ] [ -詳細 ] [ --color =[自動|オン|オフ] ] [ - 色-
スキーム=カラースキーム ] [ --debian-ブランチ=支店名 ] [ --debian-tag=タグ形式 ] [
--上流ブランチ=支店名 ] [ --上流タグ=タグ形式 ] [ --ignore-ブランチ ] [
-スナップショット | - リリース ] [ --自動 | --since=コミットする ] [ --新しいバージョン=バージョン ] [ --bpo
| --nmu | --qa | - チーム ] [ --配布=名 ] [ -- 力分布 ] [
--緊急=レベル ] [ --[いいえ-]フル ] [ --[no-]メタ ] [ --meta-closes=バグクローズタグ ] [
--meta-closes-bugnum=バグ番号の形式 ] [ --スナップショット番号=表現 ] [ --id-
長さ=数 ] [ --git-log=git ログ オプション ] [ --[no-]git-author ] [ --[no-]マルチメンテナンス ]
[ --[no-]multimaint-merge ] [ --spawn-editor=[常に|スナップショット|リリース] ] [ - 専念-
メッセージ=メッセージ形式 ] [ - 専念 ] [ --カスタマイズ=カスタマイズファイル ] [パス1 パス2]

DESCRIPTION

GBP DCH git commit メッセージを読み取り、そこから Debian 変更ログを生成します。 いいえ
引数が与えられ、 GBP DCH 最後にタグ付けされた Debian パッケージのバージョンから
現在のブランチの現在の先端。 最上位セクションの分布が
debian / changelog is 未公開、変更ログ エントリがこのセクションに挿入されます。
それ以外の場合は、新しいセクションが作成されます。

If --自動 与えられる GBP DCH、変更ログに記載されている最後の Git コミットを推測しようとします
- これはスナップショット モードでのみ機能します。 さもないと、 - 以来 伝えるために使用できます GBP DCH at
Git 履歴のどの時点から開始する必要があります。

追加のパス引数を使用して、リポジトリ パスを制限できます GBP DCH ルックス
で。 設定 path 〜へ デビアン/ アップストリームが Git とすべての Debian パッケージを使用している場合は、良い選択です。
変更は デビアン/ サブディレクトリ。 より洗練されたケース（のような
バックポート)、使用できます --git-log 生成された変更ログ エントリをさらに制限するには、
たとえば、を使用して --git-log=" --author=フー バー".

OPTIONS

- バージョン
プログラムのバージョン、つまり git-buildpackage スイートのバージョンを表示します。

-v

-詳細
詳細な実行

-h

- 助けて ヘルプを印刷して終了します

--color =[自動|オン|オフ]
カラー出力を使用するかどうか。

--カラースキーム=カラースキーム
出力で使用する色 (色が有効な場合)。 COLOR_SCHEME の形式は次のとおりです。
' : : : '。 数値と色の名前が受け入れられます。
空のフィールドはデフォルトの色を意味します。 例えば、 --git-color-scheme='シアン:34::'
デバッグ メッセージはシアン、情報メッセージは青、その他のメッセージは青で表示されます。
デフォルト (つまり、赤色の警告メッセージとエラー メッセージ)。

--debian-ブランチ=支店名
Debian パッケージが開発されている Git リポジトリ内のブランチ、デフォルト
is マスター.

--上流ブランチ=支店名
上流のバージョンを決定する分岐。 デフォルトは アップストリーム.

--git-upstream-tag=タグフォーマット
アップストリーム バージョンのタグを探すときは、このタグ形式を使用します。デフォルトは
アップストリーム/%(バージョン).

--ignore-ブランチ
現在のブランチが一致するかどうかをチェックしない debian ブランチ.

--debian-tag=タグ形式
使用されるタグ形式。debian バージョンにタグを付ける場合、デフォルトは debian/%(バージョン)s

--since=コミットする
コミットメッセージの読み取りを開始する コミットする.

--自動、 -a
スナップショット バナー (または
スナップショット バナーが存在しない場合は最後のタグ)。

--[no-]メタ
次のようなメタタグを解析します Closes：, ありがとう： & Gbps-Dch:. 以下のメタタグを参照してください。

--meta-closes=バグクローズタグ
バグをクローズする変更ログ エントリを生成するために検索するメタ タグ。 デフォルト
Debian と Launchpad をサポートするための 'Closes|LP' です。

--meta-closes-bugnum=バグ番号の形式
バグ番号を解析するために使用する正規表現。 デフォルトは
'(?:バグ|問題)?\#?\s?\d+'. 注: 正規表現はバグのすべての部分を抑制する必要があります
"(?:)" を使用したくない数値。詳細については、Python 正規表現のマニュアルを参照してください。

例： --meta-closes-bugnum="(?:bug)?\s*ex-\d+" は、次のすべてに一致します。

可能な Txt 一致? 結果
------------ ------ ------
バグ EX-12345 Y EX-12345
ex-01273 あり ex-01273
バグ ex-1ab Y ex-1
EX--12345N

--[いいえ-]フル
完全なコミット メッセージを変更ログ出力に含めます。

-- スナップショット、 -S
スナップショット リリース エントリを作成します。 これにより、スナップショットのリリース番号と警告が追加されます
changelog エントリへのバナー。 リリース バージョン番号は自動インクリメントされています
スナップショット中のパッケージのダウングレードを避けるために、すべての新しいスナップショット リリースで
テスト。

--スナップショット番号=表現
新しいスナップショット番号に eval() される Python 式。

- リリース、 -R
スナップショット リリース バナーとバージョン サフィックスをすべて削除し、現在の
への配布 不安定な、最終調整のために変更ログを開きます。

--新しいバージョン=バージョン, -N バージョン
バージョンを含む新しい変更ログ セクションを追加します 新しいバージョン。 一緒に -スナップショット
スナップショット番号が追加されます 新しいバージョン.

- チーム チーム アップロードの変更ログ エントリを作成します。

--bpo バックポートへのアップロードの Debian リリース番号を増やし、バックポートを追加します
変更ログのコメントをアップロードします。

--nmu メンテナ以外のアップロードの Debian リリース番号を増やします。

--qa Debian QA チームのアップロード用に Debian リリース番号を増やし、QA を追加します
変更ログのコメントをアップロードします。

--配布=名
分布フィールドを 名.

-- 力分布
で指定された分布を強制する - 分布 使わなくても使える
既知のディストリビューションのリストと一致します。

--緊急=レベル
緊急度フィールドを レベル.

--git-log=git ログ オプション
逐語的に渡されるオプション git-ログとします。

--id-length=N
含める N 変更ログ エントリのコミット ID の数字。 デフォルトは含めない
すべてのコミットID。

--ignore-regex=正規表現
一致するコミット行を無視する 正規表現 変更ログを生成するとき。

--git-作者
から user.name と user.email を使用します。 git-config(1) 変更ログ トレーラー用。

--[no-]multimaint-merge
メンテナーごとにコミットをマージします。

--spawn-editor=[常に|スナップショット|リリース]
エディターを生成するかどうか: 常に、スナップショットを実行するとき、またはリリースを実行するとき。

--commit-msg=メッセージ形式
生成されたメッセージをコミットするときに、コミット メッセージにこのフォーマット文字列を使用します
changelog ファイル ( - 専念 が与えられます）。 デフォルトは アップデイト 変更履歴 for
%(バージョン)s リリース

- 専念
生成された変更ログをコミットします。

--カスタマイズ=カスタマイズファイル
から Python コードを読み込む カスタマイズファイル. 現時点で唯一便利なのは
コードでできることは、カスタムの format_changelog_entry() 関数を定義することです。

概要 モード

スナップショット モードを使用すると、テストとインストールのサイクルを迅速に行うことができます。
バージョン番号または変更ログ エントリ。

使用時 -スナップショット or -S, GBP DCH Debian changelog の疑似ヘッダーを使用して
変更ログエントリを追加した最後の git commit を覚えておいてください。 また、バージョン番号を設定します
で終わります 〜 。英ポンド. スナップショットを自動的にインクリメントします
の後続の呼び出しの数 GBP DCH -S 後のスナップショットが自動的に
より高いバージョン番号。 スナップショット モードを終了するには、 GBP DCH - リリース オプションを選択します。
これにより、疑似ヘッダーが削除され、バージョン番号がマングル解除されるため、リリースされたバージョン
スナップショットよりも高いバージョン番号を持っています。

META タグ

上記のオプションに加えて、コミットメッセージのフォーマット debian / changelog
git commit メッセージで指定された特別なタグ (メタ タグと呼ばれる) によって変更できます。 メタ
タグ処理は、 -メタ オプション。 タグは先頭から開始する必要があります
コミットメッセージの列ですが、どの行にも表示できます。 それらは次の形式です タグ名:
値. 有効なメタ タグは次のとおりです。

Gbps-Dch: アクション
サポートされているアクションは次のとおりです。 無視する 生成時にこのコミットを無視します
debian / changelog, ショート の説明 (最初の行) のみを使用します。
変更ログ エントリを生成するときのメッセージをコミットします (次の場合に役立ちます)。 - 満杯 が与えられます)、
& フル これは、変更ログ エントリを生成するときに完全なコミット メッセージを使用します。
(こんなときに便利 - 満杯 は与えられない）。

に加えて Gbps-Dch、非推奨 Git-Dch まだサポートされています。

ありがとう： MSG
コミット メッセージの後に感謝のメッセージを追加します。

Closes： バグ番号
で示す debian / changelog このコミットによってバグがクローズされたこと。 を参照してください
--メタクローズ これを他のバグトラッカーに拡張する方法について。

次の git commit メッセージ:

ドキュメントのメタ タグ

そのため、マニュアルを参照する必要はありません

Gbp-Dch: ショート
終了: #636088
ありがとう: Raphaël Hertzog の提案

この結果 debian / changelog エントリ：

* ドキュメントのメタ タグ。
提案をしてくれた Raphaël Hertzog に感謝します (終了: #636088)

CONFIGURATION ファイル

いくつかの gbp.conf 上記のコマンドライン引数のデフォルトを設定するために、ファイルが解析されます。
ジョブの設定方法については、 gbp.conf（5）>詳細はマンページ。

onworks.net サービスを使用してオンラインで gbp-dch を使用する