Clean up language and markup.

2 files changed, 66 insertions, 61 deletions

diff --git a/usr.bin/bluetooth/bthost/bthost.1 b/usr.bin/bluetooth/bthost/bthost.1
index 2fda952..d475f92 100644
--- a/usr.bin/bluetooth/bthost/bthost.1
+++ b/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.
-The argument can be either host name or Bluetooth address.
-The program first attempts to interpret it as Bluetooth address.
-If this fails, it will treat it as host name.
-A Bluetooth address consists of six hex bytes sparated by column,
-e.g. 01:02:03:04:05:06.
-A host name consists of names separated by dots, e.g. my.cell.phone.
+In host mode, it simply converts between the host names and Bluetooth addresses.
+The argument can be either a host name or a Bluetooth address.
+The program first attempts to interpret it as a Bluetooth address.
+If this fails, it will treat it as a host name.
+A Bluetooth address consists of six hex bytes separated by a colon,
+e.g.,
+.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
-and assigned numbers.
-The argument can be either Protocol Service Multiplexor name or assigned number.
-The program first attempts to interpret it as assigned number.
+In protocol mode, it simply converts between the Protocol Service Multiplexor
+names and assigned numbers.
+The argument can be either a Protocol Service Multiplexor name or
+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.
-Here is an example that shows all of them:
-.Pp
-.D1 Ic % bthost localhost
-.Dl Host localhost has address FF:FF:FF:00:00:00
-.D1 Ic % bthost ff:ff:ff:00:00:00
-.Dl Host FF:FF:FF:00:00:00 has name localhost
-.D1 Ic % bthost -b localhost
-.Dl FF:FF:FF:00:00:00
-.D1 Ic % bthost -b ff:ff:ff:00:00:00
-.Dl localhost
-.D1 Ic % bthost do.not.exists
-.Dl do.not.exists: Unknown host
-.D1 Ic % bthost 0:0:0:0:0:0
-.Dl 00:00:00:00:00:00: Unknown host
-.D1 Ic % bthost -p sdp
-.Dl Protocol/Service Multiplexor sdp has number 1
-.D1 Ic % bthost -p 3
-.Dl Protocol/Service Multiplexor rfcomm has number 3
-.D1 Ic % bthost -bp HID-Control
-.Dl 17
-.D1 Ic % bthost -p foo
-.Dl foo: Unknown Protocol/Service Multiplexor
+An output can be quite different,
+here is an example that demonstrates all of the possibilities:
+.Bd -literal -offset indent
+% bthost localhost
+Host localhost has address FF:FF:FF:00:00:00
+% bthost ff:ff:ff:00:00:00
+Host FF:FF:FF:00:00:00 has name localhost
+% bthost -b localhost
+FF:FF:FF:00:00:00
+% bthost -b ff:ff:ff:00:00:00
+localhost
+% bthost do.not.exists
+do.not.exists: Unknown host
+% bthost 0:0:0:0:0:0
+00:00:00:00:00:00: Unknown host
+% bthost -p sdp
+Protocol/Service Multiplexor sdp has number 1
+% bthost -p 3
+Protocol/Service Multiplexor rfcomm has number 3
+% bthost -bp HID-Control
+17
+% bthost -p foo
+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
diff --git a/usr.bin/locale/locale.1 b/usr.bin/locale/locale.1
index b9f7866..52d9974 100644
--- a/usr.bin/locale/locale.1
+++ b/usr.bin/locale/locale.1
@@ -1,7 +1,7 @@
 .\"
 .\" Copyright (c) 2003 Alexey Zelkin <phantom@FreeBSD.org>
 .\" All rights reserved.
-.\" 
+.\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
@@ -10,7 +10,7 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
-.\" 
+.\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -22,7 +22,7 @@
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
-.\" 
+.\"
 .\" $FreeBSD$
 .\"
 .Dd June 20, 2003
@@ -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
-internal status. 
+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
-.Em keyword Ns No 's
-value determined using the current locale settings.
+is invoked with the
+.Ar keyword
+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 
+.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
-.Ar list
-can be used to retrieve human readable list of available keywords.
+The special
+.Pf ( Fx
+specific) keyword
+.Cm list
+can be used to retrieve the human readable list of all available keywords.
 .Sh DIAGNOSTICS
-The
-.Nm
-utility exits 0 on success, and >0 if an error occurs.
+.Ex -std
 .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
-option via CODESETs listing of all available locales.
+.Fl m
+option using the CODESETs listing of all available locales.