svn commit: r275990 - head/share/man/man4

Christian Brueffer brueffer at FreeBSD.org
Sun Dec 21 09:53:40 UTC 2014 

Author: brueffer
Date: Sun Dec 21 09:53:29 2014
New Revision: 275990
URL: https://svnweb.freebsd.org/changeset/base/275990

Log:
  Fix various mdoc issues.
  
  Found with:	mandoc -Tlint

Modified:
  head/share/man/man4/aout.4
  head/share/man/man4/ath_ahb.4
  head/share/man/man4/ath_pci.4
  head/share/man/man4/carp.4
  head/share/man/man4/crypto.4
  head/share/man/man4/ip.4
  head/share/man/man4/ipheth.4
  head/share/man/man4/iscsi_initiator.4
  head/share/man/man4/isp.4
  head/share/man/man4/ispfw.4
  head/share/man/man4/iwi.4
  head/share/man/man4/multicast.4
  head/share/man/man4/net80211.4
  head/share/man/man4/netmap.4
  head/share/man/man4/nfe.4
  head/share/man/man4/ng_ether_echo.4
  head/share/man/man4/ng_netflow.4
  head/share/man/man4/nvram2env.4
  head/share/man/man4/pass.4
  head/share/man/man4/pccbb.4
  head/share/man/man4/pflog.4
  head/share/man/man4/pfsync.4
  head/share/man/man4/pts.4
  head/share/man/man4/sa.4
  head/share/man/man4/send.4
  head/share/man/man4/sfxge.4
  head/share/man/man4/snd_hda.4
  head/share/man/man4/snd_ich.4
  head/share/man/man4/ural.4
  head/share/man/man4/usfs.4
  head/share/man/man4/virtio_console.4
  head/share/man/man4/virtio_random.4
  head/share/man/man4/vxlan.4
  head/share/man/man4/wpi.4

Modified: head/share/man/man4/aout.4
==============================================================================
--- head/share/man/man4/aout.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/aout.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/ath_ahb.4
==============================================================================
--- head/share/man/man4/ath_ahb.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/ath_ahb.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/ath_pci.4
==============================================================================
--- head/share/man/man4/ath_pci.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/ath_pci.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/carp.4
==============================================================================
--- head/share/man/man4/carp.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/carp.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/crypto.4
==============================================================================
--- head/share/man/man4/crypto.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/crypto.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -114,7 +114,6 @@ The two modes are described separately b
 .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.

Modified: head/share/man/man4/ip.4
==============================================================================
--- head/share/man/man4/ip.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/ip.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -857,12 +857,12 @@ field was not equal to the length of the
 .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

Modified: head/share/man/man4/ipheth.4
==============================================================================
--- head/share/man/man4/ipheth.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/ipheth.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/iscsi_initiator.4
==============================================================================
--- head/share/man/man4/iscsi_initiator.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/iscsi_initiator.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -112,6 +112,7 @@ for each new session.
 iSCSI RFC 3720
 .\" .Sh HISTORY
 .Sh AUTHORS
-This software was written by Daniel Braniss <danny at cs.huji.ac.il>
+This software was written by
+.An Daniel Braniss Aq Mt danny at cs.huji.ac.il
 .Sh BUGS
 The lun discovery method is old-fashioned.

Modified: head/share/man/man4/isp.4
==============================================================================
--- head/share/man/man4/isp.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/isp.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -230,7 +230,9 @@ This is the readonly World Wide Port Nam
 .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.

Modified: head/share/man/man4/ispfw.4
==============================================================================
--- head/share/man/man4/ispfw.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/ispfw.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -56,4 +56,5 @@ This will kick the f/w into getting unst
 .Sh SEE ALSO
 .Xr isp 4
 .Sh AUTHORS
-This driver was written by Matthew Jacob.
+This driver was written by
+.An Matthew Jacob .

