Fix a slew of mdoc errors and warnings.

MFC after: 1 week
nhuff · Feb 23, 2019 · 1adc28f · 1adc28f
1 parent 0dfc145
commit 1adc28f
Show file tree

Hide file tree

Showing 34 changed files with 57 additions and 29 deletions.
diff --git a/share/man/man4/cc_newreno.4 b/share/man/man4/cc_newreno.4
@@ -75,6 +75,7 @@ the congestion window in response to an ECN congestion signal when
 .Va net.inet.tcp.cc.abe=1
 per: cwnd = (cwnd * CC_NEWRENO_BETA_ECN) / 100.
 Default is 80.
+.El
 .Sh MIB Variables
 The algorithm exposes these variables in the
 .Va net.inet.tcp.cc.newreno
@@ -93,6 +94,7 @@ the congestion window in response to an ECN congestion signal when
 .Va net.inet.tcp.cc.abe=1
 per: cwnd = (cwnd * beta_ecn) / 100.
 Default is 80.
+.El
 .Sh SEE ALSO
 .Xr cc_chd 4 ,
 .Xr cc_cubic 4 ,

diff --git a/share/man/man4/ctl.4 b/share/man/man4/ctl.4
@@ -202,6 +202,7 @@ The default value is 1024.
 .It Va kern.cam.ctl.max_ports
 Specifies the maximum number of ports we support, must be a power of 2.
 The default value is 256.
+.El
 .Sh SEE ALSO
 .Xr cfiscsi 4 ,
 .Xr cfumass 4 ,

diff --git a/share/man/man4/ehci.4 b/share/man/man4/ehci.4
@@ -88,6 +88,7 @@ The default value is 0 (off).
 .It Va hw.usb.ehci.no_hs
 This tunable disables USB devices to attach like HIGH-speed ones and will force all attached devices to attach to the FULL- or LOW-speed companion controller.
 The default value is 0 (off).
+.El
 .Sh SYSCTL VARIABLES
 The following variables are available as both
 .Xr sysctl 8

diff --git a/share/man/man4/em.4 b/share/man/man4/em.4
@@ -264,6 +264,7 @@ If
 .Va hw.em.tx_int_delay
 is non-zero, this tunable limits the maximum delay in which a transmit
 interrupt is generated.
+.El
 .Sh FILES
 .Bl -tag -width /dev/led/em*
 .It Pa /dev/led/em*

diff --git a/share/man/man4/ena.4 b/share/man/man4/ena.4
@@ -239,6 +239,7 @@ for more details.
 .Pp
 Packet with unsupported number of segments was queued for sending to the
 device; packet will be dropped.
+.El
 .Sh SUPPORT
 If an issue is identified with the released source code with a supported adapter
 email the specific information related to the issue to

diff --git a/share/man/man4/ips.4 b/share/man/man4/ips.4
@@ -114,7 +114,7 @@ Unable to obtain adapter or drive configuration.
 A buffer input/output error has occurred.
 .Bq Er ENXIO
 .El
-.Ss General adapter errors:
+.Ss General adapter errors :
 .Bl -diag
 .It Attaching bus failed
 .Pp
@@ -146,7 +146,7 @@ The adapter is disabled.
 .Pp
 The driver was unable to allocate resources for the device.
 .El
-.Ss Error messages due to DMA:
+.Ss Error messages due to DMA :
 .Bl -diag
 .It can't alloc command dma tag
 .It can't alloc SG dma tag
@@ -155,7 +155,7 @@ The driver was unable to allocate resources for the device.
 .Pp
 Failure to map or allocate DMA resources.
 .El
-.Ss Cache, buffer, and command errors:
+.Ss Cache, buffer, and command errors :
 .Bl -diag
 .It failed to initialize command buffers
 .It no mem for command slots!

diff --git a/share/man/man4/liquidio.4 b/share/man/man4/liquidio.4
@@ -110,6 +110,7 @@ To enable/disable driver RSS support
 .It Va hw.lio.hwlro
 .Pp
 To enable/disable hardware LRO
