From 9549395257a22d4f03f5175602adf9980802a6cd Mon Sep 17 00:00:00 2001
From: Andreas Grois <andi@grois.info>
Date: Mon, 29 Nov 2021 00:18:44 +0100
Subject: Update pulse help string and add a few serde renames.

---
 pulse/src/lib.rs | 38 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)

(limited to 'pulse/src/lib.rs')

diff --git a/pulse/src/lib.rs b/pulse/src/lib.rs
index cfecfd4..a77acba 100644
--- a/pulse/src/lib.rs
+++ b/pulse/src/lib.rs
@@ -20,11 +20,45 @@ impl SwayStatusModule for PulseVolumePlugin {
         Box::new(config)
     }
     fn print_help(&self) {
-        //TODO!
         println!(
 r#"Swaystatus Pulseaudio Volume plugin.
 
-Sorry, this help has not been finalized. If this ever gets public, slap Andi."#);
+This is a volume display for pulseaudio (or compatibles). It can either monitor the default sink and switch whenever the default changes, or it can monitor a specific sink given by a configured name. The volume information can either be printed numerically or as a symbol that can be set based on a percentage range. In addition, the mute, volume and balance display can be arranged in any way wanted.
+
+The configuration for this plugin looks like this:
+[Element.Config]
+Sorting = ["MuteVolumeBalance", "MuteBalanceVolume", "VolumeMuteBalance", "VolumeBalanceMute", "BalanceMuteVolume", "BalanceVolumeMute"]
+
+[Element.Config.Sink]
+Sink = ["Default", "Specific"]
+SinkName = <if Sink = "Specific": Sink name to observe. Omit if Sink = "Default".>
+
+[Element.Config.Volume]
+Format = ["Off", "Numeric", "Binned"]
+Label = <if Format != "Off" string to print in front of actual value. Omit if Format = "Off">
+DecimalDigits = <if Format = "Numeric" the number of digits after the comma. Omit otherwise.>
+
+[Element.Config.Volume.PercentToSymbolMap]
+<if Format = "Binned" this map has to be filled in. It's a set of key-value-pairs where the key denotes the lower limit of a range. For instance writing 20 = "AAA" makes volumes above 20% print AAA. See sample config -s for an example.>
+
+[Element.Config.Balance]
+Format = ["Off", "Numeric", "Binned"]
+Label = <if Format != "Off" string to print in front of actual value. Omit if Format = "Off">
+DecimalDigits = <if Format = "Numeric" the number of digits after the comma. Omit otherwise.>
+
+[Element.Config.Balance.PercentToSymbolMap]
+<see Element.Config.Volume.PercentToSymbolMap for details. It's the same thing, just allows negative values>
+
+[Element.Config.Mute]
+Format = ["Off", "Symbol"]
+Label = <if Format = "Symbol" string to print in front of symbol. Omit if Format = "Off">
+MuteSymbol = <if Format = "Symbol" the string to display if muted. Omit if Format = "Off">
+UnmuteSymbol = <if Format = "Symbol" the string to display if unmuted. Omit if Format = "Off">
+
+Sorry if this is overly complicated. Using the -s command line switch to get a sample configuration should clarify things.
+
+
+Thanks to Jason White, whose gist https://gist.github.com/jasonwhite/1df6ee4b5039358701d2 was immensely helpful when it comes to interaction with the pulseaudio daemon."#);
     }
 }
 
-- 
cgit v1.2.3