Beefy Boxes and Bandwidth Generously Provided by pair Networks
Think about Loose Coupling
 
PerlMonks  

Re: Binary File warning when using POD documentation

by LanX (Saint)
on Sep 05, 2021 at 16:07 UTC ( [id://11136472]=note: print w/replies, xml ) Need Help??


in reply to [SOLVED]: Binary File warning when using POD documentation

Hi

Your terminal/pager is different than expected by perldoc.

This can be configured as an option at startup or with various ENV variables named PERLDOC*.

I'd recommend reading this recent threads perldoc Bold, Italic etc, especially Re: perldoc Bold, Italic etc (updated) and of course the linked docs.

My guess perldoc -oman should fix it.

Update

> (By the way, I occasionally see this same behaviour with other POD documentation from other sources, but it is thankfully rare...

This sounds like an encoding issue or (less likely) OS specific line ending.

Please compare those files to find the differences.

update

perldoc -l shows the path

perldoc -m will cat original code

Cheers Rolf
(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery

Replies are listed 'Best First'.
Re^2: Binary File warning when using POD documentation
by amcleod (Novice) on Sep 05, 2021 at 16:51 UTC

    After reading through the references you suggested and trying various proposed solutions, I corrected the issue by inserting

    export PERLDOC_PAGER="less -isR"
    into my ~/.bashrc file. Now I will attempt to mark this as "SOLVED".

      Glad it helped! :)

      Actually perldoc should work out of the box on every *nix OS. And your random results look weird.

      But of course there are plenty of ways to mess up.

      If you are curious to find out, you might consider running tests with -D and PERLDOCDEBUG set to a positiv value

      Cheers Rolf
      (addicted to the Perl Programming Language :)
      Wikisyntax for the Monastery

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://11136472]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others scrutinizing the Monastery: (5)
As of 2024-04-19 23:04 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found