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.