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
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)
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..
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
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
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
"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
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
"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
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
10 matches
Mail list logo