7. パッチ¶

7.1. パッチとは¶

以下のリンクはパッチの本質と歴史を理解し、Mercurial ではどのように使われているのかを理解するのによい資料です。

7.2. 落とし穴¶

標準的なパッチ形式はバイナリファイルや名前変更、コピー、パーミッションの変更を記述できません。そのためまず GIT 形式のパッチを有効にする必要があります：

[diff]
git=True

Mercurial 1.5 ではこの振る舞いが改善され、GIT 形式の差分が必要な場合はユーザに警告を出すか、自動的に GIT 形式に変更します。詳しくは hgrc マニュアルの差分のセクションを参照してください。

Mercurial のパッチ処理は改行文字に一貫性のないソースファイルとパッチをうまく取り扱うことができないため、その解決方法として patch.eol 設定がバージョン 1.3 で導入されました：

[patch]
eol = auto #strict, lf, or crlf

hgeol 拡張機能もこの領域の問題の改善に取り組んでいます。おそらく Mercurial 1.5 で解決します。詳しくは詳しくは hgrc マニュアルのパッチのセクションを参照してください。

実のところパッチの適用というのはそれほど簡単な作業ではありません。もしソースファイルがパッチ作成時から枝分かれしてしまっていたら、パッチ適用時に衝突が起こり、.rej という拡張子のファイルが生成されます。 TortoiseHg 1.0 からこれらの除外されたハンクをうまく適用してくれる実験的な hgtk mpatch コマンドが導入されました。このコマンドは Chris Mason による mpatch ツールが元になっています。この mpatch でも適用できなかったハンクは手動で適用するしかありません。

7.3. パッチのエクスポート¶

7.3.1. チェンジセット¶

チェンジセットをパッチとして保存するには、チェンジログビューアでチェンジセットの右クリックメニューからエクスポート ‣ パッチの作成を選択してください。ファイル保存ダイアログが表示されます。

7.3.2. リビジョン範囲¶

チェンジログビューアでリビジョンの範囲を選択してください。始点 (base) となるチェンジセットを左クリックで選択し、次に終点 (target) のチェンジセットの上で右クリックすると、このリビジョン範囲に対するコマンドを含んだ右クリックメニューが表示され、パッチの生成・バンドルの保存、メール送信、そして選択範囲のチェンジセットの変更点を積み重ねた差分を見ることができます。

始点と終点の選択には制限がないため、この操作は非常に強力な機能です。

7.3.3. メール送信¶

メール送信ダイアログ

単独のチェンジセットを送るにはチェンジログビューアでチェンジセットの右クリックメニューを使用してください: エクスポート ‣ メールで送信... 。選択するとメール送信ダイアログが開きます。

リビジョン範囲をまとめて送る場合はリビジョン範囲の右クリックメニューからこの範囲をメールで送信... を選択してください。

最後に、選択中のリモートリポジトリにすべてのチェンジセットを送るために同期ツールバーのメール送信ボタンを使うこともできます。

注釈

パッチをメールで送信するには事前に SMTP の設定が必要です。

7.3.4. チェンジセットのつまみ食い¶

チェンジログビューアでリビジョン範囲の右クリックメニューの選択中のリビジョンとの差分を使用してください。始点から終点までのすべてのリビジョンにおける変更点を積み重ねた差分がステータスダイアログに表示されます。

ステータスダイアログではコミットツールと同じようにファイルおよびハンク選択機能を使うことができ、最終的な結果はプレビュータブで見ることができます。名前を付けて保存ボタンを押せば選択されている変更点をパッチファイルとして保存できます。

より手軽な方法としてはハンク選択画面で必要なハンクをハイライト (選択ではない) してから CTRL-C すればクリップボードに差分をコピーできます。

注釈

選択する順番を逆にすると、生成されるパッチの順番も逆になります。

7.4. パッチのインポート¶

インポートダイアログ

インポートダイアログはログビューアの同期バーまたはメニューから、もしくはコマンドラインから hgtk import で開くことができます。このダイアログはファイルマネージャからのファイルおよびディレクトリのドラッグ＆ドロップ操作に対応しています。選択ボタンの右隣ににあるドロップダウンメニューには、パッチを含むディレクトリを選択するためのディレクトリの選択... メニューと、クリップボートから取り込むクリップボートからインポートメニューがあります。

リポジトリに直接インポートするか、MQ にインポートするか選択できます。

注釈

パッチのインポートを正しく行うには作業ディレクトリがクリーンでなければなりません。インポートする前に未コミットの変更点をコミット、元に戻す、またはシェルフしてください。

警告

コミットメッセージのないパッチをインポートすると Mercurial はエディタを起動して入力を促します。そのため ui.editor 設定値として GUI エディタが設定されている必要があります。

7.5. MQ (パッチキュー)¶

ログビューアの MQ パネル

リポジトリで MQ 拡張機能が有効化されていると、ログビューアとコミットツールで MQ パネルが利用可能になります。MQ パネルでは qpush、qpop、qrename、qfinish を含むほとんどのパッチ操作を行えます。MQ パネルを使う前に MQ 拡張機能について学んでおくことをお勧めします。