improve some docs about options

See #387

src/daemon/pipewire-pulse.c

@@ -45,7 +45,9 @@ static void show_help(const char *name)
 		"Start a pulseaudio compatible daemon.\n\n"
 		"  -h, --help                            Show this help\n"
 		"      --version                         Show version\n"
-		"  -a  --address                         comma separated list of addresses (Default %s)\n",
+		"  -a  --address                         comma separated list of addresses (Default %s)\n"
+		"                                           unix:<socket-name>\n",
+		"                                           tcp:[<ip>][:<port>]\n",
 		name,
 		address);
 }

src/daemon/pipewire.conf.in

@@ -71,8 +71,20 @@ create-object spa-node-factory factory.name=support.node.driver node.name=Dummy
 
 ## exec <program-name>
 #
-# Execute the given program. This is usually used to start the
+# Execute the given program.
-# session manager. run the session manager with -h for options
+#
+# Start the session manager. Run the session manager with -h for
+# options.
+#
+# The bluetooth module is disabled by default because it causes
+# conflicts with PulseAudio. If you disable PulseAudio or don't
+# load its bluetooth module, you can enable it here with -e bluez5
+#
+exec @media_session_path@
+#
+# You can optionally start the pulseaudio-server here as well
+# but it better to start it as a systemd service.
+# It can be interesting to start another daemon here that listens
+# on another address with the -a option (eg. -a tcp:4713)
 #
-exec @media_session_path@ # -d alsa-seq,alsa-pcm,bluez5,metadata
 #exec @pipewire_pulse_path@

src/examples/media-session/media-session.c

@@ -2133,8 +2133,8 @@ static void show_help(const char *name, const char *enabled, const char *disable
         fprintf(stdout, "%s [options]\n"
              "  -h, --help                            Show this help\n"
              "      --version                         Show version\n"
-             "  -e, --enabled                         Extra enabled options ('%s')\n"
+             "  -e, --enabled                         Extra comma separated enabled options ('%s')\n"
-             "  -d, --disabled                        Extra disabled options ('%s')\n"
+             "  -d, --disabled                        Extra comma separated disabled options ('%s')\n"
              "  -p, --properties                      Extra properties as 'key=value { key=value }'\n",
 	     name, enabled, disabled);