From 1e9469d188355e00de1c3811dd2f983d2f5a47d9 Mon Sep 17 00:00:00 2001
From: Christian Brueffer <brueffer@FreeBSD.org>
Date: Sun, 21 Dec 2014 10:57:42 +0000
Subject: [PATCH] Fix various mdoc issues and some EOL whitespace.

Found with:	mandoc -Tlint
---
 share/man/man9/BUF_ISLOCKED.9       |  4 ++--
 share/man/man9/BUS_BIND_INTR.9      |  2 +-
 share/man/man9/BUS_DESCRIBE_INTR.9  |  2 +-
 share/man/man9/DB_COMMAND.9         |  2 +-
 share/man/man9/EVENTHANDLER.9       |  2 +-
 share/man/man9/VFS.9                |  4 ++--
 share/man/man9/VFS_CHECKEXP.9       |  4 ++--
 share/man/man9/VFS_FHTOVP.9         |  4 ++--
 share/man/man9/VFS_SET.9            |  4 ++--
 share/man/man9/VOP_LOCK.9           |  5 +++--
 share/man/man9/VOP_VPTOCNP.9        |  4 ++--
 share/man/man9/accf_data.9          |  2 +-
 share/man/man9/accf_dns.9           |  2 +-
 share/man/man9/acl.9                |  2 +-
 share/man/man9/alq.9                |  2 +-
 share/man/man9/devfs_set_cdevpriv.9 |  2 +-
 share/man/man9/eventtimers.9        |  4 ++--
 share/man/man9/ieee80211_crypto.9   |  4 ++--
 share/man/man9/ifnet.9              |  5 +++--
 share/man/man9/kqueue.9             |  5 +++--
 share/man/man9/lock.9               |  4 ++--
 share/man/man9/locking.9            |  6 +++---
 share/man/man9/mbuf.9               |  6 ++++--
 share/man/man9/refcount.9           |  2 +-
 share/man/man9/usbdi.9              |  4 ++--
 share/man/man9/vm_page_busy.9       |  4 ++--
 share/man/man9/vnet.9               | 15 +++++----------
 share/man/man9/vnode.9              |  4 ++--
 share/man/man9/zone.9               |  2 +-
 29 files changed, 56 insertions(+), 56 deletions(-)

diff --git a/share/man/man9/BUF_ISLOCKED.9 b/share/man/man9/BUF_ISLOCKED.9
index 2471db978d9e..8616ff5d65a8 100644
--- a/share/man/man9/BUF_ISLOCKED.9
+++ b/share/man/man9/BUF_ISLOCKED.9
@@ -59,11 +59,11 @@ A shared lock is held.
 The lock is not held by anyone.
 .El
 .Sh SEE ALSO
-.Xr lockstatus 9 ,
 .Xr buf 9 ,
 .Xr BUF_LOCK 9 ,
 .Xr BUF_UNLOCK 9 ,
-.Xr lockmgr 9
+.Xr lockmgr 9 ,
+.Xr lockstatus 9
 .Sh AUTHORS
 This manual page was written by
 .An Attilio Rao Aq Mt attilio@FreeBSD.org .
diff --git a/share/man/man9/BUS_BIND_INTR.9 b/share/man/man9/BUS_BIND_INTR.9
index 2e22dea9ae10..1c97897e51db 100644
--- a/share/man/man9/BUS_BIND_INTR.9
+++ b/share/man/man9/BUS_BIND_INTR.9
@@ -86,8 +86,8 @@ The most recent binding request is the one that will be in effect.
 .Sh RETURN VALUES
 Zero is returned on success, otherwise an appropriate error is returned.
 .Sh SEE ALSO
-.Xr BUS_SETUP_INTR 9 ,
 .Xr cpuset 2 ,
+.Xr BUS_SETUP_INTR 9 ,
 .Xr device 9
 .Sh HISTORY
 The
