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) and tcpdump(8) use Aq to format program I/O examples. None of these instances use mathematical unicode symbols in practice. - sysctl(8) mentions header files and tries to format them like C #includes. In the context of this command line utility, you wouldn't be including them, but the formatting close enough that I think .In was intended. - mk.conf(5) mentions the behaviour when including bsd.own.mk. It's not a C header, but again it has similar formatting so it changed to .In. [1] http://marc.info/?l=openbsd-tech&m=142399113828201&w=2 -- Christian Index: libexec/spamd-setup/spamd-setup.8 =================================================================== RCS file: /cvs/src/libexec/spamd-setup/spamd-setup.8,v retrieving revision 1.20 diff -u -p -r1.20 spamd-setup.8 --- libexec/spamd-setup/spamd-setup.8 15 Sep 2013 20:02:33 -0000 1.20 +++ libexec/spamd-setup/spamd-setup.8 28 Mar 2016 01:55:19 -0000 @@ -46,9 +46,17 @@ is run in blacklist only mode, it also sends blacklist data to the .Xr pf 4 table -.Aq Ar spamd . +.Sm off +< +.Ar spamd +>. +.Sm on The -.Aq Ar spamd +.Sm off +< +.Ar spamd +> +.Sm on table must then be used in conjunction with a .Xr pf 4 redirection rule to selectively redirect mail connections Index: sbin/sysctl/sysctl.8 =================================================================== RCS file: /cvs/src/sbin/sysctl/sysctl.8,v retrieving revision 1.192 diff -u -p -r1.192 sysctl.8 --- sbin/sysctl/sysctl.8 3 Mar 2016 12:41:30 -0000 1.192 +++ sbin/sysctl/sysctl.8 28 Mar 2016 01:55:20 -0000 @@ -425,45 +425,45 @@ Use of the flag lists all the filesystems compiled into the running kernel. .Sh FILES .Bl -tag -width <uvm/uvm_swap_encrypt.h> -compact -.It Aq Pa sys/sysctl.h +.It In sys/sysctl.h definitions for top level identifiers and second level kernel and hardware identifiers -.It Aq Pa dev/rndvar.h +.It In dev/rndvar.h definitions for .Xr random 4 device's statistics structure -.It Aq Pa sys/socket.h +.It In sys/socket.h definitions for second level network identifiers -.It Aq Pa sys/gmon.h +.It In sys/gmon.h definitions for third level profiling identifiers -.It Aq Pa uvm/uvm_param.h +.It In uvm/uvm_param.h definitions for second level virtual memory identifiers -.It Aq Pa uvm/uvm_swap_encrypt.h +.It In uvm/uvm_swap_encrypt.h definitions for third level virtual memory identifiers -.It Aq Pa netinet/in.h +.It In netinet/in.h definitions for third level IPv4/v6 identifiers and fourth level IPv4/v6 identifiers -.It Aq Pa netinet/ip_divert.h +.It In netinet/ip_divert.h definitions for fourth level divert identifiers -.It Aq Pa netinet/icmp_var.h +.It In netinet/icmp_var.h definitions for fourth level ICMP identifiers -.It Aq Pa netinet6/icmp6.h +.It In netinet6/icmp6.h definitions for fourth level ICMPv6 identifiers -.It Aq Pa netinet/tcp_var.h +.It In netinet/tcp_var.h definitions for fourth level TCP identifiers -.It Aq Pa netinet/udp_var.h +.It In netinet/udp_var.h definitions for fourth level UDP identifiers -.It Aq Pa ddb/db_var.h +.It In ddb/db_var.h definitions for second level ddb identifiers -.It Aq Pa sys/mount.h +.It In sys/mount.h definitions for second level vfs identifiers -.It Aq Pa nfs/nfs.h +.It In nfs/nfs.h definitions for third level NFS identifiers -.It Aq Pa miscfs/fuse/fusefs.h +.It In miscfs/fuse/fusefs.h definitions for third level fusefs identifiers -.It Aq Pa ufs/ffs/ffs_extern.h +.It In ufs/ffs/ffs_extern.h definitions for third level FFS identifiers -.It Aq Pa machine/cpu.h +.It In machine/cpu.h definitions for second level CPU identifiers .El .Sh EXAMPLES Index: share/man/man5/mk.conf.5 =================================================================== RCS file: /cvs/src/share/man/man5/mk.conf.5,v retrieving revision 1.30 diff -u -p -r1.30 mk.conf.5 --- share/man/man5/mk.conf.5 26 Oct 2015 10:43:42 -0000 1.30 +++ share/man/man5/mk.conf.5 28 Mar 2016 01:55:20 -0000 @@ -34,7 +34,7 @@ .Fd .include <bsd.own.mk> .Sh DESCRIPTION To get system-specific configuration parameters, -.Aq bsd.own.mk +.In bsd.own.mk will try to include the file specified by the .Ev MAKECONF variable. @@ -50,7 +50,7 @@ and details of the format of make files, see .Xr make 1 . .Pp -.Aq bsd.own.mk +.In bsd.own.mk is generally useful when building Makefiles, so that they use the same default owners, etc. as the rest of the tree. These files may define any of the variables described below. @@ -61,7 +61,7 @@ for a list of variables that can be set subsystem. .Sh VARIABLES The following variables are set by -.Aq bsd.own.mk , +.In bsd.own.mk , if they are not already defined. Defaults are in brackets. .Bl -tag -width INSTALL_STRIP @@ -156,10 +156,10 @@ The real path to the X Window System sou .El .Sh ADDITIONAL VARIABLES Additionally, the following variables may be set by -.Aq bsd.own.mk +.In bsd.own.mk or in a make configuration file to modify the behaviour of the system build process (default values are in brackets along with comments, if set by -.Aq bsd.own.mk ) : +.In bsd.own.mk ) : .Bl -tag -width GLOBAL_AUTOCONF_CACHE .It Ev DEBUG Add Index: usr.sbin/syslogd/syslogd.8 =================================================================== RCS file: /cvs/src/usr.sbin/syslogd/syslogd.8,v retrieving revision 1.39 diff -u -p -r1.39 syslogd.8 --- usr.sbin/syslogd/syslogd.8 9 Oct 2015 16:58:25 -0000 1.39 +++ usr.sbin/syslogd/syslogd.8 28 Mar 2016 01:55:21 -0000 @@ -204,7 +204,7 @@ The message sent to should consist of a single line. The message can contain a priority code, which should be a preceding decimal number in angle braces, for example, -.Dq Aq 5 . +.Dq <5> . This priority code should map into the priorities defined in the include file .In sys/syslog.h . Index: usr.sbin/tcpdump/tcpdump.8 =================================================================== RCS file: /cvs/src/usr.sbin/tcpdump/tcpdump.8,v retrieving revision 1.88 diff -u -p -r1.88 tcpdump.8 --- usr.sbin/tcpdump/tcpdump.8 5 Nov 2015 09:56:21 -0000 1.88 +++ usr.sbin/tcpdump/tcpdump.8 28 Mar 2016 01:55:21 -0000 @@ -1242,7 +1242,7 @@ at the other end of this connection. indicates there is urgent data in the packet. .Ar options are TCP options enclosed in angle brackets e.g., -.Aq mss 1024 . +<mss 1024>. .Pp .Ar src , dst and @@ -1713,7 +1713,7 @@ jssmag.209.133 > helios.132: atp-req* 12 Jssmag.209 initiates transaction ID 12266 with host helios by requesting up to 8 packets .Sm off -.Pq the Dq Aq 0\-7 . +.Pq the Dq <0\-7> . .Sm on The hex number at the end of the line is the value of the .Ar userdata
