perldoc can't display doc

[Ronald Fischer]

I'm running Perl 5.8 under cygwin. When I do something like

perldoc IO::File

I get the error message

Ignored /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm: unreadable
No documentation found for "IO::File".

Although the file /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm
is clearly readable.

When I do a

perldoc -f open

I get the error message

Ignored /usr/lib/perl5/5.8.0/pods/perlfunc.pod: unreadable
No documentation found for "perlfunc".

In fact, I can't get at any documentation with perldoc.

Any suggestions?


Ronald

[Bart Lateur]

Ronald Fischer wrote:

>I'm running Perl 5.8 under cygwin. When I do something like
>
>perldoc IO::File
>
>I get the error message
>
>Ignored /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm: unreadable
>No documentation found for "IO::File".
>
>Although the file /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm
>is clearly readable.

....

>In fact, I can't get at any documentation with perldoc.

Check out the file permissions under that file tree. I'm assuming Cygwin
does at least some attempt in emulating Unix in that regard.

HTH,
Bart.

[ko]

Ronald Fischer wrote:

> I'm running Perl 5.8 under cygwin. When I do something like
>
> perldoc IO::File
>
> I get the error message
>
> Ignored /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm: unreadable
> No documentation found for "IO::File".
>
> Although the file /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm
> is clearly readable.
>
> When I do a
>
> perldoc -f open
>
> I get the error message
>
> Ignored /usr/lib/perl5/5.8.0/pods/perlfunc.pod: unreadable
> No documentation found for "perlfunc".
>
> In fact, I can't get at any documentation with perldoc.
>
> Any suggestions?
>
>
> Ronald

You might want to double-check that the 'perl_manpages' are installed.
When you run cygwin setup (Select Packages) it is listed under 'Docs'
category. Not 100% sure, but I don't think it is installed by default.

HTH - keith

[thorsten schau]

"Ronald Fischer" <ronaldf@eml.cc> wrote in message
news:219750c.0309080040.2f36d379@posting.google.co m...

> I'm running Perl 5.8 under cygwin. When I do something like
>
> perldoc IO::File
>
> I get the error message
>
> Ignored /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm: unreadable
> No documentation found for "IO::File".
>
> Although the file /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm
> is clearly readable.
>
> When I do a
>
> perldoc -f open
>
> I get the error message
>
> Ignored /usr/lib/perl5/5.8.0/pods/perlfunc.pod: unreadable
> No documentation found for "perlfunc".
>
> In fact, I can't get at any documentation with perldoc.
>
> Any suggestions?

did you try man IO::File ?
works for me .. sometimes :)

thorz

[Ronald Fischer]

Bart Lateur <bart.lateur@pandora.be> wrote in message news:<4kgolv4bpk69tj0pvnnsn0c9vvirobve1t@4ax.com>. ..

> Ronald Fischer wrote:
>

> >I'm running Perl 5.8 under cygwin. When I do something like
> >
> >perldoc IO::File
> >
> >I get the error message
> >
> >Ignored /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm: unreadable
> >No documentation found for "IO::File".

> Check out the file permissions under that file tree. I'm assuming Cygwin
> does at least some attempt in emulating Unix in that regard.

$ ls -l /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm
-rwx------+ 1 Administ mkgroup_ 3955 Jun 2 15:41
/usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm

so I tried:

$ chmod ugo+r /usr/lib/perl5/5.8.0/cygwin-multi-64int/IO/File.pm
$ perldoc IO::File
Error in tempfile() using /XXXXXXXXXX: Parent directory (/) is not
writable
at /usr/bin/perldoc line 564

Then I checked:

$ ls -ld /
drwx------+ 8 Administ mkgroup_ 4096 Jun 2 14:25 /

After doing a

$ chmod ugo+rwx /

I can indeed display the docs.

So you were right in that it had to do with file permissions. Setting
/ to 0777
is not as bad as it sounds, since this is Windows and the idea of Unix
groups
isn't present there anyway.... But I wonder why tempfile() wants to
create
his file in /. I thought that, by default, it would use the content of
the
environment variable TMP or TEMP (both are set on my system), or
otherwise
use /tmp. Any ideas about this?

Ronald