diff --git a/share/man/man9/BUS_DESCRIBE_INTR.9 b/share/man/man9/BUS_DESCRIBE_INTR.9
index b7f137b5b20e..10004551e76e 100644
--- a/share/man/man9/BUS_DESCRIBE_INTR.9
+++ b/share/man/man9/BUS_DESCRIBE_INTR.9
@@ -87,9 +87,9 @@ the interrupt handler name.
 .Sh RETURN VALUES
 Zero is returned on success, otherwise an appropriate error is returned.
 .Sh SEE ALSO
-.Xr BUS_SETUP_INTR 9 ,
 .Xr systat 1 ,
 .Xr vmstat 8 ,
+.Xr BUS_SETUP_INTR 9 ,
 .Xr device 9 ,
 .Xr printf 9
 .Sh HISTORY
diff --git a/share/man/man9/DB_COMMAND.9 b/share/man/man9/DB_COMMAND.9
index bf3faea69261..34d7b50e0cda 100644
--- a/share/man/man9/DB_COMMAND.9
+++ b/share/man/man9/DB_COMMAND.9
@@ -68,7 +68,7 @@ command, respectively.
 .Pp
 The general command syntax:
 .Cm command Ns Op Li \&/ Ns Ar modifier
-.Ar address Ns Op Li , Ns Ar count ,
+.Ar address Ns Op , Ns Ar count ,
 translates into the following parameters for
 .Fa command_function :
 .Bl -tag -width Fa -offset indent
diff --git a/share/man/man9/EVENTHANDLER.9 b/share/man/man9/EVENTHANDLER.9
index 711c6efaa44e..c8f3002239a9 100644
--- a/share/man/man9/EVENTHANDLER.9
+++ b/share/man/man9/EVENTHANDLER.9
@@ -261,7 +261,7 @@ operation.
 Callbacks invoked when a process exits.
 .It Vt process_fini
 Callback invoked when a process memory is destroyed.
-This is never called. 
+This is never called.
 .It Vt process_fork
 Callbacks invoked when a process forks a child.
 .It Vt process_init
diff --git a/share/man/man9/VFS.9 b/share/man/man9/VFS.9
index cf5189e67a0b..86852ce9caad 100644
--- a/share/man/man9/VFS.9
+++ b/share/man/man9/VFS.9
@@ -54,8 +54,8 @@ rather than implementing empty functions or casting to
 .Xr VFS_SYNC 9 ,
 .Xr VFS_UNMOUNT 9 ,
 .Xr VFS_VGET 9 ,
-.Xr VOP_VPTOFH 9 ,
-.Xr vnode 9
+.Xr vnode 9 ,
+.Xr VOP_VPTOFH 9
 .Sh AUTHORS
 This manual page was written by
 .An Doug Rabson .
diff --git a/share/man/man9/VFS_CHECKEXP.9 b/share/man/man9/VFS_CHECKEXP.9
index 62d545c753ee..42aeeb6833c8 100644
--- a/share/man/man9/VFS_CHECKEXP.9
+++ b/share/man/man9/VFS_CHECKEXP.9
@@ -81,8 +81,8 @@ and
 .Sh SEE ALSO
 .Xr VFS 9 ,
 .Xr VFS_FHTOVP 9 ,
-.Xr VOP_VPTOFH 9 ,
-.Xr vnode 9
+.Xr vnode 9 ,
+.Xr VOP_VPTOFH 9
 .Sh AUTHORS
 This manual page was written by
 .An Alfred Perlstein .
diff --git a/share/man/man9/VFS_FHTOVP.9 b/share/man/man9/VFS_FHTOVP.9
index 39a6168f51b5..cdc03e139a47 100644
--- a/share/man/man9/VFS_FHTOVP.9
+++ b/share/man/man9/VFS_FHTOVP.9
@@ -76,8 +76,8 @@ The locked vnode for the file will be returned in
 .Sh SEE ALSO
 .Xr VFS 9 ,
 .Xr VFS_CHECKEXP 9 ,
-.Xr VOP_VPTOFH 9 ,
-.Xr vnode 9
+.Xr vnode 9 ,
+.Xr VOP_VPTOFH 9
 .Sh AUTHORS
 This manual page was written by
 .An Doug Rabson .
