mdoc(7) police: scheduled sweep.

Approved by:	re

8 files changed, 49 insertions, 32 deletions

diff --git a/share/man/man9/VOP_IOCTL.9 b/share/man/man9/VOP_IOCTL.9
index 5265d74..3670d62 100644
--- a/share/man/man9/VOP_IOCTL.9
+++ b/share/man/man9/VOP_IOCTL.9
@@ -64,7 +64,9 @@ The file should not be locked on entry.
 .Sh RETURN VALUES
 If successful, zero is returned, otherwise an appropriate error code.
 .Pp
-If the ioctl is not recognized or not handled, ENOTTY should be returned.
+If the ioctl is not recognized or not handled,
+.Er ENOTTY
+should be returned.
 .Sh PSEUDOCODE
 .Bd -literal
 int
diff --git a/share/man/man9/VOP_LINK.9 b/share/man/man9/VOP_LINK.9
index 7c355dd..f95c55d 100644
--- a/share/man/man9/VOP_LINK.9
+++ b/share/man/man9/VOP_LINK.9
@@ -52,13 +52,17 @@ the vnode of the file to be linked
 pathname information about the file
 .El
 .Pp
-The pathname info should NOT be released on exit because it is done
+The pathname info should
+.Em not
+be released on exit because it is done
 by the caller.
-The directory and file vnodes should NOT be released on exit.
+The directory and file vnodes should
+.Em not
+be released on exit.
 .Sh LOCKS
 .Xr VOP_LINK 9
 expects the directory and file vnodes to be locked on entry and will leave
-the vnodes locked on return.  
+the vnodes locked on return.
 .Sh RETURN VALUES
 Zero is returned if the file was linked successfully, otherwise an
 error is returned.
@@ -97,12 +101,8 @@ vop_link(struct vnode *dvp, struct vnode *vp, struct componentname *cnp)
 .Bl -tag -width Er
 .It Bq Er EMLINK
 The file has too many links.
-.El
-.Bl -tag -width Er
 .It Bq Er EPERM
 The file is immutable.
-.El
-.Bl -tag -width Er
 .It Bq Er EXDEV
 A hard link is not possible between different file systems.
 .El
diff --git a/share/man/man9/VOP_RENAME.9 b/share/man/man9/VOP_RENAME.9
index 2424e13..a3c3546 100644
--- a/share/man/man9/VOP_RENAME.9
+++ b/share/man/man9/VOP_RENAME.9
@@ -298,10 +298,10 @@ The file is immutable.
 It is not possible to rename a file between different file systems.
 .It Bq Er EINVAL
 An attempt was made to rename
-.Ql .\& 
+.Pa \&.
 or
-.Ql \&.. ,
-or a perform an operation which would break the directory tree structure.
+.Pa .. ,
+or to perform an operation which would break the directory tree structure.
 .It Bq Er ENOTDIR
 An attempt was made to rename a directory to a file or vice versa.
 .It Bq Er ENOTEMPTY
diff --git a/share/man/man9/ifnet.9 b/share/man/man9/ifnet.9
index 216ff36..b640ccf 100644
--- a/share/man/man9/ifnet.9
+++ b/share/man/man9/ifnet.9
@@ -444,7 +444,7 @@ This interface is in promiscuous mode.
 .It Dv IFF_PPROMISC
 .Aq D
 This interface is in the permanently promiscuous mode (implies
-IFF_PROMISC).
+.Dv IFF_PROMISC ) .
 .It Dv IFF_ALLMULTI
 .Aq D*
 This interface is in all-multicasts mode (used by multicast routers).
diff --git a/share/man/man9/random.9 b/share/man/man9/random.9
index 98d0ffa..e8f365f 100644
--- a/share/man/man9/random.9
+++ b/share/man/man9/random.9
@@ -30,6 +30,7 @@
 .Os
 .Dt RANDOM 9
 .Sh NAME
+.Nm arc4rand ,
 .Nm arc4random ,
 .Nm random ,
 .Nm read_random ,
@@ -58,11 +59,11 @@ by calling
 with
 .Ql 1
 as the
-.Ar seed .
+.Fa seed .
 The
 .Fn srandom
 function may be called with any arbitrary
-.Ar seed
+.Fa seed
 value to get slightly more unpredictable numbers.
 It is important to remember that the
 .Fn random
