docs: align man pages with code + fill documentation gaps (0.16.0 audit)

A full man<->code consistency audit surfaced options, format placeholders
and CSS classes that were implemented but undocumented, documented but not
implemented (some causing fmt crashes when copied from examples), and
defaults that disagreed with the code. This aligns the docs with the code
and fixes a few genuine code gaps.

Docs:
- Add the missing waybar-user(5) man page (and register it in meson.build)
- Document previously-undocumented options/placeholders/CSS across many
  modules (custom image-path/image-name/icon-size, graph_type/width/
  datapoints; battery smooth-power; wireplumber format-source/only-physical;
  mpris {position}/prefer-album-artist; network {signalStrengthApp}/compact
  bandwidth; pulseaudio {source_volume}/{source_desc}; upower {temperature}/
  {model}/{native-path}; wwan {power_state}/{imei}; tray ignore-list; and
  many CSS state classes: .sink-muted, .source-muted, .workspace-hover, etc.)
- Correct documented defaults to match the code (hyprland format {name},
  gamemode {count}, cpu-graph interval 5, cava input_delay 4, niri taskbar
  icon-size 16, disk/gps/wayfire formats, menu-actions object type, ...)
- Remove placeholders/options that do not apply (custom-graph {icon}/format/
  format-icons/rotate) and fix crashing examples (wwan {mode}, gps
  format-no-fix); note cava background/foreground/continuous_rendering are
  cava-config-file options

Code:
- bluetooth: accept the documented `controller` key as a synonym of
  `controller-alias` (the option was silently ignored)
- mango/workspaces: supply the documented `{name}` fmt arg (was missing ->
  fmt::format threw)
- privacy: read `tooltip` as a bool (was guarded on isString(), so the
  documented `tooltip: false` was silently ignored)

All man pages validated with scdoc 1.11.4. Not compiled locally (no gtkmm);
C++ build relies on CI.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

man/waybar-cava.5.scd

@@ -37,7 +37,7 @@ libcava lives in:
 |[ *method* \[output\]
 :[ string
 :[
-:< Manages which frontend Waybar cava module should use. Values: raw, sdl_glsl
+:< Manages which frontend Waybar cava module should use. Values: raw, sdl_glsl. Not a waybar JSON key: it is set through the *method* option in the *\[output\]* section of the cava configuration file (*cava_config*)
 |[ *framerate*
 :[ integer
 :[ 30
@@ -111,12 +111,20 @@ libcava lives in:
 :[ false
 :[ Disables or enables the so-called "Monstercat smoothing" with or without "waves"
 |[ *noise_reduction*
+:[ double
+:[ 0.77
+:[ Fractional value between 0.0 - 1.0. The raw visualization is very noisy, this factor adjusts the integral and gravity filters to keep the signal smooth. Values near 1.0 will be very slow and smooth, near 0.0 will be fast but noisy
+|[ *gravity*
 :[ integer
-:[ 77
-:[ Range between 0 - 100. The raw visualization is very noisy, this factor adjusts the integral and gravity filters to keep the signal smooth. 100 will be very slow and smooth, 0 will be fast but noisy
+:[
+:[ Gravity smoothing filter. Higher values make the bars drop faster. Adjusted by *noise_reduction* when set
+|[ *integral*
+:[ integer
+:[
+:[ Integral smoothing filter. Higher values make the visualization smoother but less precise. Adjusted by *noise_reduction* when set
 |[ *input_delay*
 :[ integer
-:[ 2
+:[ 4
 :[ Sets the delay before fetching audio source thread start working. On author's machine, Waybar starts much faster than pipewire audio server, and without a little delay cava module fails because pipewire is not ready
 |[ *ascii_max_range*
 :[ integer
@@ -124,7 +132,7 @@ libcava lives in:
 :[ It's impossible to set it directly. The value is dictated by the number of icons in the array *format-icons*
 |[ *data_format*
 :[ string
-:[ asci
+:[ ascii
 :[ Raw data format. Can be 'binary' or 'ascii'
 |[ *raw_target*
 :[ string
@@ -157,11 +165,11 @@ libcava lives in:
 |[ *background*
 :[ string
 :[
-:[ GLSL actual. Support hex code colors only. Must be within ''
+:[ GLSL actual. Support hex code colors only. Must be within ''. Not a waybar JSON key: set it as *background* in the *\[color\]* section of the cava configuration file (*cava_config*)
 |[ *foreground*
 :[ string
 :[
-:[ GLSL actual. Support hex code colors only. Must be within ''
+:[ GLSL actual. Support hex code colors only. Must be within ''. Not a waybar JSON key: set it as *foreground* in the *\[color\]* section of the cava configuration file (*cava_config*)
 |[ *gradient*
 :[ integer
 :[ 0
@@ -185,7 +193,7 @@ libcava lives in:
 |[ *continuous_rendering*
 :[ integer
 :[ 0
-:[ GLSL actual. Keep rendering even if no audio. Recommended to set to 1
+:[ GLSL actual. Keep rendering even if no audio. Recommended to set to 1. Not a waybar JSON key: set it as *continuous_rendering* in the *\[output\]* section of the cava configuration file (*cava_config*)
 
 Configuration can be provided as:
 - The only cava configuration file which is provided through *cava_config*. The rest configuration can be skipped
@@ -253,9 +261,12 @@ In case when cava releases new version and you're wanna get it, it should be rai
 ```
 # STYLE
 
-- *#cava*
+- *#cava* Raw frontend widget
 - *#cava.silent* Applied after no sound has been detected for sleep_timer seconds
 - *#cava.updated* Applied when a new frame is shown
+- *#cavaGLSL* GLSL frontend widget (used instead of *#cava* when the cava *method* is *sdl_glsl*)
+- *#cavaGLSL.silent* Applied after no sound has been detected for sleep_timer seconds
+- *#cavaGLSL.updated* Applied when a new frame is shown
 # FRONTENDS
 
 ## RAW