dpatch をつかってみよう

上川純一
___________________________________________________________________________________________________________________________

11.1 dpatch とは

Debian のソースパッチを管理するツールです． Debian パッケージでは，ソースパッケージは以下の構成になっています．

この中で， .diff.gz は一つの大きな差分ファイルとして管理されるため，どの部分がどういうパッチであるか，ということを管理してはくれません．その部分を実装するのが dpatchです．

通常の.diff.gz であると， debian/ディレクトリ以下の Debian パッケージング用の情報とそれ以外のソフトウェア自体への修正が混合しています．それを整理するというものです．

11.2 ファイル構成

dpatch では，それぞれの小さな変更をそれぞれ独立したパッチとして扱います．それぞれのパッチを debian/patches/xx patchname.dpatch という名前で管理します．例えば， debian/patches/01 configure.dpatch という名前になります．そして，パッチの一覧を debian/patches/00listに適用する順番に記述します．そこでは， 01 configureというような形式で記述できます．

この形式を採用しているため， Debian においての変更点が debian/ディレクトリ以下に集まり，また変更点を debian/patches ディレクトリで分類して管理できる，という利点があります．

dpatch でのファイル名が数字ではじまるのは昔はその番号で適用順序を決定していたなごりです．今はあまり数字を利用する必要性はありません． debian/patches/00list ファイルに指定した順番でパッチは適用されます．

11.3 道具

11.3.1 dpatch

dpatch コマンドは，パッチの適用とパッチをはずすという処理を実施してくれるコマンドです．従来は， makefile から include する Make スクリプトとして実装されていましたが， dpatch 2.0 からは実体が /usr/bin/dpatch シェルスクリプトになっています．

include /usr/share/dpatch/dpatch.make

最近の dpatch を利用するソースでは， dpatch コマンドを呼ぶように実装すればよいことになっています． (/usr/share/doc/dpatch/examples/rules/rules.new.dh.gz から抜粋)

#!/usr/bin/make -f
#
# Sample dpatch rules file. Only example. Nothing else. :)
# This one uses the new way with dpatch from dpatch 2.x

export DH_COMPAT = 4

CFLAGS = -Wall -g
ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
CFLAGS += -O0
else
CFLAGS += -O2
endif

build: build-stamp
build-stamp: patch
@echo "--- Compiling"
dh_testdir
# Do something to build your package here
touch build-stamp

clean: clean1 unpatch
clean1:
@echo "--- Cleaning"
dh_testdir
dh_testroot
dh_clean -k
# Clean your build tree

install: build-stamp
dh_testdir
dh_testroot
dh_clean -k
dh_installdirs
# Install it here

# Build architecture-independent files here.
binary-indep: build install

# Build architecture-dependent files here.
binary-arch: build install
dh_testdir
dh_testroot
dh_installdocs
# And all the other dh_* stuff you need for your package.

# And now the simple things for dpatch. Here we only apply/unapply the patches.
# You can do more things with dpatch, like having patches only applied on
# a special architecture - see the non-dh version of the sample for this!
patch: patch-stamp
patch-stamp:
dpatch apply-all
#dpatch call-all -a=pkg-info >patch-stamp

unpatch:
dpatch deapply-all
rm -rf patch-stamp debian/patched

binary: binary-indep binary-arch
.PHONY: binary clean binary-indep binary-arch build install patch unpatch \
clean1

11.3.2 dpatch-edit-patch

基本的な使い方は dpatch 管理下にあるソースコードのディレクトリで，

dpatch-edit-patch -d ’ 説明文’ 03_patchname 02_patchname

のように入力すると，二つ目のパラメータに指定したパッチまでのパッチを適用した状態で，一時ディレクトリにソースを展開してくれ，シェルが起動します．パッチ名には.dpatch 拡張子をつける必要はありません．

編集したのち，シェルから出ると，一つ目のオプションに指定した名前のパッチを作成してくれます．

debian/patches/00list ファイルは編集してくれるわけではないので，自分で編集する事になります． debian/patches/00list ファイルを編集してパッチの名前 (.dpatch 拡張子をぬいたもの) を追加したらそのパッチが適用されるようになります．

11.3.3 dpatch.el

emacs 上で dpatch を使うために必要な， 00list ファイルや， .dpatch ファイルの編集用のモードです．

目標は dpatch-edit-patch の実装ですが，そこに至る前のコアの dpatch の部分の変更をしているだけで現在は時間が過ぎていってます．

11.4 作業フロー

作業のフローについては，これよりよい方法がある，などありましたら教えてください．

11.4.1 あたらしい upstream が出た時