diff --git a/share/man/man9/VFS_SET.9 b/share/man/man9/VFS_SET.9
index c35935e6c476..e0388fd18abc 100644
--- a/share/man/man9/VFS_SET.9
+++ b/share/man/man9/VFS_SET.9
@@ -104,8 +104,8 @@ VFS_SET(myfs_vfsops, myfs, 0);
 .Xr jail 2 ,
 .Xr jail 8 ,
 .Xr DECLARE_MODULE 9 ,
-.Xr vfsconf 9 ,
-.Xr vfs_modevent 9
+.Xr vfs_modevent 9 ,
+.Xr vfsconf 9
 .Sh AUTHORS
 This manual page was written by
 .An Chad David Aq Mt davidc@acns.ab.ca .
diff --git a/share/man/man9/VOP_LOCK.9 b/share/man/man9/VOP_LOCK.9
index b4fdc7ac72b9..db4608037ade 100644
--- a/share/man/man9/VOP_LOCK.9
+++ b/share/man/man9/VOP_LOCK.9
@@ -100,8 +100,9 @@ with these control flags:
 .Bl -tag -width ".Dv LK_CANRECURSE" -offset indent -compact
 .It Dv LK_INTERLOCK
 Specify when the caller already has a simple lock
-.Fn ( VOP_LOCK
-will unlock the simple lock after getting the lock).
+.Po Fn VOP_LOCK
+will unlock the simple lock after getting the lock
+.Pc .
 .It Dv LK_RETRY
 Retry until locked.
 .El
diff --git a/share/man/man9/VOP_VPTOCNP.9 b/share/man/man9/VOP_VPTOCNP.9
index f2d5ddc7755e..740426018109 100644
--- a/share/man/man9/VOP_VPTOCNP.9
+++ b/share/man/man9/VOP_VPTOCNP.9
@@ -78,8 +78,8 @@ The buffer was not large enough to hold the vnode's component name.
 The vnode was not found on the file system.
 .El
 .Sh SEE ALSO
-.Xr VOP_LOOKUP 9 ,
-.Xr vnode 9
+.Xr vnode 9 ,
+.Xr VOP_LOOKUP 9
 .Sh NOTES
 This interface is a work in progress.
 .Sh HISTORY
diff --git a/share/man/man9/accf_data.9 b/share/man/man9/accf_data.9
index 2d3b7a24d693..9caeba9b0029 100644
--- a/share/man/man9/accf_data.9
+++ b/share/man/man9/accf_data.9
@@ -67,7 +67,7 @@ on the socket
 .Sh SEE ALSO
 .Xr setsockopt 2 ,
 .Xr accept_filter 9 ,
-.Xr accf_dns 9
+.Xr accf_dns 9 ,
 .Xr accf_http 9
 .Sh HISTORY
 The accept filter mechanism and the
diff --git a/share/man/man9/accf_dns.9 b/share/man/man9/accf_dns.9
index 4a2dad250666..0ea4bf46b19d 100644
--- a/share/man/man9/accf_dns.9
+++ b/share/man/man9/accf_dns.9
@@ -69,8 +69,8 @@ on a socket
 .Sh SEE ALSO
 .Xr setsockopt 2 ,
 .Xr accept_filter 9 ,
+.Xr accf_data 9 ,
 .Xr accf_http 9
-.Xr accf_data 9
 .Sh HISTORY
 The accept filter mechanism was introduced in
 .Fx 4.0 .
diff --git a/share/man/man9/acl.9 b/share/man/man9/acl.9
index c6c715918011..a4ee9cd2450b 100644
--- a/share/man/man9/acl.9
+++ b/share/man/man9/acl.9
@@ -207,10 +207,10 @@ The following values are valid:
 .El
 .Sh SEE ALSO
 .Xr acl 3 ,
+.Xr vaccess 9 ,
 .Xr vaccess_acl_nfs4 9 ,
 .Xr vaccess_acl_posix1e 9 ,
 .Xr VFS 9 ,
