svn commit: r275993 - head/share/man/man9
Christian Brueffer
brueffer at FreeBSD.org
Sun Dec 21 10:57:51 UTC 2014
Author: brueffer
Date: Sun Dec 21 10:57:42 2014
New Revision: 275993
URL: https://svnweb.freebsd.org/changeset/base/275993
Log:
Fix various mdoc issues and some EOL whitespace.
Found with: mandoc -Tlint
Modified:
head/share/man/man9/BUF_ISLOCKED.9
head/share/man/man9/BUS_BIND_INTR.9
head/share/man/man9/BUS_DESCRIBE_INTR.9
head/share/man/man9/DB_COMMAND.9
head/share/man/man9/EVENTHANDLER.9
head/share/man/man9/VFS.9
head/share/man/man9/VFS_CHECKEXP.9
head/share/man/man9/VFS_FHTOVP.9
head/share/man/man9/VFS_SET.9
head/share/man/man9/VOP_LOCK.9
head/share/man/man9/VOP_VPTOCNP.9
head/share/man/man9/accf_data.9
head/share/man/man9/accf_dns.9
head/share/man/man9/acl.9
head/share/man/man9/alq.9
head/share/man/man9/devfs_set_cdevpriv.9
head/share/man/man9/eventtimers.9
head/share/man/man9/ieee80211_crypto.9
head/share/man/man9/ifnet.9
head/share/man/man9/kqueue.9
head/share/man/man9/lock.9
head/share/man/man9/locking.9
head/share/man/man9/mbuf.9
head/share/man/man9/refcount.9
head/share/man/man9/usbdi.9
head/share/man/man9/vm_page_busy.9
head/share/man/man9/vnet.9
head/share/man/man9/vnode.9
head/share/man/man9/zone.9
Modified: head/share/man/man9/BUF_ISLOCKED.9
==============================================================================
--- head/share/man/man9/BUF_ISLOCKED.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/BUF_ISLOCKED.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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 at FreeBSD.org .
Modified: head/share/man/man9/BUS_BIND_INTR.9
==============================================================================
--- head/share/man/man9/BUS_BIND_INTR.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/BUS_BIND_INTR.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -86,8 +86,8 @@ The most recent binding request is the o
.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
Modified: head/share/man/man9/BUS_DESCRIBE_INTR.9
==============================================================================
--- head/share/man/man9/BUS_DESCRIBE_INTR.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/BUS_DESCRIBE_INTR.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/DB_COMMAND.9
==============================================================================
--- head/share/man/man9/DB_COMMAND.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/DB_COMMAND.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/EVENTHANDLER.9
==============================================================================
--- head/share/man/man9/EVENTHANDLER.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/EVENTHANDLER.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/VFS.9
==============================================================================
--- head/share/man/man9/VFS.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/VFS.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -54,8 +54,8 @@ rather than implementing empty functions
.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 .
Modified: head/share/man/man9/VFS_CHECKEXP.9
==============================================================================
--- head/share/man/man9/VFS_CHECKEXP.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/VFS_CHECKEXP.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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 .
Modified: head/share/man/man9/VFS_FHTOVP.9
==============================================================================
--- head/share/man/man9/VFS_FHTOVP.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/VFS_FHTOVP.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -76,8 +76,8 @@ The locked vnode for the file will be re
.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 .
Modified: head/share/man/man9/VFS_SET.9
==============================================================================
--- head/share/man/man9/VFS_SET.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/VFS_SET.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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 at acns.ab.ca .
Modified: head/share/man/man9/VOP_LOCK.9
==============================================================================
--- head/share/man/man9/VOP_LOCK.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/VOP_LOCK.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/VOP_VPTOCNP.9
==============================================================================
--- head/share/man/man9/VOP_VPTOCNP.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/VOP_VPTOCNP.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -78,8 +78,8 @@ The buffer was not large enough to hold
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
Modified: head/share/man/man9/accf_data.9
==============================================================================
--- head/share/man/man9/accf_data.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/accf_data.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/accf_dns.9
==============================================================================
--- head/share/man/man9/accf_dns.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/accf_dns.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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 .
Modified: head/share/man/man9/acl.9
==============================================================================
--- head/share/man/man9/acl.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/acl.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/alq.9
==============================================================================
--- head/share/man/man9/alq.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/alq.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -417,10 +417,10 @@ and either the queue is full or the syst
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
Modified: head/share/man/man9/devfs_set_cdevpriv.9
==============================================================================
--- head/share/man/man9/devfs_set_cdevpriv.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/devfs_set_cdevpriv.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/eventtimers.9
==============================================================================
--- head/share/man/man9/eventtimers.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/eventtimers.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -179,13 +179,13 @@ methods control timers associated with t
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.
Modified: head/share/man/man9/ieee80211_crypto.9
==============================================================================
--- head/share/man/man9/ieee80211_crypto.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/ieee80211_crypto.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/ifnet.9
==============================================================================
--- head/share/man/man9/ifnet.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/ifnet.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -418,7 +418,7 @@ lock used to protect interface-related a
.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 .
Modified: head/share/man/man9/kqueue.9
==============================================================================
--- head/share/man/man9/kqueue.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/kqueue.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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.
Modified: head/share/man/man9/lock.9
==============================================================================
--- head/share/man/man9/lock.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/lock.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/locking.9
==============================================================================
--- head/share/man/man9/locking.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/locking.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -391,17 +391,17 @@ At this time this is a rather easy to re
.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
Modified: head/share/man/man9/mbuf.9
==============================================================================
--- head/share/man/man9/mbuf.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/mbuf.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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 .
Modified: head/share/man/man9/refcount.9
==============================================================================
--- head/share/man/man9/refcount.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/refcount.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/usbdi.9
==============================================================================
--- head/share/man/man9/usbdi.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/usbdi.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/vm_page_busy.9
==============================================================================
--- head/share/man/man9/vm_page_busy.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/vm_page_busy.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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
Modified: head/share/man/man9/vnet.9
==============================================================================
--- head/share/man/man9/vnet.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/vnet.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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"
.\"
Modified: head/share/man/man9/vnode.9
==============================================================================
--- head/share/man/man9/vnode.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/vnode.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -158,6 +158,7 @@ interlock, will cause a LOR (Lock Order
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 .
Modified: head/share/man/man9/zone.9
==============================================================================
--- head/share/man/man9/zone.9 Sun Dec 21 10:56:06 2014 (r275992)
+++ head/share/man/man9/zone.9 Sun Dec 21 10:57:42 2014 (r275993)
@@ -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 .
More information about the svn-src-head
mailing list