http://bugzilla.mindrot.org/show_bug.cgi?id=550
Summary: Problems with .Ql in mdoc
Product: Portable OpenSSH
Version: -current
Platform: All
OS/Version: All
Status: NEW
Severity: minor
Priority: P2
Component: Documentation
AssignedTo: openssh-unix-dev at mindrot.org
ReportedBy: cjwatson at debian.org
Punctuation characters need to be escaped in the argument to .Ql, or you end up
with the output containing things like ''! rather than '!'.
Xavier Renaut
reported this in http://bugs.debian.org/191131.
I'll attach a patch in a moment.
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
http://bugzilla.mindrot.org/show_bug.cgi?id=550 ------- Additional Comments From cjwatson at debian.org 2003-04-29 22:29 ------- Created an attachment (id=277) --> (http://bugzilla.mindrot.org/attachment.cgi?id=277&action=view) Fix punctuation in argument to .Ql There's a rationale for why \& is needed in the "Other Possible Pitfalls" section of groff_mdoc(7). ------- You are receiving this mail because: ------- You are the assignee for the bug, or are watching the assignee.
http://bugzilla.mindrot.org/show_bug.cgi?id=550 ------- Additional Comments From mouring at eviladmin.org 2003-04-30 03:42 ------- Have you considered this to be a bug in groff? This is not producable under any of the BSDs. ------- You are receiving this mail because: ------- You are the assignee for the bug, or are watching the assignee.
http://bugzilla.mindrot.org/show_bug.cgi?id=550 ------- Additional Comments From cjwatson at debian.org 2003-04-30 04:02 ------- It's documented as behaving this way for punctuation characters that end sentences, and as far as I know groff's mdoc implementation is maintained to a large extent by the FreeBSD team, so I rather doubt it. However, I've just asked the groff mailing list for an opinion. I also note that the OpenSSH man pages already use the \& construction in a number of other places for exactly the same reason. ------- You are receiving this mail because: ------- You are the assignee for the bug, or are watching the assignee.
http://bugzilla.mindrot.org/show_bug.cgi?id=550 ------- Additional Comments From cjwatson at debian.org 2003-04-30 06:11 ------- Werner Lemberg, the groff maintainer, says: It's not a bug, it's a logical extension. The old BSD mdoc macros are not consequent here for reasons beyond my knowledge: Look at the `z.', `z,', ... registers in old BSD's doc-common and you can see that `z!' and `z?' are missing, while groff's mdoc has `doc-punct!' and `doc-punct?'. IMHO the OpenSSH team should apply your patch even if not necessary for old BSD's mdoc macros. ------- You are receiving this mail because: ------- You are the assignee for the bug, or are watching the assignee.
http://bugzilla.mindrot.org/show_bug.cgi?id=550
mouring at eviladmin.org changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
Resolution| |FIXED
------- Additional Comments From mouring at eviladmin.org 2003-04-30 11:01
-------
Applied upstream along with escaping * while we are here since it is proper, but
does not
affect us (suggested by jmc of OpenBSD).
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.