1 files changed, 57 insertions, 0 deletions
diff --git a/docs/qarma-geometry-issue.md b/docs/qarma-geometry-issue.md
new file mode 100644
index 0000000..1abb7ae
--- /dev/null
+++ b/docs/qarma-geometry-issue.md
@@ -0,0 +1,57 @@
+Title: --info dialog ignores all size hints (--width/--height, -geometry, -qwindowgeometry) on Qt6/Wayland
+
+## Summary
+
+A message dialog created with `--info` cannot be sized. None of the four
+documented size mechanisms have any effect on the resulting window: the dialog
+always opens at the size Qt picks from its content, padded out to what looks
+like a minimum width, leaving large empty margins.
+
+I'm only reporting **size** here. I understand a Wayland client cannot set its
+own position (`+X+Y`) — that's a protocol limitation, not a qarma bug — so this
+report is strictly about width/height being ignored.
+
+## Environment
+
+- qarma 1.1.0
+- Qt 6 (libQt6Widgets / libQt6Gui)
+- Session: Wayland (`XDG_SESSION_TYPE=wayland`), Hyprland compositor
+- Slackware Linux
+
+## Steps to reproduce
+
+Each of the following opens an `--info` dialog that is much wider than its
+content and ignores the requested size:
+
+```sh
+# 1. qarma's own size options
+qarma --info --width=400 --height=300 --text="<b>a</b><br>b<br>c"
+
+# 2. Qt geometry (size + position)
+qarma --info -geometry 480x300+100+100 --text="<b>a</b><br>b<br>c"
+qarma -geometry 480x300+100+100 --info --text="<b>a</b><br>b<br>c"
+
+# 3. Qt window geometry, both orderings
+qarma --info -qwindowgeometry 480x300 --text="<b>a</b><br>b<br>c"
+qarma -qwindowgeometry 480x300 --info --text="<b>a</b><br>b<br>c"
+```
+
+Expected: the dialog is approximately 400–480 px wide.
+Actual: the dialog opens far wider (content-driven + an apparent minimum width),
+with the requested width/height having no visible effect.
+
+## Notes
+
+- `qarma --help-all` already documents `--width`/`--height` as "not entirely
+  deterministic for message dialogs", which matches what I see — but here they
+  appear to have no effect at all on the width of an `--info` dialog under
+  Qt6/Wayland.
+- A non-message dialog (e.g. `--list`, `--file-selection`) does take `--width`
+  /`--height`, so the problem appears specific to the message-dialog widgets.
+
+## Question
+
+Is sizing of message dialogs expected to work under Qt6/Wayland, or is this a
+known limitation? If it's fixable, exposing a reliable minimum-width override
+for `--info`/`--warning`/`--error`/`--question` would help — these dialogs
+currently can't be made compact even when their content is small.