@@ -79,7 +80,7 @@ are seeded from the entropy device if it is available.
 Automatic reseeds happen after a certain timeinterval and after a
 certain number of bytes have been delivered.
 A forced reseed can be forced by passing a non-zero value in the
-.Ar reseed
+.Fa reseed
 argument.
 .Pp
 The
@@ -87,17 +88,17 @@ The
 function is used to return entropy directly from the entropy device
 if it has been loaded. If the entropy device is not loaded, then
 the
-.Ar buffer
+.Fa buffer
 is filled with output generated by
 .Fn random .
 The
-.Ar buffer
+.Fa buffer
 is filled with no more than
-.Ar count
+.Fa count
 bytes. It is advised that
 .Fn read_random
 is not used; instead use
-.Fn arc4rand 
+.Fn arc4rand
 .Pp
 All the bits generated by
 .Fn random ,
@@ -133,7 +134,7 @@ bytes.
 The
 .Fn arc4random
 function
-uses 
+uses
 .Fn arc4rand
 to generate pseudo-random numbers in the range from 0 to
 .if t 2\u\s732\s10\d\(mi1.
@@ -142,7 +143,7 @@ to generate pseudo-random numbers in the range from 0 to
 The
 .Fn read_random
 function returns the number of bytes placed in
-.Ar buffer .
+.Fa buffer .
 .Sh AUTHORS
 .An Dan Moschuk
 wrote
diff --git a/share/man/man9/style.9 b/share/man/man9/style.9
index fabb1a4..101b4a2 100644
--- a/share/man/man9/style.9
+++ b/share/man/man9/style.9
@@ -195,7 +195,9 @@ greater than 20 lines, or where a series of nested
 .Ic #ifdef 's
 may be confusing to the reader.
 Exceptions may be made for cases where code is conditionally not compiled for
-the purposes of lint, even though the uncompiled region may be small.
+the purposes of
+.Xr lint 1 ,
+even though the uncompiled region may be small.
 The comment should be separated from the
 .Ic #endif
 or
@@ -252,8 +254,11 @@ enum enumtype { ONE, TWO } et;
 .Pp
 In declarations, do not put any whitespace between asterisks and
 adjacent tokens, except for tokens that are identifiers related to
-types.  (These identifiers are the names of basic types, type
-qualifiers, and typedef-names other than the one being declared.)
+types.
+(These identifiers are the names of basic types, type
+qualifiers, and
+.Ic typedef Ns -names
+other than the one being declared.)
 Separate these identifers from asterisks using a single space.
 .Pp
 When declaring variables in structures, declare them sorted by use, then
diff --git a/share/man/man9/swi.9 b/share/man/man9/swi.9
index 2f0faa9..2944a40 100644
--- a/share/man/man9/swi.9
+++ b/share/man/man9/swi.9
@@ -136,7 +136,7 @@ when scheduling a software interrupt handler can be used to implement the
 functionality performed by
 .Fn setdelayed
 in earlier versions of
-.Fx . 
+.Fx .
 .El
 .Pp
 The
diff --git a/share/man/man9/zone.9 b/share/man/man9/zone.9
index 48309b6..43076b9 100644
--- a/share/man/man9/zone.9
+++ b/share/man/man9/zone.9
@@ -101,9 +101,11 @@ the uma subsystem at the time of the call to
 .Fn uma_zalloc
 and
 .Fn uma_zfree
-respectively.  Their purpose is to provide hooks for initializing or
+respectively.
+Their purpose is to provide hooks for initializing or
 destroying things that need to be done at the time of the allocation
-or release of a resource.  A good useage for the
+or release of a resource.
+A good useage for the
 .Fa ctor
 and
 .Fa dtor
@@ -115,13 +117,20 @@ The
 and
 .Fa fini
 arguments are used to optimize the allocation of
-objects from the zone.  They are called by the uma subsystem whenever
+objects from the zone.
+They are called by the uma subsystem whenever
 it needs to allocate or free several items to satisfy requests or memory
-pressure.  A good use for the uminit and fini callbacks might be to
-initialize and destroy mutexes contained within the object.  This would
+pressure.
+A good use for the
+.Fa uminit
+and
+.Fa fini
+callbacks might be to
+initialize and destroy mutexes contained within the object.
+This would
 allow one to re-use already initialized mutexes when an object is returned
-from the uma subsystem's object cache.  They are not called on each call
-to
+from the uma subsystem's object cache.
+They are not called on each call to
 .Fn uma_zalloc
 and
 .Fn uma_zfree