Fix various mdoc issues.

Found with:	mandoc -Tlint

34 files changed, 50 insertions, 55 deletions

diff --git a/share/man/man4/aout.4 b/share/man/man4/aout.4
index 8e7b02b..960ae25 100644
--- a/share/man/man4/aout.4
+++ b/share/man/man4/aout.4
@@ -123,7 +123,7 @@ non-executable mappings.
 .Xr execve 2 ,
 .Xr a.out 5 ,
 .Xr elf 5 ,
-.Xr sysctl 8 .
+.Xr sysctl 8
 .Sh HISTORY
 The
 .Xr a.out 5
diff --git a/share/man/man4/ath_ahb.4 b/share/man/man4/ath_ahb.4
index 6688dc2..52aceb7 100644
--- a/share/man/man4/ath_ahb.4
+++ b/share/man/man4/ath_ahb.4
@@ -47,7 +47,7 @@ drivers.
 This is only relevant for embedded System-on-Chip (SoC) devices such as
 the Atheros AR913x series, which include an Atheros wireless MAC on-die.
 .Sh SEE ALSO
-.Xr ath 4
+.Xr ath 4 ,
 .Xr ath_hal 4
 .Sh HISTORY
 The
diff --git a/share/man/man4/ath_pci.4 b/share/man/man4/ath_pci.4
index 814e535..0cc36d7 100644
--- a/share/man/man4/ath_pci.4
+++ b/share/man/man4/ath_pci.4
@@ -44,7 +44,7 @@ and
 .Xr ath_hal 4
 drivers.
 .Sh SEE ALSO
-.Xr ath 4
+.Xr ath 4 ,
 .Xr ath_hal 4
 .Sh HISTORY
 The
diff --git a/share/man/man4/carp.4 b/share/man/man4/carp.4
index ca52ba2..5633598 100644
--- a/share/man/man4/carp.4
+++ b/share/man/man4/carp.4
@@ -306,7 +306,7 @@ tcpdump -npi vlan0 -T carp
 .Xr rc.conf 5 ,
 .Xr devd.conf 5 ,
 .Xr ifconfig 8 ,
-.Xr sysctl 8
+.Xr sysctl 8 ,
 .Xr tcpdump 8
 .Sh HISTORY
 The
diff --git a/share/man/man4/crypto.4 b/share/man/man4/crypto.4
index ef35e03..a488d9c 100644
--- a/share/man/man4/crypto.4
+++ b/share/man/man4/crypto.4
@@ -114,7 +114,6 @@ The two modes are described separately below.
 .Sh THEORY OF OPERATION
 Regardless of whether symmetric-key or asymmetric-key operations are
 to be performed, use of the device requires a basic series of steps:
-.Pp
 .Bl -enum
 .It
 Open a file descriptor for the device.
diff --git a/share/man/man4/ip.4 b/share/man/man4/ip.4
index 68b817d..101993f 100644
--- a/share/man/man4/ip.4
+++ b/share/man/man4/ip.4
@@ -857,12 +857,12 @@ field was not equal to the length of the datagram written to the socket.
 .Xr recv 2 ,
 .Xr send 2 ,
 .Xr byteorder 3 ,
+.Xr sourcefilter 3 ,
 .Xr icmp 4 ,
 .Xr igmp 4 ,
 .Xr inet 4 ,
 .Xr intro 4 ,
-.Xr multicast 4 ,
-.Xr sourcefilter 3
+.Xr multicast 4
 .Rs
 .%A D. Thaler
 .%A B. Fenner
diff --git a/share/man/man4/ipheth.4 b/share/man/man4/ipheth.4
index 85801f2..a237524b 100644
--- a/share/man/man4/ipheth.4
+++ b/share/man/man4/ipheth.4
@@ -80,7 +80,7 @@ Apple iPad tethering (all models)
 .Xr netintro 4 ,
 .Xr urndis 4 ,
 .Xr usb 4 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
 .Xr usbconfig 8
 .Sh HISTORY
 The
diff --git a/share/man/man4/iscsi_initiator.4 b/share/man/man4/iscsi_initiator.4
index a391e08..704365c 100644
--- a/share/man/man4/iscsi_initiator.4
+++ b/share/man/man4/iscsi_initiator.4
@@ -112,6 +112,7 @@ for each new session.
 iSCSI RFC 3720
 .\" .Sh HISTORY
 .Sh AUTHORS
