nDiki : GNU Make

プロジェクト関連ドキュメントを TeX で

現在進行中のプロジェクトの一つがそろそろ大詰め。 ドキュメント書きに突入。 前回までは過去の方法を踏襲して MS Word ベースだったのだが、自分がマネージャーになった今期からは全面的に TeX ベースへ移行させる。

• Subversion で管理
  • プロジェクト用 texmf は外部定義 (svn:externals)を使用して共有
• Linux、Windows のどちらでもビルドできるように
  • tex ファイルのエンコーディングは ISO-2022-JP
  • mendex の辞書ファイルは Linux では日本語EUC、Windows ではシフト JIS でないと駄目なようなので、make 時に nkf でコード変換して texmf 以下から手元へコピー

Linux と Windows でそれぞれ

• pLaTeX
• mendex
• ebb
• dvipdfmx
• nkf
• GNU Make (Linux)
• nmake (Windows)

を用意。 Makefile は時間がなかったので GNUmakefile と Makefile を作って Linux 用と Windows 用の両方作ったのだが、後々面倒なので一本化したい。

Windows 用 GNU Make

Windows だと nmake がやっぱり主流だろうか。 しかし GNU Make とは違う点が多く、使い分けるのも面倒。 かといって Ant というのも面倒。

ということで気軽に使える Windows 用の GNU Make を探す。 Cygwin 版は共同作業者に入れてもらうのが面倒なので却下(Makefile から呼ばれるコマンド群もLinuxと同様のものが入るのでこちらの方が便利といえば便利ではあるのだが)。

MinGW版が 3.80 をポーティングしているし単体でも動きそうなのでこれを試してみることにする。

mingw32-make-3.80.0-3.exe を取ってきて実行。make そのものだと思っていたがマニュアル等を含むインストーラだった。 一旦インストールして、mingw32-make.exe をコピーしてアンインストール。 mingw32-make.exe 単体で動作するので取り扱いが楽でよい(必要なら make.exe にでもリネーム)。

Windows 特有の問題があるかどうかは今後使ってみてチェックだな。

Windows 用 GNU tar

この間 Windows 用の GNU Make として MinGW版を選択して、プロジェクトのドキュメントのビルドの自動化をすすめている。

しかし(最初からわかっていたのだが)make だけでは駄目で各ユーティリティがなくて結構不便。 touch すら無いし。 幸い全員の環境に ActivePerl が入っていることが前提になっているので、必要ならスクリプトを書いていけばある程度はなんとかなる。

今日は、プロジェクトで開発したPerl モジュールのソースアーカイブを自動的に一時ディレクトリに展開して pod2latex をかけてごにょごにょという処理の Makefile を書く。 さすがに tar が無いと無理だ (Archive::Tar を使うという手もなくはないが結局標準ではないし)。

GnuWin32

ということでGNU tarを探す。例によってインストール不要という条件で。

MinGW の中からは探せず。 GnuWin32 のものを使ってみる。 ついでに gzip も

• tar.exe (GNU tar tar-1.13-1-bin.zip)
  • libiconv-2.dll (libiconv-1.8-1-bin.zip)
  • libintl-2.dll (libintl-0.11.5-2-bin.zip)
• gzip.exe (gzip-1.3.5-bin.zip)

fork できないとかで tar の -z オプションが使えない。かなりがっかり。

texinst753 (W32TeX Web2C-7.5.3 簡易インストーラ)

あれ、gzip が最初からPATH上にあるなと思ったら、texinst753 に含まれていた奴。 GNU tar も入っている。 ちょっとバージョンが古めだけど -z も効くし、これが扱いやすいかも。

なにより他のプロジェクトメンバの Windows BOX にもそれぞれ入っているはずだし。

ということで GNU tar 確保。

SCons は GNU Autotools のかわりになるか

NSIS のサイトによるとビルドに「SCons」を使うようしたらしい。

• クロスプラットフォーム
• Autoconf、Automake と同様の機能を統合
• LaTeX もビルトインサポート

と興味深いツールになっているようだ。

現在プロジェクトLaTeXベースのドキュメント生成には GNU Make を使っているのだが、UNIX、Windows の両方でビルドできるようにするには ComSpec 環境変数の有無で使用するコマンドを切り換えたり等いろいろ面倒なので、代替ツールとして使えないかなと。