+.El
 .Sh SUPPORT
 For general information and support,
 go to the Cavium support website at:

diff --git a/share/man/man4/nda.4 b/share/man/man4/nda.4
@@ -70,14 +70,15 @@ It's value is hard coded to 0 indicating flash.
 This variable reports whether the
 .Nm
 driver accepts unmapped I/O for this unit.
+.El
 .Sh FILES
 .Bl -tag -width ".Pa /dev/nda*" -compact
 .It Pa /dev/nda*
 NVMe storage device nodes
 .El
 .Sh SEE ALSO
-.Xr nvme 4 ,
-.Xr nvd 4
+.Xr nvd 4 ,
+.Xr nvme 4
 .Sh HISTORY
 The
 .Nm

diff --git a/share/man/man4/ng_nat.4 b/share/man/man4/ng_nat.4
@@ -387,6 +387,7 @@ route add default x.y.0.1
         msg igb0_NAT: setdlt 1
         msg igb0_NAT: setaliasaddr x.y.8.35
 SEQ
+.Ed
 .Sh SEE ALSO
 .Xr libalias 3 ,
 .Xr ng_ipfw 4 ,

diff --git a/share/man/man4/ohci.4 b/share/man/man4/ohci.4
@@ -70,6 +70,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh SEE ALSO
 .Xr ehci 4 ,
 .Xr uhci 4 ,

diff --git a/share/man/man4/pci.4 b/share/man/man4/pci.4
@@ -386,7 +386,7 @@ specified by the
 member, otherwise fail.
 .It PCIIO_BAR_MMAP_EXCL
 Must be used together with
-.Vd PCIIO_BAR_MMAP_FIXED
+.Dv PCIIO_BAR_MMAP_FIXED
 If the specified base contains already established mappings, the
 operation fails instead of implicitly unmapping them.
 .It PCIIO_BAR_MMAP_RW

diff --git a/share/man/man4/sctp.4 b/share/man/man4/sctp.4
@@ -176,7 +176,7 @@ and tested with
 .Xr getsockopt 2
 or
 .Xr sctp_opt_info 3 :
-.Bl -tag -indent
+.Bl -tag -width indent
 .It Dv SCTP_NODELAY
 Under most circumstances,
 .Tn SCTP

diff --git a/share/man/man4/ses.4 b/share/man/man4/ses.4
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 05, 2015
+.Dd September 5, 2015
 .Dt SES 4
 .Os
 .Sh NAME

diff --git a/share/man/man4/siftr.4 b/share/man/man4/siftr.4
@@ -399,11 +399,15 @@ The summation of num_inbound_tcp_pkts and num_outbound_tcp_pkts.
 .El
 .Bl -tag -offset indent -width Va
 .It Va num_inbound_skipped_pkts_malloc
-Number of inbound packets that were not processed because of failed malloc() calls.
+Number of inbound packets that were not processed because of failed
+.Fn malloc
+calls.
 .El
 .Bl -tag -offset indent -width Va
 .It Va num_outbound_skipped_pkts_malloc
-Number of outbound packets that were not processed because of failed malloc() calls.
+Number of outbound packets that were not processed because of failed
+.Fn malloc
+calls.
 .El
 .Bl -tag -offset indent -width Va
 .It Va num_inbound_skipped_pkts_mtx
@@ -759,8 +763,10 @@ Ideally,
 .Nm
 should intercept packets after they have been processed by the TCP layer i.e.
 intercept packets coming up the stack after they have been processed by
-tcp_input(), and intercept packets coming down the stack after they have been
-processed by tcp_output().
+.Fn tcp_input ,
+and intercept packets coming down the stack after they have been
+processed by
+.Fn tcp_output .
 The current code still gives satisfactory granularity though, as inbound events
 tend to trigger outbound events, allowing the cause-and-effect to be observed
 indirectly by capturing the state on outbound events as well.

diff --git a/share/man/man4/smartpqi.4 b/share/man/man4/smartpqi.4
@@ -23,7 +23,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$ stable/10/share/man/man4/smartpqi.4 195614 2017-01-11 08:10:18Z jkim $
-.Dd April 06, 2018
+.Dd April 6, 2018
 .Dt SMARTPQI 4
 .Os
 .Sh NAME
