mdoc(7) police: fixed formatting.

sbin/sysctl/sysctl.8

@@ -51,16 +51,17 @@ The
 .Nm
 utility retrieves kernel state and allows processes with appropriate
 privilege to set kernel state.
-The state to be retrieved or set is described using a ``Management
+The state to be retrieved or set is described using a
-Information Base'' (``MIB'') style name, described as a dotted set of
+.Dq Management Information Base
+.Pq Dq MIB
+style name, described as a dotted set of
 components.
 .Pp
 The following options are available:
 .Bl -tag -width indent
 .It Fl A
 Equivalent to
-.Fl o
+.Fl o a
-.Fl a
 (for compatibility).
 .It Fl a
 List all the currently available non-opaque values.
@@ -77,25 +78,25 @@ completion.
 To enable completion of variable names in
 .Nm zsh ,
 use the following code:
-.Bd -literal -offset indent -compact
+.Bd -literal -offset indent
 listsysctls () { set -A reply $(sysctl -AN ${1%.*}) }
 compctl -K listsysctls sysctl
 .Ed
 .It Fl n
 Show only variable values, not their names.
 This option is useful for setting shell variables.
-For instance, to save the pagesize in variable psize, use:
+For instance, to save the pagesize in variable
-.Bd -literal -offset indent -compact
+.Va psize ,
-set psize=`sysctl -n hw.pagesize`
+use:
-.Ed
+.Pp
+.Dl "set psize=`sysctl -n hw.pagesize`"
 .It Fl o
 Show opaque variables (which are normally suppressed).
 The format and length are printed, as well as a hex dump of the first
 sixteen bytes of the value.
 .It Fl X
 Equivalent to
-.Fl x
+.Fl x a
-.Fl a
 (for compatibility).
 .It Fl x
 As
@@ -112,8 +113,7 @@ only knows about a couple of opaque types, and will resort to hexdumps
 for the rest.
 The opaque information is much more useful if retrieved by special
 purpose programs such as
-.Nm ps ,
+.Nm ps , systat ,
-.Nm systat ,
 and
 .Nm netstat .
 .Pp
@@ -190,46 +190,42 @@ privilege can change the value.
 .Sh EXAMPLES
 For example, to retrieve the maximum number of processes allowed
 in the system, one would use the following request:
-.Bd -literal -offset indent -compact
+.Pp
-sysctl kern.maxproc
+.Dl "sysctl kern.maxproc"
-.Ed
 .Pp
 To set the maximum number of processes allowed
 per uid to 1000, one would use the following request:
-.Bd -literal -offset indent -compact
+.Pp
-sysctl -w kern.maxprocperuid=1000
+.Dl "sysctl -w kern.maxprocperuid=1000"
-.Ed
 .Pp
 Information about the system clock rate may be obtained with:
-.Bd -literal -offset indent -compact
+.Pp
-sysctl kern.clockrate
+.Dl "sysctl kern.clockrate"
-.Ed
 .Pp
 Information about the load average history may be obtained with:
-.Bd -literal -offset indent -compact
-sysctl vm.loadavg
-.Ed
 .Pp
-More variables than these exist, and the best and likely only place 
+.Dl "sysctl vm.loadavg"
+.Pp
+More variables than these exist, and the best and likely only place
 to search for their deeper meaning is undoubtedly the source where
 they are defined.
 .Sh FILES
-.Bl -tag -width <netinet/icmpXvar.h> -compact
+.Bl -tag -xwidth ".Aq Pa netinet/icmp_var.h" -compact
-.It Pa <sys/sysctl.h>
+.It Aq Pa sys/sysctl.h
 definitions for top level identifiers, second level kernel and hardware
 identifiers, and user level identifiers
-.It Pa <sys/socket.h>
+.It Aq Pa sys/socket.h
 definitions for second level network identifiers
-.It Pa <sys/gmon.h>
+.It Aq Pa sys/gmon.h
 definitions for third level profiling identifiers
-.It Pa <vm/vm_param.h>
+.It Aq Pa vm/vm_param.h
 definitions for second level virtual memory identifiers
-.It Pa <netinet/in.h>
+.It Aq Pa netinet/in.h
 definitions for third level Internet identifiers and
 fourth level IP identifiers
-.It Pa <netinet/icmp_var.h>
+.It Aq Pa netinet/icmp_var.h
 definitions for fourth level ICMP identifiers
-.It Pa <netinet/udp_var.h>
+.It Aq Pa netinet/udp_var.h
 definitions for fourth level UDP identifiers
 .El
 .Sh SEE ALSO
@@ -238,15 +234,15 @@ definitions for fourth level UDP identifiers
 .Sh BUGS
 .Nm Sysctl
 presently exploits an undocumented interface to the kernel
-sysctl facility to traverse the sysctl tree and to retrieve format 
+sysctl facility to traverse the sysctl tree and to retrieve format
-and name information. 
+and name information.
 This correct interface is being thought about for the time being.
 .Sh HISTORY
 .Nm Sysctl
 first appeared in
 .Bx 4.4 .
 .Pp
-In 
+In
 .Fx 2.2 ,
 .Nm
 was significantly remodeled.