pulse-cli-syntax man page should describe suspend and kill in more detail
Submitted by Frederick Eaton
Assigned to pul..@..op.org
Link to original bug (#105907)
Description
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.