Bug 797005

Summary: using a quotation mark in .SS breaks the format
Product: [Fedora] Fedora Reporter: Akira TAGOH <tagoh>
Component: groffAssignee: Jan Vcelak <jvcelak>
Status: CLOSED NOTABUG QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 16CC: jvcelak, tsmetana
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-05-30 07:02:39 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:
Attachments:
Description Flags
minimal groff code to reproduce none

Description Akira TAGOH 2012-02-24 02:27:50 UTC
Description of problem:
groff wrongly formats .SS containing a quotation mark.

Version-Release number of selected component (if applicable):
groff-1.21-3.fc16.x86_64

How reproducible:
always

Steps to Reproduce:
1.man ./attached
2.
3.
  
Actual results:
   foo
   foo
   foo""

Expected results:
   foo
   foo
   "foo"

Additional info:

Comment 1 Akira TAGOH 2012-02-24 02:37:05 UTC
FWIW .SS \&"foo\&" becomes "foo". quoting strings containing a quotation mark seems introducing this issue.

Comment 2 Jan Vcelak 2012-05-29 09:31:55 UTC
> Steps to Reproduce:
> 1.man ./attached

Akira, please, can you attach the input file?

Comment 3 Akira TAGOH 2012-05-29 10:00:30 UTC
Created attachment 587372 [details]
minimal groff code to reproduce

Doh! sorry for that.

BTW I realized this issue on fonts-conf.5 from fontconfig. the attached file is the minimal requirements to reproduce this issue.

Comment 4 Jan Vcelak 2012-05-29 16:23:26 UTC
Akira, I believe this is not a bug.

\& is a zero-width character, its intended use is to stop interaction of a character with its surrounding [1]. It does not escape anything.

If you want to use double quotes in macro arguments, you should use either double quote glyph \(dq or double the double quote character [2]. Both solutions work:

.SS """foo"""
.SS "\(dqfoo\(dq"

Do you agree?

Usage of zero-width-character in font-config man page is IMHO wrong. The manpage is autogenerated using docbook, so I think this is a bug in docbook2man.

[1] http://www.gnu.org/software/groff/manual/html_node/Ligatures-and-Kerning.html
[2] http://www.gnu.org/software/groff/manual/html_node/Request-and-Macro-Arguments.html

Comment 6 Akira TAGOH 2012-05-30 05:02:42 UTC
Aha. thanks for the explanation. please feel free to close this then.