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-all mailing list