Tatsuhiko Miyagawa's Blog

perldoc-search

October 29, 2009

Joshua ben Jore / App-Perldoc-Search-0.03 - search.cpan.org

I’ve been always having problems locating the right POD files when I deal with a big module/software/framework in Perl, for instance, Moose. They have a fairly good amount of document, but merely doing perldoc Moose doesn’t give me what I want to know: I usually need to do perldoc Moose::Manual and then perldoc Moose::Cookbook to scan for the things by typing i want to know. It’s tedious.

perldoc-search is awesome: it gives you an ability to search your local POD files without building index like Spotlight. For instance, when I need to know how to mangle new() args in Moose, i can just type: perldoc-search BUILDARGS -G Moose (-G is a regular expression to match filenames to look for) and it gives you a fairly small amount of files, including Moose::Cookbook::Basics::Recipe10 which exactly tells me what I need to know.

install App::Perldoc::Search now and enjoy.