audio/pulseaudio: Update script.

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

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.