From b61c6e4e79f3b0c4d60b49a950d932f396ef3c3b Mon Sep 17 00:00:00 2001 From: brueffer Date: Sun, 21 Dec 2014 09:53:29 +0000 Subject: Fix various mdoc issues. Found with: mandoc -Tlint --- share/man/man4/aout.4 | 2 +- share/man/man4/ath_ahb.4 | 2 +- share/man/man4/ath_pci.4 | 2 +- share/man/man4/carp.4 | 2 +- share/man/man4/crypto.4 | 1 - share/man/man4/ip.4 | 4 ++-- share/man/man4/ipheth.4 | 2 +- share/man/man4/iscsi_initiator.4 | 3 ++- share/man/man4/isp.4 | 4 +++- share/man/man4/ispfw.4 | 3 ++- share/man/man4/iwi.4 | 2 +- share/man/man4/multicast.4 | 8 ++++---- share/man/man4/net80211.4 | 4 ++-- share/man/man4/netmap.4 | 10 +--------- share/man/man4/nfe.4 | 4 ++-- share/man/man4/ng_ether_echo.4 | 2 +- share/man/man4/ng_netflow.4 | 2 +- share/man/man4/nvram2env.4 | 2 +- share/man/man4/pass.4 | 2 +- share/man/man4/pccbb.4 | 4 ++-- share/man/man4/pflog.4 | 2 +- share/man/man4/pfsync.4 | 2 +- share/man/man4/pts.4 | 2 +- share/man/man4/sa.4 | 4 ++-- share/man/man4/send.4 | 6 +++--- share/man/man4/sfxge.4 | 2 +- share/man/man4/snd_hda.4 | 2 +- share/man/man4/snd_ich.4 | 4 ++-- share/man/man4/ural.4 | 4 ++-- share/man/man4/usfs.4 | 2 +- share/man/man4/virtio_console.4 | 2 +- share/man/man4/virtio_random.4 | 2 +- share/man/man4/vxlan.4 | 4 ++-- share/man/man4/wpi.4 | 2 +- 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 +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 -- cgit v1.1