TSfree 発言

  ずいぶん前にちらっと

http://rakunet.org/TSNET/TSperl/9/291.html

  に書いたのですが、

Pdoc
http://pdoc.sourceforge.net/

  を動かしてみました。

  以下は何も分からないままとりあえずやってみた記録です。

ダウンロード
------------

  なんか普通に Download のページを見ると名前の入力とか要求されるので、邪
魔くさい人は

http://sourceforge.net/projects/pdoc

  から落としましょう。

モジュールのインストール
------------------------

  INSTALL とかそういうファイルがアーカイブに入っていません。ただ、
Makefile.PL が入っているだけです。なんだっけこれと思っていたのですが、手
順はこうでした。

 perl Makefile.PL
 make
 make install

  ということで make が必要です。私は cygwin 環境で試したので ActivePerl 
オンリーな環境でどうやってインストールするのかは分かりません。

  インストール先は最初の perl Makefile.PL で呼び出される MakeMaker.pm が
自動的にセットしてくれるのですが、自分で決めたいという場合は Makefile の
中で

 PREFIX =
 SITEPREFIX =

  の部分を設定すればいいと思います。私が cygwin で試したときは、デフォル
トで PREFIX が値なし、SITEPREFIX = /usr になっていて、実際のモジュールは 
/usr/lib/perl5/site_perl/5.8.2/Pdoc/ 以下にインストールされました。

ドキュメント作成ツール本体
--------------------------

  しかしこれでインストールされるのはモジュールだけでして、実際にモジュー
ル群からドキュメントを生成するには紐解いたアーカイブの中の 
scripts/perlmod2www.pl が必要です。これは make ではインストールされない
ので、自分で適当な場所にコピーしてください。

--
    ねこ丸