On May 4, 2011, at 12:39 AM, Eric Robertson wrote:
> Just finished building, testing and installing perl 5.12.3 for OpenVMS Alpha
> V8.3. Everything appeared normal throughout. Afterward I was Just plinking
> around with the perl documentation utility and noticed that it does not
> appear completely functional:
>
> $ perldoc "perldoc"
> No documentation found for "perldoc".
> %RMS-E-FNF, file not found
> $ perldoc "-D" "perldoc"
> Ending switch processing. Args are [perldoc] with 0 errors.
> perl_root:[utils]perldoc.com => Pod::Perldoc v3.15_02
>
> Formatter class Pod::Perldoc::ToText successfully loaded!
> Will format with the class Pod::Perldoc::ToText
> Searching for perldoc
> Looking for perldoc in perl_root:[utils] perl_root:[lib.site_perl.VMS_AXP]
> perl_root:[lib.site_perl] perl_root:[lib.VMS_AXP.5_12_3]
> perl_root:[lib] . DISK_CSWB:[CSWB] DISK_XPDF:[APPLICATIONS.XPDF]
> GNV$GNU:[BIN] perl_root:[lib.pod]
> Looking for perlperldoc in perl_root:[utils]
> perl_root:[lib.site_perl.VMS_AXP] perl_root:[lib.site_perl]
> perl_root:[lib.VMS_AXP.5_12
> _3] perl_root:[lib] . DISK_CSWB:[CSWB] DISK_XPDF:[APPLICATIONS.XPDF]
> GNV$GNU:[BIN] perl_root:[lib.pod]
> No documentation found for "perldoc".
> %RMS-E-FNF, file not found
>
> Is this expected? has anybody else experienced this or can somebody else
> repeat the problem? I haven't looked at the source to see what file it is
> looking for. Maybe there is something missing in the install step?
>
Good catch. It's looking in perl_root:[lib.pod], but the file actually lives
in perl_root:[lib.pods] (plural):
$ dir perl_root:[000000...]perldoc.pod
Directory PERL_ROOT:[000000.LIB.PODS]
perldoc.pod;1
Total of 1 file.
It should be an easy fix to just add the "s" on the end of the search directory
here:
$ sea perl_root:[000000...]*.pm "lib.pod"
******************************
PERL_ROOT:[000000.LIB.VMS_IA64.5_12_3.POD]perldoc.pm;1
push(@searchdirs,'perl_root:[lib.pod]') # installed pods
________________________________________
Craig A. Berry
mailto:craigbe...@mac.com
"... getting out of a sonnet is much more
difficult than getting in."
Brad Leithauser
