[pulseaudio-tickets] [Bug 105907] New: 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

            Bug ID: 105907
           Summary: pulse-cli-syntax man page should describe suspend and
                    kill in more detail
           Product: PulseAudio
           Version: unspecified
          Hardware: x86-64 (AMD64)
                OS: Linux (All)
            Status: NEW
          Severity: minor
          Priority: medium
         Component: core
          Assignee: pulseaudio-bugs at lists.freedesktop.org
          Reporter: frederik-freedesktop at ofb.net
        QA Contact: pulseaudio-bugs at lists.freedesktop.org
                CC: lennart at poettering.net

I've been reading pulse-cli-syntax(5) and I don't understand what is the
difference between 'suspend-sink' and 'kill-sink-input' and how they are used.
Is it true that I use the former when I want to free a hardware device so I can
open it from another sound server, and that I would use the latter command to
stop a client from playing sound without killing its process? Will Pulseaudio
just ignore any further samples that are sent by a client or sink input which
has been "killed", or will the client get an error of some kind?

Is there another manual page or document which describes these in more detail?

What is the meaning of the argument to 'suspend-sink' and 'suspend' which is
boolean?

What is the difference between removing a client or sink, and removing it
"forcibly" (as the manual page says is done by the "kill-" commands)?

I think all of this should be documented in a place which is easy for new users
to locate, such as the pulse-cli-syntax(5) man page or some document which is
referenced by it. As it is, I find a lot of examples on the web invoking things
like 'pacmd suspend true' and each time I read this stuff I go to your man page
and find it frustratingly incomplete.

-- 
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/20180405/770f7833/attachment.html>