Clean up language and markup.

This commit is contained in:
ru 2004-05-19 10:45:40 +00:00
parent bd0a8237ba
commit 5d819b4bca
2 changed files with 66 additions and 61 deletions

View File

@ -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

View File

@ -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.