Felicitations of the season to all you venerable monks out there ,

Having had a bit of a Super Search round (initially, I tried googling myself silly ... but enjoyed it far too much), I don't seem to be able to find what I'm looking for .. but then again it could be that I'm not asking quite the right question ;-)

This time, the question to which I seek an answer is (takes deep breath and asks more in hope than expectation) ...

Does anybody know of a way to use perldoc (or an alternative) in a manner similar to the perldoc -f <func> command to list the doc for a built-in.

The difference being that I'd like to run it against any CPAN/bespoke module such that the given functions' doc is listed from said module e.g. perldoc -f sub Foo::Bar to list the doc for Foo::Bar::sub() ... c/w perldoc Foo::Bar and get the user to trawl thro' looking for the requisite information on sub.

TIA ,

Sits back to await xmas and enlightening answers - but not necessarily in that order :-)

Update:

.oO(Hmmm, maybe emulate perldoc itself - getting the wanted behaviour by overloading one/some of the Pod::Perldoc::* methods as appropriate i.e. iff called with -f & 2 args and then handing off to perldoc itself...)

A user level that continues to overstate my experience :-))

In reply to POD, come let me see thee, I have thee not, but still I clutch thee by Bloodnok

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":



  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.