docs(man): backfill man pages with wiki-only info (source-of-truth pass)

Port information that previously lived only in the GitHub wiki into the
authoritative scdoc man pages, so the man pages become the single source
of truth for module documentation.

33 man pages enriched (options, format replacements, actions, style
selectors, troubleshooting and implementation notes). Additions were
verified against the source; stale/incorrect wiki entries were
deliberately not ported. All pages still compile with scdoc.

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

man/waybar-pulseaudio.5.scd

@@ -108,6 +108,10 @@ Additionally, you can control the volume by scrolling *up* or *down* while the c
 	default: true ++
 	Option to disable tooltip on hover.
 
+*tooltip-format*: ++
+	typeof: string ++
+	The format of the tooltip shown on hover. When unset, the tooltip shows the current sink's description.
+
 *max-volume*: ++
 	typeof: integer ++
 	default: 100 ++
@@ -115,7 +119,7 @@ Additionally, you can control the volume by scrolling *up* or *down* while the c
 
 *ignored-sinks*: ++
 	typeof: array ++
-	Sinks in this list will not be shown as active sink by Waybar. Entries should be the sink's description field.
+	Sinks in this list will not be shown as active sink by Waybar. Entries should be the sink's description field. Use *pactl list sinks* to find the correct description.
 
 *sink-mapping*: ++
 	typeof: object ++
@@ -164,6 +168,8 @@ The following strings for *format-icons* are supported.
 
 - the device name
 
+The device name looks something like *alsa\_output.pci-0000\_00\_1f.3.analog-stereo*. You can find it with a PulseAudio frontend such as *pacmd list-sinks* or *pamixer --list-sinks*.
+
 If they are found in the current PulseAudio port name, the corresponding icons will be selected.
 
 - *default* (Shown, when no other port is found)