Bug 1003471 - Manual pages generated from POD have almost all Unicode characters mangled to X
Summary: Manual pages generated from POD have almost all Unicode characters mangled to X
Alias: None
Product: Fedora
Classification: Fedora
Component: perl-podlators
Version: 22
Hardware: Unspecified
OS: Unspecified
Target Milestone: ---
Assignee: Petr Pisar
QA Contact: Fedora Extras Quality Assurance
URL: https://rt.cpan.org/Public/Bug/Displa...
Depends On:
TreeView+ depends on / blocked
Reported: 2013-09-02 06:59 UTC by Petr Pisar
Modified: 2016-07-19 10:20 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Last Closed: 2016-07-19 10:20:38 UTC
Type: Bug

Attachments (Terms of Use)

System ID Priority Status Summary Last Updated
CPAN 68741 None None None Never
CPAN 73804 None None None Never
Debian BTS 480997 None None None Never

Description Petr Pisar 2013-09-02 06:59:39 UTC
$ cat test 
=encoding utf8

=head1 Kroužkovci


$ pod2man test |tail
.IX Title "TEST 1"
.TH TEST 1 "2013-09-02" "perl v5.18.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.SH "KrouXkovci"
.IX Header "KrouXkovci"

This is caused by upstream decision to have pod2man output compatible with all ROFFs. That means to pass ASCII charachtes, escape ISO-8859-1 characters, and to replace others with plain `X' (<https://rt.cpan.org/Public/Bug/Display.html?id=68741>).

There is pod2man option --utf8 which disables any escaping and outputs UTF-8, but this is not default behaviour. This makes all manual pages from built packages to be mangled. See Debian bug report <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=480997>.

Question is what to do. Should we be faster than upstream and make UTF-8 output default? Should defaults you locale encoding? (Fedora packages are built in C locale.)

Comment 1 Jaroslav Reznik 2015-03-03 15:02:04 UTC
This bug appears to have been reported against 'rawhide' during the Fedora 22 development cycle.
Changing version to '22'.

More information and reason for this action is here:

Comment 2 Fedora End Of Life 2016-07-19 10:20:38 UTC
Fedora 22 changed to end-of-life (EOL) status on 2016-07-19. Fedora 22 is
no longer maintained, which means that it will not receive any further
security or bug fix updates. As a result we are closing this bug.

If you can reproduce this bug against a currently maintained version of
Fedora please feel free to reopen this bug against that version. If you
are unable to reopen this bug, please file a new report against the
current release. If you experience problems, please add a comment to this

Thank you for reporting this bug and we are sorry it could not be fixed.

Note You need to log in before you can comment on or make changes to this bug.