-.Xr vaccess 9 ,
 .Xr VOP_ACLCHECK 9 ,
 .Xr VOP_GETACL 9 ,
 .Xr VOP_SETACL 9
diff --git a/share/man/man9/alq.9 b/share/man/man9/alq.9
index b8b0c237b06c..b13e73d16b9e 100644
--- a/share/man/man9/alq.9
+++ b/share/man/man9/alq.9
@@ -417,10 +417,10 @@ and either the queue is full or the system is shutting down.
 NOTE: invalid arguments to non-void functions will result in
 undefined behaviour.
 .Sh SEE ALSO
+.Xr syslog 3 ,
 .Xr kproc 9 ,
 .Xr ktr 9 ,
 .Xr msleep_spin 9 ,
-.Xr syslog 3 ,
 .Xr vnode 9
 .Sh HISTORY
 The
diff --git a/share/man/man9/devfs_set_cdevpriv.9 b/share/man/man9/devfs_set_cdevpriv.9
index 736a007c1ed5..85df4f3079ab 100644
--- a/share/man/man9/devfs_set_cdevpriv.9
+++ b/share/man/man9/devfs_set_cdevpriv.9
@@ -114,8 +114,8 @@ filedescriptor, or
 was called.
 .El
 .Sh SEE ALSO
-.Xr open 2 ,
 .Xr close 2 ,
+.Xr open 2 ,
 .Xr devfs 5 ,
 .Xr kern_openat 9
 .Sh HISTORY
diff --git a/share/man/man9/eventtimers.9 b/share/man/man9/eventtimers.9
index 09cd8b3e6616..686f63c0ddfc 100644
--- a/share/man/man9/eventtimers.9
+++ b/share/man/man9/eventtimers.9
@@ -179,13 +179,13 @@ methods control timers associated with the current CPU.
 Driver may deregister its functionality by calling
 .Fn et_deregister .
 .Pp
-If the frequency of the clock hardware can change while it is 
+If the frequency of the clock hardware can change while it is
 running (for example, during power-saving modes), the driver must call
 .Fn et_change_frequency
 on each change.
 If the given event timer is the active timer,
 .Fn et_change_frequency
-stops the timer on all CPUs, updates 
+stops the timer on all CPUs, updates
 .Va et->frequency ,
 then restarts the timer on all CPUs so that all
 current events are rescheduled using the new frequency.
diff --git a/share/man/man9/ieee80211_crypto.9 b/share/man/man9/ieee80211_crypto.9
index c82b87663197..1335551ad9f4 100644
--- a/share/man/man9/ieee80211_crypto.9
+++ b/share/man/man9/ieee80211_crypto.9
@@ -253,8 +253,8 @@ and
 These calls also synchronize hardware key state update
 when receive traffic is active.
 .Sh SEE ALSO
-.Xr ieee80211 9 ,
 .Xr ioctl 2 ,
 .Xr wlan_ccmp 4 ,
 .Xr wlan_tkip 4 ,
-.Xr wlan_wep 4
+.Xr wlan_wep 4 ,
+.Xr ieee80211 9
diff --git a/share/man/man9/ifnet.9 b/share/man/man9/ifnet.9
index 7aef4def5176..0e55850beba3 100644
--- a/share/man/man9/ifnet.9
+++ b/share/man/man9/ifnet.9
@@ -418,7 +418,7 @@ lock used to protect interface-related address lists.
 .Xr queue 3
 macro glue for the list of clonable network interfaces.
 .It Va if_groups
-.Pq Fn TAILQ_HEAD ", ifg_list"
+.Pq Fn TAILQ_HEAD "" "ifg_list"
 The head of the
 .Xr queue 3
 .Li TAILQ
@@ -1410,7 +1410,8 @@ address whose remote address is
 if one is found.
 If
 .Fa ignore_ptp
-is true, skip point-to-point interface addresses.  The 
+is true, skip point-to-point interface addresses.
+The
 .Fa fib
 parameter is handled the same way as by
 .Fn ifa_ifwithdstaddr .