-This software was written by Daniel Braniss <danny@cs.huji.ac.il>
+This software was written by
+.An Daniel Braniss Aq Mt danny@cs.huji.ac.il
 .Sh BUGS
 The lun discovery method is old-fashioned.
diff --git a/share/man/man4/isp.4 b/share/man/man4/isp.4
index cf1fa12..6d3a49a 100644
--- a/share/man/man4/isp.4
+++ b/share/man/man4/isp.4
@@ -230,7 +230,9 @@ This is the readonly World Wide Port Name value for this port.
 .Sh AUTHORS
 The
 .Nm
-driver was written by Matthew Jacob originally for NetBSD at
+driver was written by
+.An Matthew Jacob
+originally for NetBSD at
 NASA/Ames Research Center.
 .Sh BUGS
 The driver currently ignores some NVRAM settings.
diff --git a/share/man/man4/ispfw.4 b/share/man/man4/ispfw.4
index 5755501..119b675 100644
--- a/share/man/man4/ispfw.4
+++ b/share/man/man4/ispfw.4
@@ -56,4 +56,5 @@ This will kick the f/w into getting unstuck.
 .Sh SEE ALSO
 .Xr isp 4
 .Sh AUTHORS
-This driver was written by Matthew Jacob.
+This driver was written by
+.An Matthew Jacob .
diff --git a/share/man/man4/iwi.4 b/share/man/man4/iwi.4
index 683f496..911e54c 100644
--- a/share/man/man4/iwi.4
+++ b/share/man/man4/iwi.4
@@ -152,7 +152,7 @@ This should not happen.
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
 .Xr ifconfig 8 ,
-.Xr wpa_supplicant 8 .
+.Xr wpa_supplicant 8
 .Sh AUTHORS
 The original
 .Nm
diff --git a/share/man/man4/multicast.4 b/share/man/man4/multicast.4
index 81d6c77..2a22e57 100644
--- a/share/man/man4/multicast.4
+++ b/share/man/man4/multicast.4
@@ -945,16 +945,16 @@ signal, but the next upcall will be triggered no earlier than
 after the previous upcall.
 .\"
 .Sh SEE ALSO
-.Xr altq 4 ,
-.Xr dummynet 4 ,
 .Xr getsockopt 2 ,
-.Xr gif 4 ,
-.Xr gre 4 ,
 .Xr recvfrom 2 ,
 .Xr recvmsg 2 ,
 .Xr setsockopt 2 ,
 .Xr socket 2 ,
 .Xr sourcefilter 3 ,
+.Xr altq 4 ,
+.Xr dummynet 4 ,
+.Xr gif 4 ,
+.Xr gre 4 ,
 .Xr icmp6 4 ,
 .Xr igmp 4 ,
 .Xr inet 4 ,
diff --git a/share/man/man4/net80211.4 b/share/man/man4/net80211.4
index 3773b98..650bbf4 100644
--- a/share/man/man4/net80211.4
+++ b/share/man/man4/net80211.4
@@ -1313,6 +1313,6 @@ Set whether or not Wi-FI Protected Setup (WPS) is enabled using the value in
 .Xr wlan 4 ,
 .Xr wlan_acl 4 ,
 .Xr wlan_xauth 4 ,
-.Xr ifconfig 8 ,
 .Xr hostapd 8 ,
-.Xr wpa_supplicant 8 .
+.Xr ifconfig 8 ,
+.Xr wpa_supplicant 8
diff --git a/share/man/man4/netmap.4 b/share/man/man4/netmap.4
index 9d98561..595deb3 100644
--- a/share/man/man4/netmap.4
+++ b/share/man/man4/netmap.4
@@ -104,7 +104,6 @@ various aspects of the
 and
 .Nm VALE
 architecture, features and usage.
-.Pp
 .Sh ARCHITECTURE
 .Nm
 supports raw packet I/O through a
@@ -141,7 +140,6 @@ and
 ports
 by default use separate memory regions,
 but can be independently configured to share memory.
-.Pp
 .Sh ENTERING AND EXITING NETMAP MODE
 The following section describes the system calls to create
 and control
