[Pkg-bluetooth-maintainers] Bug#539554: bluez: documentation is insufficient

[arne anka]

Package: bluez
Version: 4.42-2
Severity: normal

the available docs are basically only about using bleuz with python or
such, nothing about how to use it as simple user, most notably how to
configure it.

this bug report was triggered by the impossibility to find _any_
information about the configuration of a2dp in audio.conf.
there's a scornfull comment "Just an example of potential config options
for the other interfaces", leaving the user in the dark about both
possible plugins, possible keys and possible values to the two given
(not to speak from anything remotely reminding of an description of
these two options).

there's obviously no documentation for the other config files either.
how is upstream expecting people to use their stuff if they don't care
to explain it?
bluez.org is known for little and often incomprehensible documentation,
focusing upon api and python examples.

-- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.29.4 (SMP w/2 CPU cores; PREEMPT)
Locale: LANG=en_DK.UTF-8, LC_CTYPE=en_DK.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages bluez depends on:
ii  dbus                         1.2.16-2    simple interprocess messaging syst
ii  libbluetooth3                4.42-2      Library to use the BlueZ Linux Blu
ii  libc6                        2.9-23      GNU C Library: Shared libraries
ii  libdbus-1-3                  1.2.16-2    simple interprocess messaging syst
ii  libglib2.0-0                 2.20.4-1    The GLib library of C routines
ii  libnl1                       1.1-5       library for dealing with netlink s
ii  libusb-0.1-4                 2:0.1.12-13 userspace USB programming library
ii  lsb-base                     3.2-23      Linux Standard Base 3.2 init scrip
ii  makedev                      2.3.1-89    creates device files in /dev
ii  module-init-tools            3.9-2       tools for managing Linux kernel mo
ii  udev                         0.141-1     /dev/ and hotplug management daemo

bluez recommends no packages.

Versions of packages bluez suggests:
ii  python-dbus                   0.83.0-1   simple interprocess messaging syst
ii  python-gobject                2.16.1-1   Python bindings for the GObject li

-- debconf-show failed