Reapply mdoc(7) fixes that got accidentally lost in the last

Bluetooth update, and fix a few more issues.

Submitted by:	Maksim Yevmenkin <m_evmenkin@yahoo.com>, ru
Approved by:	re (blanket)

1 files changed, 34 insertions, 38 deletions

diff --git a/usr.sbin/bluetooth/bcmfw/bcmfw.8 b/usr.sbin/bluetooth/bcmfw/bcmfw.8
index 945fb21..b961167 100644
--- a/usr.sbin/bluetooth/bcmfw/bcmfw.8
+++ b/usr.sbin/bluetooth/bcmfw/bcmfw.8
@@ -1,8 +1,6 @@
-.\" bcmfw.8
-.\" 
 .\" Copyright (c) 2003 Maksim Yevmenkin <m_evmenkin@yahoo.com>
 .\" All rights reserved.
-.\" 
+.\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
@@ -11,7 +9,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
@@ -23,74 +21,72 @@
 .\" 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.
-.\" 
+.\"
 .\" $Id: bcmfw.8,v 1.4 2003/04/28 17:10:56 max Exp $
 .\" $FreeBSD$
+.\"
 .Dd March 31, 2003
 .Dt BCMFW 8
 .Os
 .Sh NAME
-.Nm BCMFW
-.Nd Firmware download utility for Broadcom BCM2033 chip based Bluetooth USB devices
+.Nm bcmfw
+.Nd firmware download utility for Broadcom BCM2033 chip based Bluetooth USB devices
 .Sh SYNOPSIS
 .Nm
-.Op Fl n Ar device name
-.Op Fl m Ar mini-driver file name
-.Op Fl f Ar firmware file name
 .Op Fl h
+.Fl f Ar firmware_file_name
+.Fl m Ar mini-driver_file_name
+.Fl n Ar device_name
 .Sh DESCRIPTION
 The
 .Nm
-utility downloads specified mini-driver and firmware files to the specified
+utility downloads the specified mini-driver and firmware files to the specified
 device.
 .Pp
 This utility will
 .Em only
-work with Broadcom BCM2033 chip based Bluetooth USB devices. The identification
-is currently based on USB vendor ID/product ID pair. The vendor ID should be
-0x0a5c (
-.Dv USB_VENDOR_BROADCOM
-) and the product ID should be 0x2033.
+work with Broadcom BCM2033 chip based Bluetooth USB devices.
+The identification is currently based on USB vendor ID/product ID pair.
+The vendor ID should be 0x0a5c
+.Pq Dv USB_VENDOR_BROADCOM
+and the product ID should be 0x2033.
 .Pp
 The options are as follows:
 .Bl -tag -width indent
-.It Fl n Ar device name
-Specify device name.
-.It Fl m Ar mini-driver file name
-Specify mini-driver file name for download.
-.It Fl f Ar firmware file name
+.It Fl f Ar firmware_file_name
 Specify firmware file name for download.
 .It Fl h
 Display usage message and exit.
+.It Fl m Ar mini-driver_file_name
+Specify mini-driver file name for download.
+.It Fl n Ar device_name
+Specify device name.
 .El
 .Sh FILES
-.Bl -tag -width xxxxxxxxxxxxxxxxx -compact
-.It BCM2033-MD.hex
+.Bl -tag -width ".Pa /dev/ubtbcmfw Ns Ar N Ns Pa \&. Ns Ar EE" -compact
+.It Pa BCM2033-MD.hex
 Mini-driver image.
-.It BCM2033-FW.bin
+.It Pa BCM2033-FW.bin
 Firmware image.
-.It Pa /dev/ubtbcmfw Ns Ar N  Ns Pa \&. Ns Ar EE
+.It Pa /dev/ubtbcmfw Ns Ar N Ns Pa \&. Ns Ar EE
 Endpoint
 .Ar EE
-of device   
+of device
 .Ar N .
 .El
-.Sh Examples
-.Bl -tag -width foo
-.It bcmfw -n ubtbcmfw0 -m BCM2033-MD.hex -f BCM2033-FW.bin
+.Sh EXAMPLES
+To download the firmware into the
+.Pa /dev/ubtbcmfw0
+device:
 .Pp
-Will download firmware into 
-.Pa /dev/ubtbcmfw Ns Ar 0
-device.
-.El
+.Dl "bcmfw -n ubtbcmfw0 -m BCM2033-MD.hex -f BCM2033-FW.bin"
 .Sh BUGS
-Most likely. Please report if found. This code
-.Em was not
-tested on a real BCM2033 based hardware.
+Most likely.
+Please report if found.
 .Sh DIAGNOSTICS
 .Ex -std
 .Sh SEE ALSO
-.Xr ugen 4 ,
-.Xr ubtbcmfw 4
+.Xr ubtbcmfw 4 ,
+.Xr ugen 4
 .Sh AUTHORS
 .An Maksim Yevmenkin Aq m_evmenkin@yahoo.com