svn commit: r221070 - stable/8/usr.sbin/bluetooth/l2control

[Maksim Yevmenkin]

Author: emax
Date: Tue Apr 26 16:56:43 2011
New Revision: 221070
URL: http://svn.freebsd.org/changeset/base/221070

Log:
  MFC r220840
  
  Improve the man page and l2control's usage() a bit.
  
  Submitted by:	arundel

Modified:
  stable/8/usr.sbin/bluetooth/l2control/l2control.8
  stable/8/usr.sbin/bluetooth/l2control/l2control.c
Directory Properties:
  stable/8/usr.sbin/bluetooth/l2control/   (props changed)

Modified: stable/8/usr.sbin/bluetooth/l2control/l2control.8
==============================================================================
--- stable/8/usr.sbin/bluetooth/l2control/l2control.8	Tue Apr 26 16:14:55 2011	(r221069)
+++ stable/8/usr.sbin/bluetooth/l2control/l2control.8	Tue Apr 26 16:56:43 2011	(r221070)
@@ -25,7 +25,7 @@
 .\" $Id: l2control.8,v 1.5 2003/05/21 00:53:00 max Exp $
 .\" $FreeBSD$
 .\"
-.Dd June 14, 2002
+.Dd April 9, 2011
 .Dt L2CONTROL 8
 .Os
 .Sh NAME
@@ -34,25 +34,27 @@
 .Sh SYNOPSIS
 .Nm
 .Op Fl hn
-.Fl a Ar BD_ADDR
+.Fl a Ar local
 .Ar command
 .Op Ar parameters ...
 .Sh DESCRIPTION
 The
 .Nm
-utility connects to the local device with the specified BD_ADDR and attempts
-to send the specified command.
+utility connects to the local device with the specified BD_ADDR or name
+and attempts to send the specified command.
 The
 .Nm
 utility will print results to the standard output and error messages to
-the standard error.
+the standard error output.
 .Pp
 The options are as follows:
 .Bl -tag -width indent
-.It Fl a Ar BD_ADDR
-Connect to the local device with the specified BD_ADDR.
+.It Fl a Ar local
+Connect to the local device with the specified BD_ADDR or name.
 Example:
-.Fl a Li 00:01:02:03:04:05 .
+.Fl a Li 00:01:02:03:04:05
+or
+.Fl a Li bt_device .
 .It Fl h
 Display usage message and exit.
 .It Fl n
@@ -62,10 +64,10 @@ Normally
 attempts to resolve Bluetooth addresses, and display them symbolically.
 .It Ar command
 One of the supported commands (see below).
-Special command
+The special command
 .Cm help
-can be used to obtain the list of all supported commands.
-To get more information about specific command use
+can be used to obtain a list of all supported commands.
+To get more information about a specific command use
 .Cm help Ar command .
 .It Ar parameters
 One or more optional space separated command parameters.
@@ -92,4 +94,4 @@ are:
 .Xr ng_l2cap 4 ,
 .Xr l2ping 8
 .Sh AUTHORS
-.An Maksim Yevmenkin Aq m_evmenkin at yahoo.com
+.An Maksim Yevmenkin Aq emax at FreeBSD.org

Modified: stable/8/usr.sbin/bluetooth/l2control/l2control.c
==============================================================================
--- stable/8/usr.sbin/bluetooth/l2control/l2control.c	Tue Apr 26 16:14:55 2011	(r221069)
+++ stable/8/usr.sbin/bluetooth/l2control/l2control.c	Tue Apr 26 16:56:43 2011	(r221070)
@@ -207,7 +207,14 @@ print_l2cap_command(struct l2cap_command
 static void
 usage(void)
 {
-	fprintf(stdout, "Usage: l2control -a BD_ADDR [-n] [-h] cmd [p1] [..]]\n");
+	fprintf(stderr, "Usage: l2control [-hn] -a local cmd [params ..]\n");
+	fprintf(stderr, "Where:\n");
+	fprintf(stderr, "  -a local   Specify local device to connect to\n");
+	fprintf(stderr, "  -h         Display this message\n");
+	fprintf(stderr, "  -n         Show addresses as numbers\n");
+	fprintf(stderr, "  cmd        Supported command " \
+		"(see l2control help)\n");
+	fprintf(stderr, "  params     Optional command parameters\n");
 	exit(255);
 } /* usage */