@@ -210,7 +208,6 @@ A
 on the file descriptor removes the binding,
 and returns the NIC to normal mode (reconnecting the data path
 to the host stack), or destroys the virtual port.
-.Pp
 .Sh DATA STRUCTURES
 The data structures in the mmapped memory region are detailed in
 .Xr sys/net/netmap.h ,
@@ -403,7 +400,6 @@ A transmit ring with pending transmissions has
 The function
 .Va int nm_tx_pending(ring)
 implements this test.
-.Pp
 .Ss RECEIVE RINGS
 On receive rings, after a
 .Nm
@@ -447,7 +443,6 @@ Below is an example of the evolution of an RX ring:
                  v  v           v
      RX  [.......hhhRRRRRRRRRRRR....]
 .Ed
-.Pp
 .Sh SLOTS AND PACKET BUFFERS
 Normally, packets should be stored in the netmap-allocated buffers
 assigned to slots when ports are bound to a file descriptor.
@@ -749,7 +744,6 @@ of the packet is successful, or 0 on error;
 similar to pcap_dispatch(), applies a callback to incoming packets
 .It Va u_char * nm_nextpkt(struct nm_desc *d, struct nm_pkthdr *hdr)
 similar to pcap_next(), fetches the next packet
-.Pp
 .El
 .Sh SUPPORTED DEVICES
 .Nm
@@ -1037,10 +1031,8 @@ Other
 .Nm
 clients attached to the same switch can now communicate
 with the network card or the host.
-.Pp
 .Sh SEE ALSO
-.Pp
-http://info.iet.unipi.it/~luigi/netmap/
+.Pa http://info.iet.unipi.it/~luigi/netmap/
 .Pp
 Luigi Rizzo, Revisiting network I/O APIs: the netmap framework,
 Communications of the ACM, 55 (3), pp.45-51, March 2012
diff --git a/share/man/man4/nfe.4 b/share/man/man4/nfe.4
index 2934211..b9f91a2 100644
--- a/share/man/man4/nfe.4
+++ b/share/man/man4/nfe.4
@@ -175,8 +175,8 @@ before a change takes effect.
 .Xr pci 4 ,
 .Xr polling 4 ,
 .Xr rgephy 4 ,
-.Xr sysctl 8 ,
-.Xr ifconfig 8
+.Xr ifconfig 8 ,
+.Xr sysctl 8
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/ng_ether_echo.4 b/share/man/man4/ng_ether_echo.4
index e86c3a9..a62c553 100644
--- a/share/man/man4/ng_ether_echo.4
+++ b/share/man/man4/ng_ether_echo.4
@@ -64,9 +64,9 @@ This node shuts down upon receipt of a
 control message, or when all hooks have been disconnected.
 .Sh SEE ALSO
 .Xr netgraph 4 ,
-.Xr ng_hole 4 ,
 .Xr ng_echo 4 ,
 .Xr ng_ether 4 ,
+.Xr ng_hole 4 ,
 .Xr ngctl 8
 .Sh HISTORY
 The
diff --git a/share/man/man4/ng_netflow.4 b/share/man/man4/ng_netflow.4
index fb7e1fa..889c88a 100644
--- a/share/man/man4/ng_netflow.4
+++ b/share/man/man4/ng_netflow.4
@@ -315,8 +315,8 @@ we do not use tee, but send packets back to either node.
 SEQ
 .Ed
 .Sh SEE ALSO
-.Xr netgraph 4 ,
 .Xr setfib 2 ,
+.Xr netgraph 4 ,
 .Xr ng_ether 4 ,
 .Xr ng_iface 4 ,
 .Xr ng_ksocket 4 ,
diff --git a/share/man/man4/nvram2env.4 b/share/man/man4/nvram2env.4
index b9b0311..3678160 100644
--- a/share/man/man4/nvram2env.4
+++ b/share/man/man4/nvram2env.4
@@ -107,7 +107,7 @@ hint.nvram.1.base=0x1cff8000
 .Ed
 .Sh SEE ALSO
 .Xr kenv 1 ,
-.Xr kenv 2 .
+.Xr kenv 2
 .Sh HISTORY
 .Nm
 first appeared in
diff --git a/share/man/man4/pass.4 b/share/man/man4/pass.4
index 7280de1..6b4fb1e 100644
--- a/share/man/man4/pass.4
+++ b/share/man/man4/pass.4
@@ -104,8 +104,8 @@ CAM subsystem.
 None.
 .Sh SEE ALSO
 .Xr cam 3 ,