基本的な機能は Make に対する改良がなされているようであるし、コピー等ファイル操作も SCons 自体がもっているのでクロスプラットフォームでビルドできるようにするのも楽そうだ。

一方 Autoconf 系の機能については、インストール済みのライブラリの検出や実装レベルのチェック等を実装しているようである。 make check や make dist、make install 等にあたるターゲットに関する機能(あるいは規約)のようなものは無い。これは非常に残念。 結局自分が Ant を使わなくなったのも GNU Autotools にあるこれらの機能に欠けているからであるし。

実は私がPerl が好きな理由の一つとして、これらサポートが充実しているという点がある。Perl では ExtUtils::MakeMaker (あるいは Module::Build)があり、ビルドからテスト、ソースパッケージのパッケージングまでフレームワークが整っている。

SCons は Python ベースで、Makefile にあたるファイルも Python スクリプトである。 SCons が影響を受けた Cons は Perl ベースであったのだが、既に2001年5月ごろから開発が止まってしまっている。残念。

ということで Make の代替には使えそうであるが、GNU Autotools と同じようなことをするにはいろいろ手をかけないといけないといった印象。

SCons 微妙

SCons で pLaTeX2e ソースファイルを PDF に変換する SConstruct ファイルを書いてみた。

 bb_builder = Builder(action = 'ebb $SOURCE',
                      suffix = '.bb', src_suffix = '.png')
 pdf_builder = Builder(action = 'dvipdfmx -V 4 $SOURCE',
                       suffix = 'pdf', src_suffix = '.dvi')
 env = Environment(LATEX = 'platex')
 env.Append(BUILDERS = {'BBBuilder' : bb_builder})
 env.Append(BUILDERS = {'PDFBuilder' : pdf_builder})
 env.PDFBuilder(target = 'example-doc')
 env.DVI(target = 'example-doc', source = 'example-doc.tex')
 env.Clean('example-doc.dvi',
           ['example-doc.log', 'example-doc.out',
            'example-doc.toc', 'example-doc.aux'])
 env.Depends('example-doc.dvi', 'image1.bb')
 env.Depends('example-doc.dvi', 'image2.bb')
 env.Depends('example-doc.dvi', 'image3.bb')
 env.BBBuilder('image1')
 env.BBBuilder('image2')
 env.BBBuilder('image3')

• 組み込みの PDF builder が今いち挙動がよくわからないので Builder を作成
• .bb ファイル用の Builder を作成
• latex ではなく platex を使うように

.tex から .dvi の生成ルールでは、補助ファイルを見て適宜数回 platex を実行してくれる。ここら辺はさすが。

GNU Make のような暗黙のルールの適用がない(わからない)ので、.bb ファイルを dvi の依存ファイルに指定するだけでは駄目で、ビルド指定をする必要があるのがちょっと面倒。

これだけだと GNU Make より便利とはいえないな。 プラットフォームによって異なるコマンド(cp / copy など)を使うような事や、もうちょっと複雑な事などをしないとそれほどメリットがでないか。

Module::Build でソースパッケージング

ExtUtils::MakeMaker

私が Perl が好きな理由の一つに、標準でExtUtils::MakeMakerという Makefile ジェネレータがついているところである。これを使って Makefile.PL を書くと

 perl Makefile.PL
 make manifest
 make
 make test
 make dist

で <pacakge>-<versionno>.tar.gz というソースパッケージを作ることができ、

 tar zxvf <pacakge>-<versionno>.tar.gz
 cd <pacakge>-<versionno>
 perl Makefile.PL
 make
 make test
 make install

という手順でインストールする事ができるようになる。 パッケージの作り方が確立されているので、容易に新しいパッケージを開発しはじめられる。

逆に Java でプログラムを書くのが億劫なのは、このあたりの準備が面倒だからである。 Ant を使っても結局ここら辺自分でやらなければならないし。

ちょっとしたアーカイブの作成

ちょっとしたパッケージを作りたいと思うことは良くある。 例えばいくつかのデータファイルと、READMEファイルなんかをひとまとめにしてアーカイブにするとか。