Modified: head/share/man/man4/iwi.4
==============================================================================
--- head/share/man/man4/iwi.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/iwi.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/multicast.4
==============================================================================
--- head/share/man/man4/multicast.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/multicast.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -945,16 +945,16 @@ signal, but the next upcall will be trig
 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 ,

Modified: head/share/man/man4/net80211.4
==============================================================================
--- head/share/man/man4/net80211.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/net80211.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -1313,6 +1313,6 @@ Set whether or not Wi-FI Protected Setup
 .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

Modified: head/share/man/man4/netmap.4
==============================================================================
--- head/share/man/man4/netmap.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/netmap.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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 transmissio
 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 
                  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 err
 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

Modified: head/share/man/man4/nfe.4
==============================================================================
--- head/share/man/man4/nfe.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/nfe.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/ng_ether_echo.4
==============================================================================
--- head/share/man/man4/ng_ether_echo.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/ng_ether_echo.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/ng_netflow.4
==============================================================================
--- head/share/man/man4/ng_netflow.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/ng_netflow.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -315,8 +315,8 @@ we do not use tee, but send packets back
 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 ,

Modified: head/share/man/man4/nvram2env.4
==============================================================================
--- head/share/man/man4/nvram2env.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/nvram2env.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/pass.4
==============================================================================
--- head/share/man/man4/pass.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/pass.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/pccbb.4
==============================================================================
--- head/share/man/man4/pccbb.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/pccbb.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -179,5 +179,5 @@ debugging problems with the bridge chips
 .El
 .Sh SEE ALSO
 .Xr cardbus 4 ,
-.Xr pccard 4 ,
-.Xr exca 4
+.Xr exca 4 ,
+.Xr pccard 4

Modified: head/share/man/man4/pflog.4
==============================================================================
--- head/share/man/man4/pflog.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/pflog.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 31 2007
+.Dd May 31, 2007
 .Dt PFLOG 4
 .Os
 .Sh NAME

Modified: head/share/man/man4/pfsync.4
==============================================================================
--- head/share/man/man4/pfsync.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/pfsync.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 20 2011
+.Dd December 20, 2011
 .Dt PFSYNC 4
 .Os
 .Sh NAME

Modified: head/share/man/man4/pts.4
==============================================================================
--- head/share/man/man4/pts.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/pts.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/sa.4
==============================================================================
--- head/share/man/man4/sa.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/sa.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/send.4
==============================================================================
--- head/share/man/man4/send.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/send.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -196,9 +196,9 @@ Occurs if interface output routines fail
 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

Modified: head/share/man/man4/sfxge.4
==============================================================================
--- head/share/man/man4/sfxge.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/sfxge.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/snd_hda.4
==============================================================================
--- head/share/man/man4/snd_hda.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/snd_hda.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -590,8 +590,8 @@ driver supports more than two hundred di
 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

Modified: head/share/man/man4/snd_ich.4
==============================================================================
--- head/share/man/man4/snd_ich.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/snd_ich.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/ural.4
==============================================================================
--- head/share/man/man4/ural.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/ural.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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/

Modified: head/share/man/man4/usfs.4
==============================================================================
--- head/share/man/man4/usfs.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/usfs.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -54,7 +54,7 @@ the USB stack is activated in USB device
 .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

Modified: head/share/man/man4/virtio_console.4
==============================================================================
--- head/share/man/man4/virtio_console.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/virtio_console.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/virtio_random.4
==============================================================================
--- head/share/man/man4/virtio_random.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/virtio_random.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -52,7 +52,7 @@ device driver provides support for VirtI
 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

Modified: head/share/man/man4/vxlan.4
==============================================================================
--- head/share/man/man4/vxlan.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/vxlan.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -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

Modified: head/share/man/man4/wpi.4
==============================================================================
--- head/share/man/man4/wpi.4	Sun Dec 21 09:43:03 2014	(r275989)
+++ head/share/man/man4/wpi.4	Sun Dec 21 09:53:29 2014	(r275990)
@@ -117,12 +117,12 @@ The hardware switch controlling the radi
 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

More information about the svn-src-head mailing list