-.Xr cam 4 ,
 .Xr cam_cdbparse 3 ,
+.Xr cam 4 ,
 .Xr xpt 4 ,
 .Xr camcontrol 8
 .Sh HISTORY
diff --git a/share/man/man4/pccbb.4 b/share/man/man4/pccbb.4
index d8d955e..6018bec 100644
--- a/share/man/man4/pccbb.4
+++ b/share/man/man4/pccbb.4
@@ -179,5 +179,5 @@ debugging problems with the bridge chipset.
 .El
 .Sh SEE ALSO
 .Xr cardbus 4 ,
-.Xr pccard 4 ,
-.Xr exca 4
+.Xr exca 4 ,
+.Xr pccard 4
diff --git a/share/man/man4/pflog.4 b/share/man/man4/pflog.4
index c1039a3..803f1fd 100644
--- a/share/man/man4/pflog.4
+++ b/share/man/man4/pflog.4
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 31 2007
+.Dd May 31, 2007
 .Dt PFLOG 4
 .Os
 .Sh NAME
diff --git a/share/man/man4/pfsync.4 b/share/man/man4/pfsync.4
index b00bf9d..0529b71 100644
--- a/share/man/man4/pfsync.4
+++ b/share/man/man4/pfsync.4
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 20 2011
+.Dd December 20, 2011
 .Dt PFSYNC 4
 .Os
 .Sh NAME
diff --git a/share/man/man4/pts.4 b/share/man/man4/pts.4
index e9aaaaa..c142c50 100644
--- a/share/man/man4/pts.4
+++ b/share/man/man4/pts.4
@@ -142,8 +142,8 @@ Pseudo-terminal slave devices.
 .Sh DIAGNOSTICS
 None.
 .Sh SEE ALSO
-.Xr grantpt 3 ,
 .Xr posix_openpt 2 ,
+.Xr grantpt 3 ,
 .Xr ptsname 3 ,
 .Xr pty 4 ,
 .Xr tty 4
diff --git a/share/man/man4/sa.4 b/share/man/man4/sa.4
index aa72f68..f5984aa 100644
--- a/share/man/man4/sa.4
+++ b/share/man/man4/sa.4
@@ -264,8 +264,8 @@ accessing the device, e.g.).
 .Sh DIAGNOSTICS
 None.
 .Sh SEE ALSO
-.Xr cam 4 ,
-.Xr mt 1
+.Xr mt 1 ,
+.Xr cam 4
 .Sh AUTHORS
 .An -nosplit
 The
diff --git a/share/man/man4/send.4 b/share/man/man4/send.4
index 4af510a..e69e6e3 100644
--- a/share/man/man4/send.4
+++ b/share/man/man4/send.4
@@ -196,9 +196,9 @@ Occurs if interface output routines fail to send the packet out of the
 interface.
 .El
 .Sh SEE ALSO
-.Xr recvfrom 2
-.Xr sendto 2
-.Xr socket 2
+.Xr recvfrom 2 ,
+.Xr sendto 2 ,
+.Xr socket 2 ,
 .Xr loader.conf 5
 .Sh HISTORY
 The
diff --git a/share/man/man4/sfxge.4 b/share/man/man4/sfxge.4
index 7930fcf..e6fe6a4 100644
--- a/share/man/man4/sfxge.4
+++ b/share/man/man4/sfxge.4
@@ -114,11 +114,11 @@ For general information and support,
 go to the Solarflare support website at:
 .Pa https://support.solarflare.com .
 .Sh SEE ALSO
+.Xr cpuset 1 ,
 .Xr arp 4 ,
 .Xr netintro 4 ,
 .Xr ng_ether 4 ,
 .Xr vlan 4 ,
-.Xr cpuset 1 ,
 .Xr ifconfig 8
 .Sh AUTHORS
 The
diff --git a/share/man/man4/snd_hda.4 b/share/man/man4/snd_hda.4
index cdb2a62..40a8862 100644
--- a/share/man/man4/snd_hda.4
+++ b/share/man/man4/snd_hda.4
@@ -590,8 +590,8 @@ driver supports more than two hundred different controllers and CODECs.
 There is no sense to list all of them here, as in most cases specific CODEC
 configuration and wiring are more important then type of the CODEC itself.
 .Sh SEE ALSO