diff --git a/share/man/man9/kqueue.9 b/share/man/man9/kqueue.9
index 28aadee776ba..a8137bdfe61b 100644
--- a/share/man/man9/kqueue.9
+++ b/share/man/man9/kqueue.9
@@ -395,8 +395,9 @@ There must be no
 .Vt knotes
 associated with the
 .Vt knlist
-.Fn ( knlist_empty
-returns true)
+.Po Fn knlist_empty
+returns true
+.Pc
 and no more
 .Vt knotes
 may be attached to the object.
diff --git a/share/man/man9/lock.9 b/share/man/man9/lock.9
index 2c874f28f430..69afdc4e90f5 100644
--- a/share/man/man9/lock.9
+++ b/share/man/man9/lock.9
@@ -411,12 +411,12 @@ will be the result of trying.
 .Sh SEE ALSO
 .Xr condvar 9 ,
 .Xr locking 9 ,
+.Xr mtx_assert 9 ,
 .Xr mutex 9 ,
+.Xr panic 9 ,
 .Xr rwlock 9 ,
 .Xr sleep 9 ,
 .Xr sx 9 ,
-.Xr mtx_assert 9 ,
-.Xr panic 9 ,
 .Xr VOP_PRINT 9
 .Sh AUTHORS
 This manual page was written by
diff --git a/share/man/man9/locking.9 b/share/man/man9/locking.9
index f8ac5f2d27b5..76ce70b90541 100644
--- a/share/man/man9/locking.9
+++ b/share/man/man9/locking.9
@@ -391,17 +391,17 @@ At this time this is a rather easy to remember table.
 .El
 .Sh SEE ALSO
 .Xr witness 4 ,
+.Xr BUS_SETUP_INTR 9 ,
 .Xr condvar 9 ,
 .Xr lock 9 ,
+.Xr LOCK_PROFILING 9 ,
 .Xr mtx_pool 9 ,
 .Xr mutex 9 ,
 .Xr rmlock 9 ,
 .Xr rwlock 9 ,
 .Xr sema 9 ,
 .Xr sleep 9 ,
-.Xr sx 9 ,
-.Xr BUS_SETUP_INTR 9 ,
-.Xr LOCK_PROFILING 9
+.Xr sx 9
 .Sh HISTORY
 These
 functions appeared in
diff --git a/share/man/man9/mbuf.9 b/share/man/man9/mbuf.9
index 6edbf4440762..2bde56d37f80 100644
--- a/share/man/man9/mbuf.9
+++ b/share/man/man9/mbuf.9
@@ -1183,8 +1183,10 @@ slab allocation.
 .Sh AUTHORS
 The original
 .Nm
-manual page was written by Yar Tikhiy.
+manual page was written by
+.An Yar Tikhiy .
 The
 .Xr uma 9
 .Vt mbuf
-allocator was written by Bosko Milekic.
+allocator was written by
+.An Bosko Milekic .
diff --git a/share/man/man9/refcount.9 b/share/man/man9/refcount.9
index e7702a22661e..b3c8d7f61d3d 100644
--- a/share/man/man9/refcount.9
+++ b/share/man/man9/refcount.9
@@ -39,7 +39,7 @@
 .In sys/param.h
 .In sys/refcount.h
 .Ft void
-.Fn refcount_init "volatile u_int *count, u_int value"
+.Fn refcount_init "volatile u_int *count" "u_int value"
 .Ft void
 .Fn refcount_acquire "volatile u_int *count"
 .Ft int
diff --git a/share/man/man9/usbdi.9 b/share/man/man9/usbdi.9
index 283cda05d7e1..a42626a7ccfb 100644
--- a/share/man/man9/usbdi.9
+++ b/share/man/man9/usbdi.9
@@ -199,7 +199,7 @@ callback.
 .
 .Fn usbd_transfer_start
 This function will start the USB transfer pointed to by
-.Fa xfer,
+.Fa xfer ,
 if not already started.
 .
 This function is always non-blocking and must be called with the
@@ -212,7 +212,7 @@ pointer.
 .
 .Fn usbd_transfer_stop
 This function will stop the USB transfer pointed to by
