On Thu, Dec 05, 2019 at 03:15:31PM +0100, Ingo Schwarze wrote: > Hi Jason, > > Jason McIntyre wrote on Thu, Dec 05, 2019 at 06:54:28AM -0700: > > > CVSROOT: /cvs > > Module name: src > > Changes by: [email protected] 2019/12/05 06:54:28 > > > > Modified files: > > usr.sbin/smtpd : smtpd.conf.5 > > > > Log message: > > replace "Pf < ... Ns >" with Aq; tidy up lists a little; > > Please revert the .Aq part. > > The mdoc(7) manual page explains why: > > Aq line > Enclose the rest of the input line in angle brackets. The only > important use case is for email addresses. See Mt for an example. > > Occasionally, it is used for names of characters and keys, for > example: > > Press the > .Aq escape > key to ... > > For URIs, use Lk instead, and In for "#include" directives. Never > wrap Ar in Aq. > > Since Aq usually renders with non-ASCII characters in non-ASCII > output modes, do not use it where the ASCII characters '<' and '>' > are required as syntax elements. Instead, use these characters > directly in such cases, combining them with the macros Pf, Ns, or Eo > as needed. > > Yours, > Ingo
i have reverted it, with a heavy heart. jmc