@@ -37,6 +37,7 @@ kernel configuration file:
 .Cd device pci
 .Cd device scbus
 .Cd device smartpqi
+.Ed
 .Pp
 Alternatively, to load the driver as a
 module at boot time, place the following line in
@@ -81,10 +82,10 @@ smartpqi management interface
 .Xr kld 4 ,
 .Xr linux 4 ,
 .Xr scsi 4 ,
-.Xr kldload 8
-.Xr pass 4
-.Xr xpt 4
-.Xr loader.conf 5
+.Xr kldload 8 ,
+.Xr pass 4 ,
+.Xr xpt 4 ,
+.Xr loader.conf 5 ,
 .Xr camcontrol 8
 .Rs
 .%T "Microsemi Website"
@@ -95,7 +96,7 @@ The
 .Nm
 driver first appeared in
 .Fx 11.1 .
-.Sh AUTHOR
+.Sh AUTHORS
 .An Murthy Bhat
 .Aq [email protected]
 .Sh BUGS

diff --git a/share/man/man4/sysmouse.4 b/share/man/man4/sysmouse.4
@@ -55,7 +55,6 @@ Make sure that
 .Xr moused 8
 is running, otherwise the user process will not see any data coming from
 the mouse.
-.Pp
 .Ss Operation Levels
 The
 .Nm

diff --git a/share/man/man4/tcp.4 b/share/man/man4/tcp.4
@@ -597,8 +597,7 @@ The default TCP function block (TCP stack).
 .It Va functions_inherit_listen_socket_stack
 Determines whether to inherit listen socket's tcp stack or use the current
 system default tcp stack, as defined by
-.Va functions_default
-.Pc .
+.Va functions_default .
 Default is true.
 .It Va insecure_rst
 Use criteria defined in RFC793 instead of RFC5961 for accepting RST segments.

diff --git a/share/man/man4/uath.4 b/share/man/man4/uath.4
@@ -76,7 +76,7 @@ This is normally done by the
 utility that is launched by
 .Xr devd 8
 when the device is inserted.
-.Xr uathload
+.Xr uathload 8
 includes the firmware in the binary program.
 This firmware is licensed for general use and is included in the base system.
 .Sh HARDWARE

diff --git a/share/man/man4/ucom.4 b/share/man/man4/ucom.4
@@ -81,6 +81,7 @@ driver will mark terminals as console devices when operating in device mode.
 Default is 1.
 .It Va hw.usb.ucom.pps_mode
 Enables and configure PPS capture mode as described below.
+.El
 .Sh Pulse Per Second (PPS) Timing Interface
 The
 .Nm

diff --git a/share/man/man4/ugen.4 b/share/man/man4/ugen.4
@@ -302,6 +302,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh FILES
 .Bl -tag -width ".Pa /dev/ugen Ns Ar N Ns Pa \&. Ns Ar E" -compact
 .It Pa /dev/ugen Ns Ar N Ns Pa \&. Ns Ar E

diff --git a/share/man/man4/uhci.4 b/share/man/man4/uhci.4
@@ -60,6 +60,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh SEE ALSO
 .Xr ehci 4 ,
 .Xr ohci 4 ,

diff --git a/share/man/man4/uhid.4 b/share/man/man4/uhid.4
@@ -155,6 +155,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh FILES
 .Bl -tag -width ".Pa /dev/uhid?"
 .It Pa /dev/uhid?

diff --git a/share/man/man4/ukbd.4 b/share/man/man4/ukbd.4
@@ -147,6 +147,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh FILES
 .Bl -tag -width ".Pa /dev/kbd*" -compact
 .It Pa /dev/kbd*

diff --git a/share/man/man4/umoscom.4 b/share/man/man4/umoscom.4
@@ -77,4 +77,7 @@ corresponding callout initial-state and lock-state devices
 .Sh HISTORY
 The
 .Nm
