Beefy Boxes and Bandwidth Generously Provided by pair Networks
Your skill will accomplish
what the force of many cannot

perldoc PATH

by Anonymous Monk
on Jul 11, 2013 at 13:46 UTC ( #1043728=perlquestion: print w/replies, xml ) Need Help??
Anonymous Monk has asked for the wisdom of the Perl Monks concerning the following question:

Is it possible to specify PATH to a higher level directory and have perldoc search for the pod files under all sub directories?

for example, if I had a directory structure like

and I set the path to
export PATH=/root
will perldoc do a recursive search for the pod file? If not is there a way to make this happen?

Replies are listed 'Best First'.
Re: perldoc PATH
by toolic (Bishop) on Jul 11, 2013 at 14:03 UTC
    I don't think perldoc can recursively search the PATH directories. It does have a -r switch which can recursively search the @INC directories:
    perldoc -h -r Recursive search (slow)
    If you really need this, I guess you could append all the PATH dirs to @INC.

    See also perldoc -D

      Thanks. That works well. Bit slow (I guess because of the recursive search), but works OK.

      I am also going to generate 'man' files using pod2man. Is there a similar recursive search for UNIX man command as well.

      I also see that you can do a 'man' instead of perldoc for installed perl modules and the man page appears identical to perldoc output. For example

      man File::Path perldoc File::Path
      generate similar looking output.

      I do see that the man files are in a single directory. Does that mean I have to put the 'man' files in a single directory?


        Is there a similar recursive search for UNIX man command as well.
        Check the docs:
        man man
        I also see that you can do a 'man' instead of perldoc
        As documented in perldoc.

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://1043728]
Approved by Corion
Front-paged by toolic
[Corion]: ambrus: He isn't familiar with GIGO (or nIGO) yet?
[Corion]: Also, is it impossible in the general case, but doable in your specific case, maybe? I find that working through a counterexample usually makes people see the light
[Corion]: Uiiih! Let's Encrypt will start issuing wildcard certificates, that's cool!

How do I use this? | Other CB clients
Other Users?
Others musing on the Monastery: (8)
As of 2017-12-12 13:05 GMT
Find Nodes?
    Voting Booth?
    What programming language do you hate the most?

    Results (332 votes). Check out past polls.