From 35680b1373c8129b1f19dc0074c3da72e4704295 Mon Sep 17 00:00:00 2001
From: aclist <92275929+aclist@users.noreply.github.com>
Date: Sat, 11 Jul 2026 17:51:32 +0900
Subject: [PATCH] chore: clarify dialog strings

---
 dzgui/strings/wizard.py       | 18 +++++++++++++++---
 dzgui/views/dialogs/wizard.py | 15 +++++++++++----
 2 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/dzgui/strings/wizard.py b/dzgui/strings/wizard.py
index 96310af..dd7207c 100644
--- a/dzgui/strings/wizard.py
+++ b/dzgui/strings/wizard.py
@@ -66,10 +66,22 @@ label_client = "Steam client"
 
 ### Shortcuts page
 heading_shortcuts = "Create shortcuts"
-blurb_shortcuts = "You can optionally create shortcuts to facilitate launching DZGUI faster. Note that if you create a Steam shortcut, you <b>must restart Steam</b> for these changes to take effect."
+blurb_shortcuts = (
+    "You can optionally create shortcuts to facilitate launching DZGUI faster."
+)
 button_shortcuts = "Create shortcuts"
-checkbox_steam_shortcut = ("Add a shortcut to Steam", "This will not replace or update existing shortcuts.")
-checkbox_start_menu = ("Add a start menu shortcut", "Depends on local window manager settings. Will work on Steam Deck.")
+checkbox_steam_shortcut = (
+    "Add DZGUI to Steam library",
+    (
+        "This creates a standalone copy of DZGUI and adds it to Steam. "
+        "You <b>must restart Steam</b> for the shortcut to appear. This will not replace or update existing shortcuts. "
+        "If you update DZGUI when it is launched via Steam, updates will be applied to the Steam version."
+    ),
+)
+checkbox_start_menu = (
+    "Add a start menu shortcut",
+    "Depends on local window manager settings. Will work on Steam Deck.",
+)
 checkbox_desktop_shortcut = ("Add a desktop shortcut", "Depends on the option above.")
 
 ### Completion page
diff --git a/dzgui/views/dialogs/wizard.py b/dzgui/views/dialogs/wizard.py
index 1bfaf47..4261cf8 100644
--- a/dzgui/views/dialogs/wizard.py
+++ b/dzgui/views/dialogs/wizard.py
@@ -67,7 +67,7 @@ class Progress(Gtk.ProgressBar):
 
 class ScrolledWizardPage(Gtk.ScrolledWindow):
     def __init__(self, enum: PageNum, heading: str, description: str):
-        super().__init__()
+        super().__init__(overlay_scrolling=False)
 
         self.enum = enum
         self.page_type: Gtk.AssistantPageType
@@ -584,9 +584,11 @@ class CheckboxWithLabel(Gtk.Box):
 
         self.button = Gtk.CheckButton(label=text)
         self.button.set_active(True)
-        blurb = Gtk.Label(label=f"- {blurb_text}", halign=Gtk.Align.START, margin_start=20)
+        label = Gtk.Label(label="", halign=Gtk.Align.START, margin_start=20)
+        wrapped = textwrap.fill(blurb_text, width=100)
+        label.set_markup(f"- {wrapped}")
 
-        for el in self.button, blurb:
+        for el in self.button, label:
             self.add(el)
 
     def get_checkbox(self) -> Gtk.CheckButton:
@@ -598,6 +600,7 @@ class CheckboxWithLabel(Gtk.Box):
     def set_active(self, state: bool) -> None:
         self.button.set_active(state)
 
+
 class ShortcutCreationPage(ScrolledWizardPage):
     def __init__(self, shortcut: Path) -> None:
         super().__init__(
@@ -624,7 +627,11 @@ class ShortcutCreationPage(ScrolledWizardPage):
         label, blurb = wizard.checkbox_desktop_shortcut
         self.desktop_checkbox = CheckboxWithLabel(label, blurb)
 
-        for el in (self.steam_checkbox, self.start_menu_checkbox, self.desktop_checkbox):
+        for el in (
+            self.steam_checkbox,
+            self.start_menu_checkbox,
+            self.desktop_checkbox,
+        ):
             self.checks_area.add(el)
 
         self.add_start(self.checks_area)