本当にちょっとしたであれば、手動でアーカイブすれば良いのだが、

• アーカイブしたいファイル群がバージョン管理下にあって、CVS ディレクトリや .svn ディレクトリがある (除外してアーカイブする必要がある)
• 同じディレクトリにある、作業用のファイルはアーカイブしたくない (除外してアーカイブする必要がある)
• アーカイブする前に、チェック用のリグレッションテスト一式を走らせたい (リグレッションテストをかけられるようにする)
• UNIX でも Windows でもアーカイブ化できるようにしたい。

あたりを考慮しなければならない時は面倒くさくなってくる。

自動化としては

• シェルスクリプト/バッチファイルを書く
• Makefile を書く
• GNU Autotools を使う

あたりがぱっと思い浮かぶ。 しかし、最初の2つは毎回同じようなものを書くのが面倒だし保守もしにくい。 GNU Autotools はちょっとごっつすぎだし、Windows での環境構築も面倒。

ExtUtils::MakeMaker の欠点

ということで最初は ExtUtils::MakeMaker を使うという線で考えてみた。 もともと Perl モジュール用で汎用用途にはちょっと邪魔な振舞いもあるが、使えないことはないと思う。 しかし make (GNU Make あるいは nmake など) に依存しているという欠点がある。

Module::Build で

ということで ExtUtils::MakeMaker の代替である Module::Build ベースで汎用用途に使えないか検討してみた。こちらは pure Perl で make を必要としない。

Module::Build も Perl モジュールビルドにあわせた振舞いがあるものの、ちょっとカスタマイズすれば使えそうだ。 で、いろいろいじった結果、次のような感じにすると使いやすそうだ。

 use Module::Build;
 my $class = Module::Build
   ->subclass(class => 'NonmoduleBuilder',
              code => q{
                        # Don't make blib
                        sub ACTION_code {};
                        # Don't make blib
                        sub ACTION_docs {};
                        # Don't make META.yml
                        sub ACTION_distmeta {
                          # no warning on ACTION_distdir
                          $_[0]->{metafile} = 'MANIFEST';
                        };
                        # Don't add MEATA.yml to MANIFEST
                        sub ACTION_manifest {
                          $_[0]->{metafile} = 'MANIFEST',
                          $_[0]->SUPER::ACTION_manifest(@_);
                        };
                       });

 # Set your archive name and version.
 $class->new(dist_name => 'mypackage',
             dist_version => '1.0.2',
             )->create_build_script;

カスタマイズした部分は以下(Module::Build 0.26 で動作確認)。

• Perl モジュールビルドに特有の blib ディレクトリを作らないようにする。
• META.yml を生成しないようにし、アーカイブに含まれないようにする。

上記のようなファイルを Build.PL という名前で作っておけば

 perl Build.PL
 ./Build manifest
 ./Build
 ./Build test
 ./Build dist

等として、アーカイブ作成が容易にできるようになる。

しばらくこの方法でいろいろ試してみることにしてみよう。

今日のさえずり: 最近 CM で「しりあがり寿」の名を見る。うちでは画伯扱い (ほぼ日手帳の影響)。

• 10:17 プロジェクトのスケジュール共有用に Google カレンダー上に、1つカレンダーを新規作成。 *Tw*
• 10:50 GNU Make (Win32) では変数を設定しても、そのままではコマンド実行時の環境変数には入らないことを思い出した。 *Tw*
• 11:57 最近 CM で「しりあがり寿」の名を見る。うちでは画伯扱い(ほぼ日手帳の影響)。 *Tw*
• 12:32 着もと化した。 *Tw*

今日のさえずり: パスワードを暗記しておくのに何バイト消費しているのだろう

2010年09月09日

