[Pkg-bluetooth-maintainers] Bug#477335: bluez-utils: Suggested changes to README.Debian

[Phil Endecott]

Package: bluez-utils
Version: 3.30-3
Severity: wishlist


I'm typing this using a Bluetooth keyboard which it has taken me a long time to get 
working.  Here are a couple of suggestions for README.Debian that could have saved 
me a bit of time:

    hidd --connect <bdaddr>
    ...
    For keyboards, type the PIN on the Bluetooth keyboard and hit
    enter, and then type it in on a cable-attached keyboard to pair.

I was typing it at the hidd program, which was ignoring me.  Maybe this is obvious 
if you're running gnome (etc) that pops up a dialog, but I wasn't.  So I suggest 
replacing that last part of that sentence with:

    ...and then supply it to the passkey agent (using a cable-attached keyboard).

Regarding the passkey-agent program: is there a reason for not including a binary? 
It's only 8532 bytes.  Example usage would also be helpful:

$ ./passkey-agent --default 1234

BTW, the "unsupported" /var/lib/bluetooth/.../pincodes feature didn't work for me.  
Maybe I was doing something wrong (strace tells me that the file was being read by 
hcid).  If this has now broken for some reason you might want to remove that 
section.

Many thanks, Phil.


-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.25
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)

Versions of packages bluez-utils depends on:
ii  dbus                          1.2.1-1    simple interprocess messaging syst
ii  libbluetooth2                 3.30-1     Library to use the BlueZ Linux Blu
ii  libc6                         2.7-10     GNU C Library: Shared libraries
ii  libdbus-1-3                   1.2.1-1    simple interprocess messaging syst
ii  libglib2.0-0                  2.12.4-2   The GLib library of C routines
ii  libusb-0.1-4                  2:0.1.12-2 userspace USB programming library
ii  lsb-base                      3.2-10     Linux Standard Base 3.2 init scrip
ii  makedev                       2.3.1-80   creates device files in /dev
ii  module-init-tools             3.2.2-2    tools for managing Linux kernel mo
ii  udev                          0.103-1    /dev/ and hotplug management daemo

Versions of packages bluez-utils recommends:
pn  bluez-audio                   <none>     (no description available)

-- no debconf information