debian/rules の書き方の情報源

debian/rules の書き方の情報源はあちこちにあるが，どれが時代遅れでどれが最新かよくわからないのでネットを逍遙して検討してみた．

• 原典としては「Debian Policy Manual 4.9 Main building script: debian/rules」がある．「Debian New Maintainers’ Guide」を読むと理解しやすい．
• 「Debian Developer’s Reference」によると，debhelper を使うようだ．以下のような雰囲気：

binary-arch: install
    dh_installdocs -a NEWS
    dh_installchangelogs -a ChangeLog
    dh_strip -a
    dh_compress -a
    dh_fixperms -a
    dh_installdeb -a
    dh_shlibdeps -a
    dh_gencontrol -a
    dh_md5sums -a
    dh_builddeb -a

• 「Debianパッケージ作成の手引き」によると，dh_* を使うと同じようなことを何度も書かなければならなくなるということで，これを解決するのが CDBS だということだ．以下のように変数や :: ターゲットでカスタマイズする雰囲気：

#!/usr/bin/make -f

include /usr/share/cdbs/1/rules/debhelper.mk

package = hello-cdbs

install/hello-cdbs::
	$(MAKE) prefix=$(CURDIR)/debian/$(package)/usr install

DEB_INSTALL_DOCS_ALL := NEWS
DEB_INSTALL_CHANGELOGS_ALL := ChangeLog

• 「Debian JP Project - 最近の話題」によると，debhelper v7 が提供する dh コマンドを使うと多くのパッケージで debuan/rules が 3 行で書けるようになると言うことだ．

#!/usr/bin/make -f
%:
    dh $@

• man debhelper, man dh 以外に公式のドキュメントはないようだが，作者のブログにいくつか記事がある．
  • cdbs killer (design phase)
  • debhelper dh overrides