Re: Aq macro replacements

2016-03-31 Thread Ingo Schwarze
Hi Christian, Christian Heckendorf wrote on Sun, Mar 27, 2016 at 11:03:02PM -0400: > - spamd-setup(8) is referring to pf tables. syslogd(8) and tcpdump(8) >use Aq to format program I/O examples. None of these instances use >mathematical unicode symbols in practice. Fixed differently. I

Aq macro replacements

2016-03-27 Thread Christian Heckendorf
Hi, There was some discussion last year[1] regarding abuse of Aq macros in mdoc where plain characters or other macros (eg, "In") would be more appropriate. Here are some additional places where I believe replacing Aq would make sense. Notes: - spamd-setup(8) is referring to pf tables. syslogd(8)

Re: Aq macro

2015-02-15 Thread Ingo Schwarze
Hi Anthony, Anthony J. Bentley wrote on Sun, Feb 15, 2015 at 03:19:48AM -0700: > More importantly, though, it matches groff. Yes. We shouldn't change mandoc(1) without changing groff(1) in parallel. > Here is a patch that corrects spamd(8). I can look at pages that > use it for headers later..

Re: Aq macro

2015-02-15 Thread Ingo Schwarze
Hi Anthony, Anthony J. Bentley wrote on Sun, Feb 15, 2015 at 06:16:11AM -0700: > "Anthony J. Bentley" writes: >> "Ted Unangst" writes: >>> spamd(8) quotes the pf table name. That's in normal text, so it doesn't really matter, nobody is going to copy and paste a single word out of the middle of

Re: Aq macro

2015-02-15 Thread Ingo Schwarze
headers are not math equations either. > I think these manuals should use actual < > instead of the Aq macro. pf.conf(5) should use plain <> for tables. should always use .In. > There are related problems in some man pages like pf.conf(5) where > >= is turned into a f

Re: Aq macro

2015-02-15 Thread Christian Weisgerber
On 2015-02-15, "Ted Unangst" wrote: > mandoc already special cases Aq in Mt macros to output plain . > Existing usage suggests that's what people want elsewhere as well. pf > and headers are not math equations either. I think these manuals should use actual < > i

Re: Aq macro

2015-02-15 Thread Anthony J. Bentley
"Anthony J. Bentley" writes: > "Ted Unangst" writes: > > spamd(8) quotes the > > pf table name. compress(3) quotes the path. > > IMO, these are bugs in the manuals. spamd(8) should be using <> directly. > compress(3) should drop the angle quotes and just use Pa. Or wrap Pa in > <> if people real

Re: Aq macro

2015-02-15 Thread Ted Unangst
Anthony J. Bentley wrote: > "Ted Unangst" writes: > > The mandoc chars.in though says that for unicode, it should output these > > fanc > > y > > "mathematical left angle bracket" and "mathematical right angle bracket" > > characters. Two problems. First, they look like kind of silly because most

Re: Aq macro

2015-02-15 Thread Anthony J. Bentley
"Ted Unangst" writes: > spamd(8) quotes the > pf table name. compress(3) quotes the path. IMO, these are bugs in the manuals. spamd(8) should be using <> directly. compress(3) should drop the angle quotes and just use Pa. Or wrap Pa in <> if people really think it's needed. > The mandoc chars.i

Aq macro

2015-02-15 Thread Ted Unangst
The .Aq macro quotes a word with surrounding brackets. This is used a few places. Lots of man pages quote email addresses. spamd(8) quotes the pf table name. compress(3) quotes the path. The mandoc chars.in though says that for unicode, it should output these fancy "mathematical left