Clean up language and markup.

1 files changed, 41 insertions, 37 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