-.Fa xfer,
+.Fa xfer ,
 if not already stopped.
 .
 This function is always non-blocking and must be called with the
diff --git a/share/man/man9/vm_page_busy.9 b/share/man/man9/vm_page_busy.9
index 9503dacbe8a8..f4e922a8319f 100644
--- a/share/man/man9/vm_page_busy.9
+++ b/share/man/man9/vm_page_busy.9
@@ -205,7 +205,6 @@ function panics if
 .Fa m
 is not exclusive busied.
 .Sh SEE ALSO
-.Xr VOP_GETPAGES 9 ,
 .Xr vm_page_aflag 9 ,
 .Xr vm_page_alloc 9 ,
 .Xr vm_page_deactivate 9 ,
@@ -213,4 +212,5 @@ is not exclusive busied.
 .Xr vm_page_grab 9 ,
 .Xr vm_page_insert 9 ,
 .Xr vm_page_lookup 9 ,
-.Xr vm_page_rename 9
+.Xr vm_page_rename 9 ,
+.Xr VOP_GETPAGES 9
diff --git a/share/man/man9/vnet.9 b/share/man/man9/vnet.9
index 68689eeeb848..cf7ea4697836 100644
--- a/share/man/man9/vnet.9
+++ b/share/man/man9/vnet.9
@@ -100,8 +100,7 @@
 .Fa "struct vnet *"
 .Fc
 .\"
-.Fo CURVNET_RESTORE
-.Fc
+.Fn CURVNET_RESTORE
 .\"
 .Fo VNET_ITERATOR_DECL
 .Fa "struct vnet *"
@@ -113,14 +112,10 @@
 .\" ------------------------------------------------------------
 .Ss "Locking"
 .\"
-.Fo VNET_LIST_RLOCK
-.Fc
-.Fo VNET_LIST_RUNLOCK
-.Fc
-.Fo VNET_LIST_RLOCK_NOSLEEP
-.Fc
-.Fo VNET_LIST_RUNLOCK_NOSLEEP
-.Fc
+.Fn VNET_LIST_RLOCK
+.Fn VNET_LIST_RUNLOCK
+.Fn VNET_LIST_RLOCK_NOSLEEP
+.Fn VNET_LIST_RUNLOCK_NOSLEEP
 .\" ------------------------------------------------------------
 .Ss "Startup and Teardown Functions"
 .\"
diff --git a/share/man/man9/vnode.9 b/share/man/man9/vnode.9
index 074d8ecfd8ed..666db1e6501b 100644
--- a/share/man/man9/vnode.9
+++ b/share/man/man9/vnode.9
@@ -158,6 +158,7 @@ interlock, will cause a LOR (Lock Order Reversal) due to the
 intertwining of VM Objects and Vnodes.
 .Sh SEE ALSO
 .Xr malloc 9 ,
+.Xr VFS 9 ,
 .Xr VOP_ACCESS 9 ,
 .Xr VOP_ACLCHECK 9 ,
 .Xr VOP_ADVISE 9 ,
@@ -190,8 +191,7 @@ intertwining of VM Objects and Vnodes.
 .Xr VOP_SETEXTATTR 9 ,
 .Xr VOP_STRATEGY 9 ,
 .Xr VOP_VPTOCNP 9 ,
-.Xr VOP_VPTOFH 9 ,
-.Xr VFS 9
+.Xr VOP_VPTOFH 9
 .Sh AUTHORS
 This manual page was written by
 .An Doug Rabson .
diff --git a/share/man/man9/zone.9 b/share/man/man9/zone.9
index ed5939b0f31f..2df14b022eea 100644
--- a/share/man/man9/zone.9
+++ b/share/man/man9/zone.9
@@ -337,7 +337,7 @@ macro declares a static read only
 oid that exports the approximate current occupancy of the zone.
 The
 .Fa zone
-argument should be a pointer to 
+argument should be a pointer to
 .Vt uma_zone_t .
 A read of the oid returns value obtained through
 .Fn uma_zone_get_cur .