[pulseaudio-tickets] [Bug 105907] pulse-cli-syntax man page should describe suspend and kill in more detail

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=105907

--- Comment #3 from Tanu Kaskinen <tanuk at iki.fi> ---
(In reply to Frederick Eaton from comment #2)
> Thank you Tanu, that looks good. I wasn't aware that there are separate
> 'pacmd' and 'pactl' man pages.
> 
> I'm not sure what the difference is, it is not quite clear from the manual
> pages, the 'pactl' man page says "pactl only exposes a subset of the
> available operations. For the full set use the pacmd". But 'pactl' has some
> commands which are not in 'pulse-cli-syntax', like 'subscribe'. Also it is
> much more convenient to refer to 'pactl' than 'pacmd' because all the
> 'pacmd' arguments are documented in a separate man page ... anyway these are
> just some more observations. I'm sure there are lots of things to work on
> documentation-wise, thanks for taking the time to address my bug.

I didn't realize that the pactl man page recommends pacmd, that should be
fixed... It should be the other way around, the pacmd man page should recommend
people to use pactl instead, unless they really need the few commands and other
things that are not currently provided by pactl. The reason why pactl is
preferable (in addition to the reasons you listed) is that it behaves like any
other pulseaudio client, while pacmd uses a different way to talk to the
server, which breaks down on many less common setups.

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
You are the assignee for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.freedesktop.org/archives/pulseaudio-bugs/attachments/20180418/ed1b283e/attachment.html>