• 09:16 あ、窓の下で自転車おろしてる。届いたっぽい。
• 09:47 前の電車がつまっていたので、まだ新橋駅。
• 11:05 TeraStation PRO のバックアップがやはり rsync: writefd_unbuffered failed to write 1066 bytes [sender]: Broken pipe (32) と出て止まっているなあ。
• 11:05 TeraStation PRO のファームウェアをアップデートしてみるか。
• 12:04 幕の内弁当 398円。 (@ ファミリーマート神田佐久間町店) http://4sq.com/biJuCj
• 12:41 テールランナーぽちった。
• 13:12 ptexlive のコンパイル通った(Debian GNU/Linux sid)。これから pLaTeX2e 文書は UTF-8 で書くことにしよう。
• 14:47 いくつものパスワードを暗記しておくのに何バイト脳の中を消費しているのだろう。
• 14:58 @pureminami そうですね。自分も基本は KeePass で管理してますが、それでもマスターパスワードと1日に何回も入力するパスワードは脳に刻む必要があって。
• 15:23 W32TeX もインストールしておこう。
• 17:51 latexmk 使ってみているけど、なんか GNU Make 使った方が楽。
• 19:05 Frieve Editor、Wine 上で動くのか。かなり遅いのでこれで何かを考える気にはならないけれど、既存データを閲覧したい時には使えるな。
• 20:07 松永真ストライプスコッティ復活の兆し。

今日のさえずり: テレビは代々2画面機能付きにしてる

2010年09月14日

• 08:29 @yakifumi REGZA 使い勝手どうですか? HDD 録画って活用してます?
• 09:38 ポケットティシュー配りの恩恵にあずかれるのって大都市圏だけなのかな、やっぱり。地方だと自腹で買うの? 義母が段ボール箱の隙間に入れて送ってくれる。
• 09:49 外人がガンの T シャツ着ててハッとした。
• 09:50 日本人がギャンの T シャツ着ててハッとした。
• 09:51 (後者はフィクション)
• 10:10 久しぶりに問題解決シートを使おう。
• 12:49 親子丼 490円。 (@ なか卯 神田佐久間町店) http://4sq.com/9tdwTs
• 13:04 REGZA 37ZS1ヨドバシカメラで見てきた。148,900円はまだちょっと高いなあ。他の37V型 REGZA は11万円台だったので、この差は大きい。 http://amzn.to/cwe4lQ
• 13:12 149,800円だった。 RT @Naney: REGZA 37ZS1ヨドバシカメラで見てきた。148,900円はまだちょっと高いなあ。他の37V型 REGZA は11万円台だったので、この差は大きい。 http://amzn.to/cwe4lQ
• 15:10 頂きます。 RT @as_tone: 業務連絡：クッキーが早くもしけってきているので早く食べて下さい。
• 15:11 環境変数 ComSpec っていつから comspec になったんだよう。 GNU Make の ifdef ComSpec が正しく動作していないのに気がつくのに結構かかってしまったよ……。
• 18:39 operational transformation (OT) って実装難易度高いのかな。
• 19:06 @yakifumi おお、そうですか。やっぱり REGZA にしようかなあ。今日見てきたんですが最新モデルはまだちょっと高かったので年内もう少し様子を見たいところではあります。
• 21:24 REGZA 37ZS1 はまだ割高なので 37Z1 の方がいいかなあ。機能はほぼ ZS1 と同じだし。 http://amzn.to/dgSKSr
• 21:49 今のテレビ (KV-28DX750) にメジャーあててみた。37V型にすると一回り大きくなる格好。まずまずかな。
• 23:21 テレビは代々2画面機能付きにしてる。使うの年に数回だけど。

今日のさえずり: 新しく開発しているアレ、勘定奉行的な名前に変更されました

• 09:47 昼食買っとく。 (@ ローソン 渋谷三丁目東店 - @akiko_lawson) http://4sq.com/19lWipi
• 10:19 久しぶりの朝チェックイン。 (@ 株式会社ミクシィ (mixi, Inc.)) http://4sq.com/1cxpuwV
• 13:13 “「GNUは衰退しました」「自由都市としてのフリーソフトウェア」、あるいは「『ハッカーはクラッカーじゃない。』の30年」──GNUについて知るワークショップ | サイボウズ式” http://bit.ly/1aokvcS
• 22:25 iPod touch バッグに放り込む用。 http://flic.kr/p/gwij68
• 23:43 Makefile の中で Scheme が使えるだって? / “本の虫: GNU Make 4.0にGNU Guileが組み込まれた” http://bit.ly/1hEVH3a
• 24:28 そういえば新しく開発しているアレ、勘定奉行的な名前に変更されました。若い人のセンス良くわかりません。