summaryrefslogtreecommitdiff
path: root/audio/pulseaudio/README
diff options
context:
space:
mode:
Diffstat (limited to 'audio/pulseaudio/README')
-rw-r--r--audio/pulseaudio/README26
1 files changed, 21 insertions, 5 deletions
diff --git a/audio/pulseaudio/README b/audio/pulseaudio/README
index 7c0de995fc..0231c2f07b 100644
--- a/audio/pulseaudio/README
+++ b/audio/pulseaudio/README
@@ -2,9 +2,25 @@ pulseaudio is a networked sound server for Unix-like operating systems
and Microsoft Windows. It is intended to be an improved drop-in replacement
for the Enlightened Sound Daemon (ESOUND).
-Pulseaudio will need a pulse group/user to run. You can add one with
- # groupadd -g 216 pulse
- # useradd -u 216 -g pulse -d /var/lib/pulse pulse
-See http://slackbuilds.org/uid_gid.txt for details on the uid/gid assignments.
-
Optional deps: jack-audio-connection-kit, avahi, lirc, libasyncns, orc
+
+USAGE:
+In almost all cases, pulseaudio should be run as a normal user daemon
+i.e. NOT a system wide daemon. It will be usually started by the desktop
+environment (KDE, XFCE, MATE) when the user logs in. In general, there is
+nothing more the user needs to do (configuration for particular devices or
+circumstances notwithstanding).
+
+If necessary, pulseaudio may be started manually with:
+ /usr/bin/start-pulseaudio-x11
+or
+ /usr/bin/start-pulseaudio-kde
+
+In the EXTREMELY RARE case that pulseaudio needs to run as a system wide
+daemon, the /etc/rc.d/rc.pulseaudio script is provided. It is not used at all
+in the usual case, as above, in which pulseaudio runs as a normal user daemon.
+Additionally, in the system wide daemon mode only, pulseaudio will need a
+pulse group/user to run as. This may be done with:
+ groupadd -g 216 pulse
+ useradd -u 216 -g pulse -d /var/run/pulse -m pulse
+See http://slackbuilds.org/uid_gid.txt for details on the uid/gid assignments.