The .Nm utility

svn path=/head/; revision=99970

gnu/usr.bin/man/makewhatis/makewhatis.local.8

@@ -37,8 +37,9 @@
 .Op options
 .Ar directories ...
 .Sh DESCRIPTION 
+The
 .Nm
-start 
+utility starts
 .Xr makewhatis 1
 only for file systems physically mounted on the system
 where the 
@@ -51,8 +52,9 @@ your NFS server -- all NFS clients start makewhatis at the same time!
 So use this wrapper for 
 .Xr cron 8
 instead of calling makewhatis directly.
+The
 .Nm catman.local
-is using for same purposes as
+utility is using for same purposes as
 .Nm
 but for
 .Xr catman 1 .
@@ -76,5 +78,5 @@ every week
 .Sh HISTORY
 The
 .Nm
-command appeared in
+utility appeared in
 .Fx 2.2 .

usr.bin/ktrdump/ktrdump.8

@@ -40,7 +40,7 @@
 .Sh DESCRIPTION
 The
 .Nm
-command is used to dump the contents of the kernel ktr trace buffer.
+utility is used to dump the contents of the kernel ktr trace buffer.
 .Pp
 The following options are available:
 .Bl -tag -width ".Fl e Ar execfile"
@@ -68,13 +68,13 @@ The default is standard output.
 .Sh HISTORY
 The
 .Nm
-command first appeared in
+utility first appeared in
 .Fx 5.0 .
 .Sh AUTHORS
 .An -nosplit
 The
 .Nm
-command was implemented by
+utility was implemented by
 .An Jake Burkholder Aq jake@FreeBSD.org .
 .Pp
 This manual page was written by

usr.bin/locate/locate/locate.updatedb.8

@@ -39,8 +39,9 @@
 .Sh SYNOPSIS
 .Nm /usr/libexec/locate.updatedb
 .Sh DESCRIPTION
-.Nm Locate.updatedb
+The
-updates the database used by
+.Nm
+utility updates the database used by
 .Xr locate 1 .
 It is typically run once a week by the
 .Pa /etc/periodic/weekly/310.locate

usr.bin/makewhatis/makewhatis.local.8

@@ -37,8 +37,9 @@
 .Op options
 .Ar directories ...
 .Sh DESCRIPTION 
+The
 .Nm
-start 
+utility starts
 .Xr makewhatis 1
 only for file systems physically mounted on the system
 where the 
@@ -51,8 +52,9 @@ your NFS server -- all NFS clients start makewhatis at the same time!
 So use this wrapper for 
 .Xr cron 8
 instead of calling makewhatis directly.
+The
 .Nm catman.local
-is using for same purposes as
+utility is using for same purposes as
 .Nm
 but for
 .Xr catman 1 .
@@ -76,5 +78,5 @@ every week
 .Sh HISTORY
 The
 .Nm
-command appeared in
+utility appeared in
 .Fx 2.2 .

usr.bin/newkey/newkey.8

@@ -12,8 +12,9 @@
 .Nm
 .Fl u Ar username
 .Sh DESCRIPTION
-.Nm Newkey
+The
-is normally run by the network administrator on the
+.Nm
+utility is normally run by the network administrator on the
 Network Interface Service
 (\s-1NIS\s0)
 master machine in order to establish public keys for
@@ -23,8 +24,9 @@ RPC
 or secure
 NFS\s0.
 .Pp
-.Nm Newkey
+The
-will prompt for the login password of the given username and then
+.Nm
+utility will prompt for the login password of the given username and then
 create a new public/secret key pair in
 .Pa /etc/publickey
 encrypted with the login password of the given user.

usr.bin/renice/renice.8

@@ -45,25 +45,27 @@
 .Op Oo Fl g Oc Ar pgrp ...
 .Op Oo Fl u Oc Ar user ...
 .Sh DESCRIPTION
-.Nm Renice
+The
-alters the
+.Nm
+utility alters the
 scheduling priority of one or more running processes.
 The following
 .Ar who
 parameters are interpreted as process ID's, process group
 ID's, user ID's or user names.
-.Nm Renice Ns 'ing
+The
-a process group causes all processes in the process group
+.Nm Ns 'ing
+of a process group causes all processes in the process group
 to have their scheduling priority altered.
-.Nm Renice Ns 'ing
+The
-a user causes all processes owned by the user to have
+.Nm Ns 'ing
+of a user causes all processes owned by the user to have
 their scheduling priority altered.
 By default, the processes to be affected are specified by
 their process ID's.
 .Pp
-Options supported by
+The following options are available:
-.Nm :
+.Bl -tag -width indent
-.Bl -tag -width Ds
 .It Fl g
 Force
 .Ar who
@@ -77,7 +79,7 @@ Force the
 .Ar who
 parameters to be interpreted as user names or user ID's.
 .It Fl p
-Resets the
+Reset the
 .Ar who
 interpretation to be (the default) process ID's.
 .El
@@ -126,7 +128,7 @@ utility conforms to
 .Sh HISTORY
 The
 .Nm
-command appeared in
+utility appeared in
 .Bx 4.0 .
 .Sh BUGS
 Non super-users cannot increase scheduling priorities of their own processes,

usr.bin/showmount/showmount.8

@@ -46,8 +46,9 @@
 .Op Fl ade3
 .Op Ar host
 .Sh DESCRIPTION
-.Nm Showmount
+The
-shows status information about the
+.Nm
+utility shows status information about the
 .Tn NFS
 server on
 .Ar host .
@@ -63,7 +64,9 @@ and
 .%T "NFS: Network File System Version 3 Protocol Specification" ,
 Appendix I,
 for a detailed description of the protocol.
-.Bl -tag -width Ds
+.Pp
+The following options are available:
+.Bl -tag -width indent
 .It Fl a
 List all mount points in the form:
 .Bd -ragged -offset indent -compact
@@ -76,7 +79,9 @@ Show the
 .Ar host Ns 's
 exports list.
 .It Fl 3
-Use mount protocol Version 3, compatible with NFS Version 3.
+Use mount protocol Version 3, compatible with
+.Tn NFS
+Version 3.
 .El
 .Sh SEE ALSO
 .Xr mount 8 ,
@@ -87,8 +92,9 @@ The mount daemon running on the server only has an idea of the actual mounts,
 since the
 .Tn NFS
 server is stateless.
-.Nm Showmount
+The
-will only display the information
+.Nm
+utility will only display the information
 as accurately as the mount daemon reports it.
 .Sh HISTORY
 The

usr.bin/vmstat/vmstat.8

@@ -55,8 +55,9 @@
 .Oc
 .Op Ar disks
 .Sh DESCRIPTION
-.Nm Vmstat
+The
-reports certain kernel statistics kept about process, virtual memory,
+.Nm
+utility reports certain kernel statistics kept about process, virtual memory,
 disk, trap and cpu activity.
 .Pp
 The options are as follows:
@@ -251,7 +252,9 @@ cause the display to exceed 80 columns, however.
 To force
 .Nm
 to display specific drives, their names may be supplied on the command line.
+The
 .Nm
+utility
 defaults to show disks first, and then various other random devices in the
 system to add up to three devices, if there are that many devices in the
 system.  If devices are specified on the command line, or if a device type

usr.bin/whereis/whereis.1

@@ -154,7 +154,7 @@ Change to the source code directory of
 .Sh HISTORY
 The
 .Nm
-command appeared in
+utility appeared in
 .Bx 3.0 .
 This version re-implements the historical
 functionality that was lost in