Bug 433243

Summary: wrong encoding of backticks -> can't search for `
Product: [Fedora] Fedora Reporter: Mikel Ward <mikel>
Component: perlAssignee: Marcela Mašláňová <mmaslano>
Status: CLOSED NEXTRELEASE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: low Docs Contact:
Priority: low    
Version: 8CC: kasal, rc040203, tcallawa
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
URL: http://heirloom.sourceforge.net/doctools/troff.pdf
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2008-02-22 09:53:22 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Mikel Ward 2008-02-18 00:15:55 UTC
The perlop man page documents the `` (backtick) operator.

When I view this in man, the characters are converted to left single quotes.

Apparently this is the way man pages work (see the URL, plus the groff(7) and
groff_char(7) man pages).

The fix is to replace the ` with \` when it means a ` character.

Comment 1 Mikel Ward 2008-02-18 01:40:31 UTC
I have reported this to perlbug with the subject "pod2man needs to
translate some ASCII characters".  I don't think I get a bug number or a
confirmation message.

Comment 2 Marcela Mašláňová 2008-02-22 09:53:22 UTC
http://rt.perl.org/rt3/Public/Bug/Display.html?id=1865 fixed in perl-5.10

Comment 3 Mikel Ward 2008-02-23 13:26:28 UTC
The bug you linked to was closed in 1999 and doesn't seem to address the issue I
raised.  Perhaps you supplied the wrong link?

Comment 4 Tom "spot" Callaway 2008-04-22 15:54:54 UTC
When I run man perlop in F-9 (perl 5.10.0), I see `` (not '') in the "Quotes and
Quote-like Operators" section, so it seems like pod2man is actually working
correctly for this.

Please reopen if you are not seeing this in F-9.

Comment 5 Mikel Ward 2008-04-22 21:41:07 UTC
Cool.  It's nearly done.  There's one line near qx that's still not done correctly.  Was this done 
programmatically or manually?

Ideally it should be done properly by perl2man (or Pod::Man).  There might be other occurrences and 
other pages affected.

Comment 6 Tom "spot" Callaway 2008-04-22 21:48:52 UTC
I don't see any mistakes at all. Can you be very specific as to what you're seeing?

As to how it was fixed, whatever base perl uses to convert the pod file into the
manpage is doing it, not Fedora. :)