Bug 821632

Summary: perldoc man page is broken, shows "B<perldoc> [B<-h>] [B<-D>]" etc
Product: [Fedora] Fedora Reporter: Richard W.M. Jones <rjones>
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: 17CC: mmaslano, perl-devel, ppisar
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: perl-Pod-Perldoc-3.17-2.fc18 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-05-26 07:22:32 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 Richard W.M. Jones 2012-05-15 07:46:51 UTC
Description of problem:

Do 'man perldoc'.  The man page shows raw POD directives:

SYNOPSIS
           B<perldoc> [B<-h>] [B<-D>] [B<-t>] [B<-u>] [B<-m>] [B<-l>] [B<-F>]
               [B<-i>] [B<-V>] [B<-T>] [B<-r>]
               [B<-dI<destination_file>>]
               [B<-oI<formatname>>]
               [B<-MI<FormatterClassName>>]
               [B<-wI<formatteroption:value>>]
               [B<-n>I<nroff-replacement>]
               [B<-X>]
               [B<-L> I<language_code>]
               PageName|ModuleName|ProgramName|URL

       Examples:

           B<perldoc> B<-f> BuiltinFunction

           B<perldoc> B<-L> it B<-f> BuiltinFunction
etc.

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

perl-Pod-Perldoc-3.17-1.fc17.noarch

How reproducible:

100%

Steps to Reproduce:
1. man perldoc

Comment 1 Petr Pisar 2012-05-15 08:29:22 UTC
Some POD formatting sequences are not translated into roff sequences. The synopsis section is affected only.

Comment 2 Petr Pisar 2012-05-15 08:35:21 UTC
F18--17 affected.

Comment 3 Petr Pisar 2012-05-15 08:54:43 UTC
This is bug in perldoc.pod source:


=head1 SYNOPSIS

    B<perldoc> [B<-h>] [B<-D>] [B<-t>] [B<-u>] [B<-m>] [B<-l>] [B<-F>]


Here the `B<perldoc>...' text is preceded with a literal space which denotes the paragraph a verbatim paragraph where none POD sequences are interpreted.

Comment 4 Petr Pisar 2012-05-15 11:00:43 UTC
Fixed as perl-Pod-Perldoc-3.17-2.fc18 in F18.

Comment 5 Fedora Update System 2012-05-15 11:03:04 UTC
perl-Pod-Perldoc-3.17-2.fc17 has been submitted as an update for Fedora 17.
https://admin.fedoraproject.org/updates/perl-Pod-Perldoc-3.17-2.fc17

Comment 6 Richard W.M. Jones 2012-05-15 12:22:08 UTC
(In reply to comment #5)
> perl-Pod-Perldoc-3.17-2.fc17 has been submitted as an update for Fedora 17.
> https://admin.fedoraproject.org/updates/perl-Pod-Perldoc-3.17-2.fc17

I checked this package and it's fixed.  Will +1 it.

Comment 7 Fedora Update System 2012-05-15 16:40:43 UTC
Package perl-Pod-Perldoc-3.17-2.fc17:
* should fix your issue,
* was pushed to the Fedora 17 testing repository,
* should be available at your local mirror within two days.
Update it with:
# su -c 'yum update --enablerepo=updates-testing perl-Pod-Perldoc-3.17-2.fc17'
as soon as you are able to.
Please go to the following url:
https://admin.fedoraproject.org/updates/FEDORA-2012-7869/perl-Pod-Perldoc-3.17-2.fc17
then log in and leave karma (feedback).

Comment 8 Fedora Update System 2012-05-26 07:22:32 UTC
perl-Pod-Perldoc-3.17-2.fc17 has been pushed to the Fedora 17 stable repository.  If problems still persist, please make note of it in this bug report.