Bug 237188 - security/openssh-portable: mdoc2man.awk mangles .Qq in man pages
Summary: security/openssh-portable: mdoc2man.awk mangles .Qq in man pages
Status: New
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Bryan Drewery
Keywords: patch
Depends on:
Reported: 2019-04-11 01:19 UTC by Craig Leres
Modified: 2019-04-11 01:20 UTC (History)
0 users

See Also:
bugzilla: maintainer-feedback? (bdrewery)

patch (1.16 KB, text/plain)
2019-04-11 01:20 UTC, Craig Leres
leres: maintainer-approval?

Note You need to log in before you can comment on or make changes to this bug.
Description Craig Leres freebsd_committer 2019-04-11 01:19:43 UTC
I noticed the string "Qq" appearing in the ssh_config(5) man page, for example:

              For example, Qq *.a.example.com:*.b.example.com,*.c.example.com
              will allow hostnames matching Qq *.a.example.com to be
              canonicalized to names in the Qq *.b.example.com or Qq
              *.c.example.com domains.

The first thing I noticed is that the distribution version of ssh_config.5 renders correctly without any massaging, e.g. "man ./ssh_config.5" shows:

             For example, "*.a.example.com:*.b.example.com,*.c.example.com"
             will allow hostnames matching "*.a.example.com" to be
             canonicalized to names in the "*.b.example.com" or
             "*.c.example.com" domains.

So one solution would be to remove the use of mdoc2man.awk from the Makefile.

Meanwhile mdoc(7) says this about .Qq:

     Qq, Qo, Qc       enclose in typewriter double quotes: "text"

So here's a patch that adds .Qq support to mdoc2man.awk.
Comment 1 Craig Leres freebsd_committer 2019-04-11 01:20:24 UTC
Created attachment 203572 [details]