osx - What is this error about perllocale in Perldoc? -

i discussing here setting no locales in perl , recommended run perldoc perllocale in osx yosemite 10.10.3 error:

error while formatting pod::perldoc::toman:   @ /system/library/perl/5.18/pod/perldoc.pm line 1346.    @ /usr/bin/perldoc5.18 line 11. got 0-length file /system/library/perl/5.18/pods/perllocale.pod via pod::perldoc::toman!?   @ /usr/bin/perldoc5.18 line 11. 

which perldoc gives /usr/bin/perldoc correct should be. echo $path gives

/usr/local/bin:/usr/bin:/opt/local/sbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/x11/bin:/usr/local/git/bin:/usr/texbin:/users/masi/.cabal/bin  

where notice have folders 2 times there possible overwriting should not cause of problem. .bashrc empty .profile has export lang=en_us.utf-8.

what perldoc error mean?

i got exact same error on osx yosemite 10.10.3

bessarabov@bessarabov-osx:~$ perldoc perllocale error while formatting pod::perldoc::toman:   @ /system/library/perl/5.18/pod/perldoc.pm line 1346.    @ /usr/bin/perldoc5.18 line 11. got 0-length file /system/library/perl/5.18/pods/perllocale.pod via pod::perldoc::toman!?   @ /usr/bin/perldoc5.18 line 11. bessarabov@bessarabov-osx:~$ 

the command perldoc -l perllocale shows path the file:

bessarabov@bessarabov-osx:~$ perldoc -l perllocale /system/library/perl/5.18/pods/perllocale.pod bessarabov@bessarabov-osx:~$ 

the file not empty , i've saved https://gist.github.com/bessarabov/20370992150a332dc0f0

osx yosemite 10.10.3 has perldoc version 3.19:

bessarabov@bessarabov-osx:~$ perl -mpod::perldoc -e 'say $pod::perldoc::version' 3.19 bessarabov@bessarabov-osx:~$ 

you can run perldocdebug=5 perldoc perllocale see debug info - here log https://gist.github.com/bessarabov/6e09b4e491d5a00c6304 not usefull.

i tried find out why perldoc fails. don't have exact answer, problem part of code in file /system/library/perl/5.18/pod/perldoc/toman.pm:

while( $offset <= $length ) {     $self->debug( "writing chunk $chunks\n" ); $chunks++;     syswrite $writer, ${ $self->{_text_ref} }, $chunk_size, $offset         or $self->die( $! );     $offset += $chunk_size;     ... } 

several interations of loop works, syswrite dies, , $! has no information error.

i able read documentation other parser:

perldoc -mpod::perldoc::totext perllocale 

the other way solve issue update latest version of pod::perldoc — perldoc 3.25 works fine file.