git: 9f50b81142 - main - [handbook/multimedia] Add pulseaudio settings info

[Fernando Apesteguía]

The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/doc/commit/?id=9f50b81142a006961672f25650dd77b8c020ca7a

commit 9f50b81142a006961672f25650dd77b8c020ca7a
Author:     Fernando Apesteguía <fernape at FreeBSD.org>
AuthorDate: 2021-06-24 17:56:27 +0000
Commit:     Fernando Apesteguía <fernape at FreeBSD.org>
CommitDate: 2021-06-25 07:30:35 +0000

    [handbook/multimedia] Add pulseaudio settings info
    
    Document that for applications using audio/pulseaudio, changing
    hw.snd.default_unit might require to restart the pulseaudio daemon.
    
    Document the use of pacmd(1) to change the default sink on the fly as an
    alternative.
---
 .../en/books/handbook/multimedia/_index.adoc       | 28 ++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc
index dcd56eda90..cafcdb6f41 100644
--- a/documentation/content/en/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/en/books/handbook/multimedia/_index.adoc
@@ -340,6 +340,34 @@ Make this change permanent by adding the following line to [.filename]#/etc/sysc
 hw.snd.default_unit=4
 ....
 
+Programs using package:audio/pulseaudio[] might need to restart the
+package:audio/pulseaudio[] daemon for the changes in `hw.snd.default_unit`  to
+take effect.
+Alternatively, package:audio/pulseaudio[] settings can be changed on the fly.
+man:pacmd[1] opens a command line connection to the package:audio/pulseaudio[]
+daemon:
+
+[source,shell]
+....
+>>> # pacmd
+Welcome to PulseAudio 14.2! Use "help" for usage information.
+>>>
+....
+
+The following command changes the default sink to card number 4 as in
+the previous example:
+
+[.programlisting]
+....
+set-default-sink 4
+....
+
+[WARNING]
+====
+Do not use the `exit` command to exit the command line interface. That will kill
+the package:audio/pulseaudio[] daemon. Use kbd:[Ctrl+D] instead.
+====
+
 [[sound-multiple-sources]]
 === Utilizing Multiple Sound Sources