Beefy Boxes and Bandwidth Generously Provided by pair Networks
P is for Practical
 
PerlMonks  

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

root/sub1/sub2/file.pod
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?

Comment on perldoc PATH
Select or Download Code
Re: perldoc PATH
by toolic (Chancellor) 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?

      Thanks

        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?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://1043728]
Approved by Corion
Front-paged by toolic
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others perusing the Monastery: (15)
As of 2014-12-22 21:22 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    Is guessing a good strategy for surviving in the IT business?





    Results (130 votes), past polls