Bug#788397: pulseaudio: PulseAudio's man page pulseaudio(1) mentions ‘--daemon’ but describes it as ‘--daemonize’

[Sebastian Fontius]

Package: pulseaudio
Version: 6.0-2
Severity: minor

Dear Maintainer,

pulseaudio(1) reads this for ‘--start’:

       --start
              Start PulseAudio if it is not running yet.  This is
              different from starting PulseAudio without --start which
              would fail if PA is already running.  PulseAudio is
              guaranteed to be fully initialized when this call
              returns. Implies --daemon.

But the option is described as ‘-D | --daemonize’:

       -D | --daemonize[=BOOL]
              Daemonize after startup, i.e. detach from the terminal.

In fact /usr/bin/pulseaudio accepts ‘--daemon’, too, since it accepts
any of its options as long as they are unambiguous (in fact, ‘--da’
suffices), but that is not mentioned in pulseaudio(1).  It seems kind
of confusing to have the man page refer to the same option by
different names.

Regards,


Sebastian


-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (550, 'testing'), (50, 'unstable'), (40, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.0.0-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=de_DE.utf8, LC_CTYPE=de_DE.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages pulseaudio depends on:
ii  adduser                       3.113+nmu3
ii  libasound2                    1.0.28-1
ii  libasound2-plugins            1.0.28-1+b1
ii  libc6                         2.19-18
ii  libcap2                       1:2.24-8
ii  libdbus-1-3                   1.8.18-1
ii  libfftw3-single3              3.3.4-2
ii  libgcc1                       1:5.1.1-9
ii  libice6                       2:1.0.9-1+b1
ii  libltdl7                      2.4.2-1.11
ii  liborc-0.4-0                  1:0.4.23-2
ii  libpulse0                     6.0-2
ii  libsm6                        2:1.2.2-1+b1
ii  libsndfile1                   1.0.25-9.1
ii  libspeexdsp1                  1.2~rc1.2-1
ii  libstdc++6                    5.1.1-9
ii  libsystemd0                   220-4
ii  libtdb1                       1.3.5-1
ii  libudev1                      220-4
ii  libwebrtc-audio-processing-0  0.1-3
ii  libx11-6                      2:1.6.3-1
ii  libx11-xcb1                   2:1.6.3-1
ii  libxcb1                       1.10-3+b1
ii  libxtst6                      2:1.2.2-1+b1
ii  lsb-base                      4.1+Debian13+nmu1
ii  pulseaudio-utils              6.0-2
ii  udev                          220-4

Versions of packages pulseaudio recommends:
ii  pulseaudio-module-x11  6.0-2
ii  rtkit                  0.11-2

Versions of packages pulseaudio suggests:
ii  paman        0.9.4-1
ii  paprefs      0.9.10-1
ii  pavucontrol  3.0-3
ii  pavumeter    0.9.3-4

-- no debconf information