Bug 1614708

Summary: perldoc warns about binary data depending on TERM variable
Product: [Fedora] Fedora Reporter: A. Galama <agalama>
Component: perl-Pod-PerldocAssignee: Petr Pisar <ppisar>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 28CC: perl-devel, ppisar
Target Milestone: ---   
Target Release: ---   
Hardware: x86_64   
OS: Linux   
URL: https://rt.perl.org/Public/Bug/Display.html?id=131762
Whiteboard:
Fixed In Version: perl-Pod-Perldoc-3.28.01-1.fc28 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-05-03 11:09:11 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description A. Galama 2018-08-10 09:26:14 UTC
Description of problem:

Depending on the value of the TERM environment variable perldoc sometimes warns about binary content.


Version-Release number of selected component (if applicable):

perl-Pod-Perldoc-3.28-396.fc28.noarch
Perldoc v3.28, under perl v5.026002 for linux


How reproducible:


Steps to Reproduce:
1. TERM=xterm perldoc Time::HiRes
2. TERM=linux perldoc Time::HiRes

Actual results:
1. Everything fine
2. "/tmp/6UsPxoKooT" may be a binary file.  See it anyway?

The warning doesn't come up if I use "man" instead of "perldoc".

Comment 1 Petr Pisar 2018-08-10 11:26:23 UTC
This looks like an issue in Pod::Perldoc::ToTerm that adds ANSI sequences into the formatted output according to a current terminal:

E.g. the NAME section title changes:

-ESC[1mNAMEESC[0m
+ESC[1mNAMEESC[m^O

This is saved into a file and a pager, "/usr/bin/less -isr" probably, is called on that file. In the TERM=linux case /usr/bin/less comes to a conclusion that the file is a binary garbage and asks for permission to spoil a terminal.

And indeed the TERM=linux output is not propebly displayed on Linux virtual terminal, an `O' letter hangs after the title. Whether it's a Pod::Perldoc::ToTerm or a terminal database bug I don't know.

There were numerous bug reports to Pod-Perldoc CPAN distribution, e.g.:

https://rt.cpan.org/Public/Bug/Display.html?id=120229
https://rt.cpan.org/Public/Bug/Display.html?id=88204

and that lead to Perl bug:

https://rt.perl.org/Public/Bug/Display.html?id=131762

that was resolved by patching Pod::Perldoc to use plain text output without ANSI formatting (i.e. Pod::Perldoc::ToText instead of Pod::Perldoc::ToTerm).

I'm keen to apply the Perl patch to Fedora <= 28. It will disappear the bold highlighting but it makes the text legible on all terminals.

Comment 2 Fedora Update System 2018-08-10 11:54:31 UTC
perl-Pod-Perldoc-3.28.01-1.fc28 has been submitted as an update to Fedora 28. https://bodhi.fedoraproject.org/updates/FEDORA-2018-9d12bea0f8

Comment 3 Fedora Update System 2018-08-11 19:38:28 UTC
perl-Pod-Perldoc-3.28.01-1.fc28 has been pushed to the Fedora 28 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2018-9d12bea0f8

Comment 4 Fedora Update System 2018-08-22 11:36:56 UTC
perl-Pod-Perldoc-3.28.01-1.fc28 has been pushed to the Fedora 28 stable repository. If problems still persist, please make note of it in this bug report.

Comment 5 Ben Cotton 2019-05-02 21:02:49 UTC
This message is a reminder that Fedora 28 is nearing its end of life.
On 2019-May-28 Fedora will stop maintaining and issuing updates for
Fedora 28. It is Fedora's policy to close all bug reports from releases
that are no longer maintained. At that time this bug will be closed as
EOL if it remains open with a Fedora 'version' of '28'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora 28 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora, you are encouraged  change the 'version' to a later Fedora 
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.