Clean up language and markup.
This commit is contained in:
parent
bd0a8237ba
commit
5d819b4bca
@ -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
|
||||
|
@ -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.
|
||||
|
Loading…
Reference in New Issue
Block a user