Clean up language and markup.

svn path=/head/; revision=129437

usr.bin/bluetooth/bthost/bthost.1

@@ -32,7 +32,7 @@
 .Nm bthost
 .Nd look up Bluetooth host names and Protocol Service Multiplexor values
 .Sh SYNOPSIS
-.Nm bthost
+.Nm
 .Op Fl bhp
 .Ar host_or_protocol
 .Sh DESCRIPTION
@@ -46,18 +46,21 @@ and
 .Pa /etc/bluetooth/protocols
 files.
 .Pp
-In host mode it simply converts between host names and Bluetooth addresses.
+In host mode, it simply converts between the host names and Bluetooth addresses.
-The argument can be either host name or Bluetooth address.
+The argument can be either a host name or a Bluetooth address.
-The program first attempts to interpret it as Bluetooth address.
+The program first attempts to interpret it as a Bluetooth address.
-If this fails, it will treat it as host name.
+If this fails, it will treat it as a host name.
-A Bluetooth address consists of six hex bytes sparated by column,
+A Bluetooth address consists of six hex bytes separated by a colon,
-e.g. 01:02:03:04:05:06.
+e.g.,
-A host name consists of names separated by dots, e.g. my.cell.phone.
+.Dq Li 01:02:03:04:05:06 .
+A host name consists of names separated by dots, e.g.,
+.Dq Li my.cell.phone .
 .Pp
-In protocol mode it simply converts between Protocol Service Multiplexor names
+In protocol mode, it simply converts between the Protocol Service Multiplexor
-and assigned numbers.
+names and assigned numbers.
-The argument can be either Protocol Service Multiplexor name or assigned number.
+The argument can be either a Protocol Service Multiplexor name or
-The program first attempts to interpret it as assigned number.
+an assigned number.
+The program first attempts to interpret it as an assigned number.
 .Pp
 The options are as follows:
 .Bl -tag -width indent
@@ -71,33 +74,34 @@ Activate protocol mode.
 .Pp
 The
 .Nm
-utility will print results to the standard output and error messages to the
+utility will print results to the standard output, and error messages to the
 standard error.
-You may see output of different kinds.
+An output can be quite different,
-Here is an example that shows all of them:
+here is an example that demonstrates all of the possibilities:
-.Pp
+.Bd -literal -offset indent
-.D1 Ic % bthost localhost
+% bthost localhost
-.Dl Host localhost has address FF:FF:FF:00:00:00
+Host localhost has address FF:FF:FF:00:00:00
-.D1 Ic % bthost ff:ff:ff:00:00:00
+% bthost ff:ff:ff:00:00:00
-.Dl Host FF:FF:FF:00:00:00 has name localhost
+Host FF:FF:FF:00:00:00 has name localhost
-.D1 Ic % bthost -b localhost
+% bthost -b localhost
-.Dl FF:FF:FF:00:00:00
+FF:FF:FF:00:00:00
-.D1 Ic % bthost -b ff:ff:ff:00:00:00
+% bthost -b ff:ff:ff:00:00:00
-.Dl localhost
+localhost
-.D1 Ic % bthost do.not.exists
+% bthost do.not.exists
-.Dl do.not.exists: Unknown host
+do.not.exists: Unknown host
-.D1 Ic % bthost 0:0:0:0:0:0
+% bthost 0:0:0:0:0:0
-.Dl 00:00:00:00:00:00: Unknown host
+00:00:00:00:00:00: Unknown host
-.D1 Ic % bthost -p sdp
+% bthost -p sdp
-.Dl Protocol/Service Multiplexor sdp has number 1
+Protocol/Service Multiplexor sdp has number 1
-.D1 Ic % bthost -p 3
+% bthost -p 3
-.Dl Protocol/Service Multiplexor rfcomm has number 3
+Protocol/Service Multiplexor rfcomm has number 3
-.D1 Ic % bthost -bp HID-Control
+% bthost -bp HID-Control
-.Dl 17
+17
-.D1 Ic % bthost -p foo
+% bthost -p foo
-.Dl foo: Unknown Protocol/Service Multiplexor
+foo: Unknown Protocol/Service Multiplexor
+.Ed
 .Sh FILES
-.Bl -tag -width "/etc/bluetooth/hosts" -compact
+.Bl -tag -width ".Pa /etc/bluetooth/hosts" -compact
 .It Pa /etc/bluetooth/hosts
 .It Pa /etc/bluetooth/protocols
 .El

usr.bin/locale/locale.1

@@ -33,7 +33,7 @@
 .Nd get locale-specific information
 .Sh SYNOPSIS
 .Nm
-.Op Fl a | Fl m
+.Op Fl a | m
 .Nm
 .Op Fl ck
 .Op Ar keyword ...
@@ -46,19 +46,20 @@ the standard output.
 When
 .Nm
 is invoked without arguments, it will print out a summary of the current
-locale environment depending on environment variable settings and
+locale environment, subject to the environment settings and
 internal status.
 .Pp
 When
 .Nm
-is invoked with arguments and no options specified, it will print out
+is invoked with the
-.Em keyword Ns No 's
+.Ar keyword
-value determined using the current locale settings.
+arguments, and no options are specified, it will print out the
+values of all keywords specified, using the current locale settings.
 .Pp
 The following options are available:
 .Bl -tag -width indent
 .It Fl a
-Write names of all available locales.
+Print names of all available locales.
 While looking for locales,
 .Nm
 will respect the
@@ -66,29 +67,29 @@ will respect the
 environment variable, and use it instead of the system's default locale
 directory.
 .It Fl m
-Write names of all available charmaps.
+Print names of all available charmaps.
 .It Fl k
-Write the name and value of the selected keywords.
+Print the names and values of all selected keywords.
 .It Fl c
-Write the category name for the selected keywords.
+Print the category name for all selected keywords.
 .El
 .Sh IMPLEMENTATION DETAILS
-Special (FreeBSD specific) keyword
+The special
-.Ar list
+.Pf ( Fx
-can be used to retrieve human readable list of available keywords.
+specific) keyword
+.Cm list
+can be used to retrieve the human readable list of all available keywords.
 .Sh DIAGNOSTICS
-The
+.Ex -std
-.Nm
-utility exits 0 on success, and >0 if an error occurs.
 .Sh BUGS
 Since
 .Fx
 does not support
-.Em charmap Ns No s
+.Em charmap Ns s
 in their
-.Em POSIX
+.Tn POSIX
 meaning,
 .Nm
 emulates the
-.Ar m
+.Fl m
-option via CODESETs listing of all available locales.
+option using the CODESETs listing of all available locales.