doc: in user-facing config examples, indicate which file it goes into

Add suggestions for config fragments in config file examples, as
applicable.

src/modules/module-combine-stream.c

@@ -82,6 +82,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-combine-stream-1.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-combine-stream
  *     args = {
@@ -122,6 +124,8 @@
  * from 3 separate stereo sinks.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-combine-stream-2.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-combine-stream
  *     args = {
@@ -170,6 +174,8 @@
  * from 2 separate stereo sources.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-combine-stream-3.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-combine-stream
  *     args = {

src/modules/module-echo-cancel.c

@@ -117,6 +117,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-echo-cancel.conf
+ *
  * context.modules = [
  *  {   name = libpipewire-module-echo-cancel
  *      args = {

src/modules/module-example-filter.c

@@ -65,6 +65,8 @@
  * ## Example configuration of a virtual source
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-example-filter.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-example-filter
  *     args = {

src/modules/module-example-sink.c

@@ -63,6 +63,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-example-sink.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-example-sink
  *     args = {

src/modules/module-example-source.c

@@ -63,6 +63,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-example-source.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-example-source
  *     args = {

src/modules/module-ffado-driver.c

@@ -76,6 +76,8 @@
  * ## Example configuration of a duplex sink/source
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-ffado-driver.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-ffado-driver
  *     args = {

src/modules/module-filter-chain.c

@@ -477,7 +477,12 @@ PW_LOG_TOPIC_STATIC(mod_topic, "mod." NAME);
  * This example uses the rnnoise LADSPA plugin to create a new
  * virtual source.
  *
+ * Run with `pipewire -c filter-chain.conf`. The configuration can also
+ * be put under `pipewire.conf.d/` to run it inside the PipeWire server.
+ *
  *\code{.unparsed}
+ * # ~/.config/pipewire/filter-chain.conf.d/my-filter-chain-1.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-filter-chain
  *     args = {
@@ -515,6 +520,8 @@ PW_LOG_TOPIC_STATIC(mod_topic, "mod." NAME);
  * to a stereo Dolby Surround signal.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/filter-chain.conf.d/my-filter-chain-2.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-filter-chain
  *     args = {

src/modules/module-jack-tunnel.c

@@ -75,6 +75,8 @@
  * ## Example configuration of a duplex sink/source
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-jack-tunnel.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-jack-tunnel
  *     args = {

src/modules/module-jackdbus-detect.c

@@ -42,6 +42,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-jack-dbus-detect.conf
+ *
  * context.modules = [
  *  {   name = libpipewire-module-jackdbus-detect
  *      args {

src/modules/module-loopback.c

@@ -82,6 +82,8 @@
  * This Virtual sink routes stereo input to the rear channels of a 7.1 sink.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-loopback-1.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-loopback
  *     args = {
@@ -111,6 +113,8 @@
  * This is useful for splitting up multi-channel inputs from USB audio interfaces that are not yet fully supported by alsa.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-loopback-2.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-loopback
  *     args = {
@@ -137,6 +141,8 @@
  * using the PSD algorithm on the playback stream.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-loopback-3.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-loopback
  *     args = {
@@ -168,6 +174,8 @@
  * downmixing from the two first AUX channels of a pro-audio device.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-loopback-4.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-loopback
  *     args = {

src/modules/module-netjack2-driver.c

@@ -87,6 +87,8 @@
  * ## Example configuration of a duplex sink/source
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-netjack2-driver.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-netjack2-driver
  *     args = {

src/modules/module-netjack2-manager.c

@@ -92,6 +92,8 @@
  * ## Example configuration of a duplex sink/source
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-netjack2-manager.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-netjack2-manager
  *     args = {

src/modules/module-parametric-equalizer.c

@@ -69,6 +69,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-parametric-equalizer.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-parametric-equalizer
  *     args = {

src/modules/module-pipe-tunnel.c

@@ -93,6 +93,8 @@
  * ## Example configuration of a pipe playback stream
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-pipe-tunnel.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-pipe-tunnel
  *     args = {

src/modules/module-protocol-pulse.c

@@ -48,6 +48,8 @@
  * A config section with server properties can be given.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire-pulse.conf.d/custom.conf
+ *
  * pulse.properties = {
  *     # the addresses this server listens on
  *     server.address = [
@@ -297,6 +299,8 @@
  * section with a `quirks` and an `update-props` action.
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire-pulse.conf.d/custom.conf
+ *
  * pulse.rules = [
  *     {
  *         # skype does not want to use devices that don't have an S16 sample format.
@@ -343,6 +347,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire-pulse.conf.d/custom.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-protocol-pulse
  *     args = { }

src/modules/module-protocol-simple.c

@@ -83,6 +83,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-protocol-simple.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-protocol-simple
  *     args = {

src/modules/module-pulse-tunnel.c

@@ -83,6 +83,8 @@
  * ## Example configuration of a virtual sink
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-pulse-tunnel.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-pulse-tunnel
  *     args = {

src/modules/module-raop-discover.c

@@ -55,6 +55,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-raop-discover.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-raop-discover
  *     args = {

src/modules/module-raop-sink.c

@@ -94,6 +94,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-raop-sink.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-raop-sink
  *     args = {

src/modules/module-roc-sink.c

@@ -56,6 +56,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-roc-sink.conf
+ *
  * context.modules = [
  *  {   name = libpipewire-module-roc-sink
  *      args = {

src/modules/module-roc-source.c

@@ -59,6 +59,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-roc-source.conf
+ *
  * context.modules = [
  *  {   name = libpipewire-module-roc-source
  *      args = {

src/modules/module-rtp-sap.c

@@ -73,6 +73,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-rtp-sap.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-rtp-sap
  *     args = {

src/modules/module-rtp-session.c

@@ -97,6 +97,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-rtp-session.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-rtp-session
  *     args = {

src/modules/module-rtp-sink.c

@@ -87,6 +87,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-rtp-sink.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-rtp-sink
  *     args = {

src/modules/module-rtp-source.c

@@ -81,6 +81,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-rtp-source.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-rtp-source
  *     args = {

src/modules/module-snapcast-discover.c

@@ -88,6 +88,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-snapcast-discover.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-snapcast-discover
  *     args = {

src/modules/module-vban-recv.c

@@ -77,6 +77,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-vban-recv.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-vban-recv
  *     args = {

src/modules/module-vban-send.c

@@ -78,6 +78,8 @@
  *
  * ## Example configuration
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-vban-send.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-vban-send
  *     args = {

src/modules/module-zeroconf-discover.c

@@ -48,6 +48,8 @@
  * ## Example configuration
  *
  *\code{.unparsed}
+ * # ~/.config/pipewire/pipewire.conf.d/my-zeroconf-discover.conf
+ *
  * context.modules = [
  * {   name = libpipewire-module-zeroconf-discover
  *     args = { }