-driver appeared in OpenBSD and was ported to FreeBSD.
+driver appeared in
+.Ox
+and was ported to
+.Fx .
diff --git a/share/man/man4/ums.4 b/share/man/man4/ums.4
@@ -75,6 +75,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh FILES
 .Bl -tag -width /dev/ums0 -compact
 .It Pa /dev/ums0

diff --git a/share/man/man4/uplcom.4 b/share/man/man4/uplcom.4
@@ -191,6 +191,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh FILES
 .Bl -tag -width "/dev/ttyU*.init" -compact
 .It Pa /dev/ttyU*

diff --git a/share/man/man4/usb.4 b/share/man/man4/usb.4
@@ -142,6 +142,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh SEE ALSO
 The
 .Tn USB
@@ -173,7 +174,7 @@ specifications can be found at:
 .Xr uvscom 4 ,
 .Xr xhci 4
 .Xr usbconfig 8 ,
-.Xr usbdi 9 ,
+.Xr usbdi 9
 .Sh STANDARDS
 The
 .Nm

diff --git a/share/man/man4/uvscom.4 b/share/man/man4/uvscom.4
@@ -90,6 +90,7 @@ for callout ports
 .It Pa /dev/cuaU*.init
 .It Pa /dev/cuaU*.lock
 corresponding callout initial-state and lock-state devices
+.El
 .Sh SEE ALSO
 .Xr tty 4 ,
 .Xr ucom 4 ,

diff --git a/share/man/man4/vale.4 b/share/man/man4/vale.4
@@ -28,7 +28,7 @@
 .\" $FreeBSD$
 .\" $Id: $
 .\"
-.Dd Jan 9, 2019
+.Dd January 9, 2019
 .Dt VALE 4
 .Os
 .Sh NAME

diff --git a/share/man/man4/vmci.4 b/share/man/man4/vmci.4
@@ -59,6 +59,7 @@ virtual machine itself.
 .Rs
 .%T "VMware vSockets Documentation"
 .%U https://www.vmware.com/support/developer/vmci-sdk/
+.Re
 .Sh HISTORY
 The
 .Nm

diff --git a/share/man/man4/vmm.4 b/share/man/man4/vmm.4
@@ -31,7 +31,6 @@
 .Nm vmm.ko
 .Nd "bhyve virtual machine monitor"
 .Sh SYNOPSIS
-.Pp
 To load the driver as a module at boot, add this line to
 .Xr loader.conf 5 :
 .Bd -literal -offset indent
@@ -47,7 +46,7 @@ kldload vmm
 .Nm
 provides the kernel portion of the
 .Xr bhyve 4
-hypervisor. 
+hypervisor.
 .Pp
 An Intel CPU with VT-x/EPT or AMD CPU with SVM support is required.
 .Pp

diff --git a/share/man/man4/wi.4 b/share/man/man4/wi.4
@@ -316,7 +316,7 @@ command.
 .Xr wlan_xauth 4 ,
 .Xr hostapd 8 ,
 .Xr ifconfig 8 ,
-.Xr wpa_supplicant 8 .
+.Xr wpa_supplicant 8
 .Rs
 .%T HCF Light programming specification
 .%U http://web.archive.org/web/20040130141721/http://wavelan.com/

diff --git a/share/man/man4/xe.4 b/share/man/man4/xe.4
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 24 2018
+.Dd October 24, 2018
 .Dt XE 4
 .Os
 .Sh NAME

diff --git a/share/man/man4/xhci.4 b/share/man/man4/xhci.4
@@ -67,6 +67,7 @@ tunables:
 Debug output level, where 0 is debugging disabled and larger values increase
 debug message verbosity.
 Default is 0.
+.El
 .Sh SEE ALSO
 .Xr ehci 4 ,
 .Xr ohci 4 ,
-Original file line number
+Diff line change
@@ Expand Up / @@ -59,6 +59,7 @@ virtual machine itself. @@
     .Rs
     .%T "VMware vSockets Documentation"
     .%U https://www.vmware.com/support/developer/vmci-sdk/
+    .Re
     .Sh HISTORY
     The
     .Nm
@@ Expand Down @@