"Ted Unangst" writes: > spamd(8) quotes the > <spamd> pf table name. compress(3) quotes the <zconf.h> 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.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 > fonts use a different glyph. Well, if it's a matter of aesthetics, I happen to like it. So we're at an impasse! More importantly, though, it matches groff. I don't think it can (or should) change. When this behavior was added to mandoc, several pages using Aq to represent HTML tags were fixed. These pages were just overlooked. > Two, a decent number of fonts don't include them, > and then things look really silly. But to get to that point you have to: - use a UTF-8 locale (not the default); - change the xterm fonts (all the default fonts display these characters) - ...to something that doesn't support that character (lots of fonts do, what makes yours so special?) > mandoc already special cases Aq in Mt macros to output plain <brackets>. This also matches groff. Here is a patch that corrects spamd(8). I can look at pages that use it for headers later... a quick grep reveals less than 20. Index: libexec/spamd/spamd.8 =================================================================== RCS file: /cvs/src/libexec/spamd/spamd.8,v retrieving revision 1.125 diff -u -p -u -p -r1.125 spamd.8 --- libexec/spamd/spamd.8 7 Feb 2015 18:05:57 -0000 1.125 +++ libexec/spamd/spamd.8 15 Feb 2015 10:17:38 -0000 @@ -268,11 +268,11 @@ regularly scans the .Pa /var/db/spamd database and configures all whitelist addresses as the .Xr pf 4 -.Aq spamd-white +<spamd-white> table, allowing connections to pass to the real MTA. Any addresses not found in -.Aq spamd-white +<spamd-white> are redirected to .Nm . .Pp @@ -385,7 +385,7 @@ spamtrap address, it is blacklisted for 24 hours by adding the host to the .Nm blacklist -.Aq spamd-greytrap . +<spamd-greytrap>. Spamtrap addresses are added to the .Pa /var/db/spamd database with the following @@ -468,7 +468,7 @@ a slightly modified .Xr pf.conf 5 ruleset is required, redirecting any addresses found in the -.Aq spamd +<spamd> table to .Nm . Any other addresses @@ -488,7 +488,7 @@ like: .Pp .Xr spamd-setup 8 can also be used to load addresses into the -.Aq spamd +<spamd> table. It has the added benefit of being able to remove addresses from blacklists, and will connect to
