perldoc-search のインストール

perldoc-search つかえば良い - 理系学生日記を見て、便利そうだったので入れることにした。

インストール

$ cpanm App::Perldoc::Search

使い方

書式

perldoc-search <探したい文字列> <検索対象のディレクトリ>

例1：「perldoc-search」という文字列を含むPODを「~/perl5/lib」以下から検索

$ perldoc-search perldoc-search ~/perl5/lib
App::Perldoc::Search - implementation for perldoc-search

例2： 「Moose」という文字列を含み、且つファイル名に「Catalyst/Action」を含むPODを @INC から検索

$ perldoc-search Moose -G 'Catalyst/Action'

「-G」オプションでは正規表現が指定できる。ファイル名(というよりパス名)でマッチさせているらしく、「Catalyst::Action」では引っかからないので注意。
デフォルト(-Gオプション無し)では全ての「.pod, .pm, .pmc」ファイルを検索する。

メモ

あと、何故か分からないが、第二引数を指定しないとき(つまり@INCを検索対象としたとき)に以下のようなエラーが出る。。

Can't opendir(/Users/username/work/mysql5.1-export/mysql-test/var/install.db/mtr): Permission denied
 at /Users/username/perl5/lib/perl5/App/Perldoc/Search.pm line 103

何でこんなパスを開こうとしてるんだ?