docs: note qarma --info whitespace-collapse gotcha in CLAUDE.md

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

1 files changed, 7 insertions, 0 deletions

diff --git a/CLAUDE.md b/CLAUDE.md
index 2aa4393..3387dee 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -59,6 +59,13 @@ Syntax check: `bash -n wallp`.
 - **qarma `--list` needs `--radiolist --print-column=2`.** A plain `--list`
   prints nothing on selection (bug that shipped once). `qarma_select` depends on
   these flags; a regression test guards it.
+- **qarma `--info` collapses whitespace.** Newlines and runs of spaces are eaten
+  by the GTK label. `show_help`'s markup uses `<br>` for line breaks and `&#160;`
+  (non-breaking space) for column padding — NOT `\n` or literal spaces. Pango has
+  no `<br>`, but qarma preprocesses it into a newline. `--width=600` stops the
+  description column from wrapping (GTK still enforces a min dialog width, so the
+  window looks wide). The stdout branch keeps plain text; a test asserts no
+  markup tags leak there.
 - **Selective kill.** `apply_output` kills only the changed output's swaybg PID
   (tracked in `~/.cache/wallp/{H,V}.pid`). Updating one screen must never blank
   the other — there's a test for this; keep it green.