-.Xr sound 4 ,
 .Xr snd_ich 4 ,
+.Xr sound 4 ,
 .Xr device.hints 5 ,
 .Xr loader.conf 5 ,
 .Xr sysctl 8
diff --git a/share/man/man4/snd_ich.4 b/share/man/man4/snd_ich.4
index 528d28c..b03a0fd 100644
--- a/share/man/man4/snd_ich.4
+++ b/share/man/man4/snd_ich.4
@@ -99,8 +99,8 @@ NVIDIA nForce4
 SiS 7012
 .El
 .Sh SEE ALSO
-.Xr sound 4 ,
-.Xr snd_hda 4
+.Xr snd_hda 4 ,
+.Xr sound 4
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/ural.4 b/share/man/man4/ural.4
index 1563fde..4b412f5 100644
--- a/share/man/man4/ural.4
+++ b/share/man/man4/ural.4
@@ -142,9 +142,9 @@ This should not happen.
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
 .Xr wlan_xauth 4 ,
-.Xr ifconfig 8 ,
 .Xr hostapd 8 ,
-.Xr wpa_supplicant 8 .
+.Xr ifconfig 8 ,
+.Xr wpa_supplicant 8
 .Rs
 .%T "Ralink Technology"
 .%U http://www.ralinktech.com/
diff --git a/share/man/man4/usfs.4 b/share/man/man4/usfs.4
index 215d31e..a72a8d8 100644
--- a/share/man/man4/usfs.4
+++ b/share/man/man4/usfs.4
@@ -54,7 +54,7 @@ the USB stack is activated in USB device side mode.
 .Pp
 Upon attach the driver creates a RAM disk which can be read and written.
 .Sh SEE ALSO
-.Xr umass 4
+.Xr umass 4 ,
 .Xr usb 4
 .Sh HISTORY
 The
diff --git a/share/man/man4/virtio_console.4 b/share/man/man4/virtio_console.4
index b855f13..542c845 100644
--- a/share/man/man4/virtio_console.4
+++ b/share/man/man4/virtio_console.4
@@ -58,7 +58,7 @@ each port is accessible through
 .It Pa /dev/ttyV?.??
 .El
 .Sh SEE ALSO
-.Xr tty 4
+.Xr tty 4 ,
 .Xr virtio 4
 .Sh HISTORY
 The
diff --git a/share/man/man4/virtio_random.4 b/share/man/man4/virtio_random.4
index 5ce7d17..d44b08d 100644
--- a/share/man/man4/virtio_random.4
+++ b/share/man/man4/virtio_random.4
@@ -52,7 +52,7 @@ device driver provides support for VirtIO entropy devices.
 The entropy device supplies high-quality randomness from the
 hypervisor to the guest.
 .Sh SEE ALSO
-.Xr random 4
+.Xr random 4 ,
 .Xr virtio 4
 .Sh HISTORY
 The
diff --git a/share/man/man4/vxlan.4 b/share/man/man4/vxlan.4
index ec95db1..167d5b0 100644
--- a/share/man/man4/vxlan.4
+++ b/share/man/man4/vxlan.4
@@ -215,9 +215,9 @@ Once created, the
 interface can be configured with
 .Xr ifconfig 8 .
 .Sh SEE ALSO
-.Xr ifconfig 8 ,
 .Xr inet 4 ,
-.Xr inet 6 ,
+.Xr inet6 4 ,
+.Xr ifconfig 8 ,
 .Xr sysctl 8 ,
 .Xr vlan 8
 .Rs
diff --git a/share/man/man4/wpi.4 b/share/man/man4/wpi.4
index f2d4251..4cf33c4 100644
--- a/share/man/man4/wpi.4
+++ b/share/man/man4/wpi.4
@@ -117,12 +117,12 @@ The hardware switch controlling the radio is currently turned off.
 Data transmission is not possible in this state.
 .El
 .Sh SEE ALSO
-.Xr wpifw 4 ,
 .Xr pci 4 ,
 .Xr wlan 4 ,
 .Xr wlan_ccmp 4 ,
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
+.Xr wpifw 4 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
 .Sh AUTHORS