mdoc(7) police: Make this look like an average manpage.

svn path=/head/; revision=97605

usr.sbin/devinfo/devinfo.8

@@ -37,26 +37,24 @@
 .Nm
 .Op Fl ru
 .Sh DESCRIPTION
-Devinfo without any arguments, shows the lists of devices using indentation
+The
-and how they are reached from the
+.Nm
-.Em nexus
+utility, without any arguments, shows the hierarchy of devices available
+in the syste, starting from the
+.Dq nexus
 device.
 .Pp
-The following command line arguments are accepted.  When no command line
+The following options are accepted.
-argument(s) are passed,
+.Bl -tag -width indent
-.Xr devinfo 8
+.It Fl r
-simply prints the hierarchy of the device table.
+Causes hardware resource information (such as IRQ, I/O ports, I/O memory
-.Bl -bullet -width indent
+addresses) to be also listed, under each device that has reserved those resources.
-.It
+.It Fl u
-.Op -r :
+Displays the same information as with
-causes hardware resource information (such as IRQ, I/O ports, I/O memory
+.Fl r
-addresses) to be listed, under each device that has reserved those resources.
+but sorts by resource type rather than by device, allowing to review the
-.It
+set of system resources by usage and available resources.
-.Op -u :
+I.e., it lists all
-displays the same information as
-.Op -r ,
-but sorts by resource type rather than by device, allowing you to review the
-set of system resources for usage and available resources. I.e., it lists all
 the IRQ consumers together.
 .El
 .Sh SEE ALSO
@@ -67,5 +65,4 @@ the IRQ consumers together.
 .Xr pnpinfo 8 ,
 .Xr vmstat 8
 .Sh AUTHORS
-.An "Mike Smith"
+.An Mike Smith Aq msmith@FreeBSD.org
-.Aq msmith@FreeBSD.org